Hive Vault
On-demand Obsidian vault access for AI coding assistants β 17 tools, 5 resources, 4 prompts.
Ask AI about Hive Vault
Powered by Claude Β· Grounded in docs
I know everything about Hive Vault. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
hive-vault
Your AI coding assistant forgets everything between sessions. Hive fixes that.
Hive is an MCP server that connects your AI assistant to an Obsidian vault. Instead of loading everything upfront, it queries only what's needed β on demand.
| Metric | Without Hive | With Hive |
|---|---|---|
| Context loaded per session | ~800 lines (static) | ~50 lines (on demand) |
| Token cost for context | 100% every session | 6% average per query |
| Knowledge retained between sessions | 0% | 100% (in vault) |
Measured on a real vault with 19 projects, 200+ files. See benchmarks.
Quick Start
# Claude Code
claude mcp add -s user hive -- uvx --upgrade hive-vault
# Gemini CLI
gemini mcp add -s user hive-vault uvx -- --upgrade hive-vault
For Codex CLI, GitHub Copilot, Cursor, Windsurf, and other clients, see Getting Started.
Then ask your assistant: "Use vault_list to see my vault"
Tools
| Tool | What it does |
|---|---|
vault_query | Load project context, tasks, roadmap, lessons β or any file by path |
vault_search | Full-text search with metadata filters, regex, ranked results, recent changes |
vault_list | Browse projects and files with glob filtering |
vault_health | Health metrics, drift detection, usage stats |
vault_write | Create, append, or replace vault files with auto git commit |
vault_patch | Surgical find-and-replace with auto git commit |
capture_lesson | Capture lessons inline or batch-extract from text via worker |
session_briefing | Tasks + lessons + git log + health in one call |
delegate_task | Route tasks to cheaper models or summarize vault files |
worker_status | Budget, connectivity, available models |
Plus 5 resources and 4 prompts for guided workflows.
Architecture
MCP Host (Claude Code, Gemini CLI, Codex CLI, Cursor, ...)
βββ hive-vault (MCP server, stdio)
βββ Vault Tools (7) ββ Obsidian vault (Markdown + YAML frontmatter)
βββ Session Tools (1) ββ Adaptive context assembly
βββ Worker Tools (2) ββ Ollama (free) β OpenRouter free β paid ($1/mo cap) β reject
Documentation
Full documentation at mlorentedev.github.io/hive:
- Getting Started β install for all MCP clients
- Configuration β all 16 environment variables
- Vault Structure β how to organize your vault
- Use Cases β real-world workflows
- Architecture β module map and design decisions
- Troubleshooting β common issues and fixes
Contributing
See CONTRIBUTING.md for setup and PR workflow.
git clone https://github.com/mlorentedev/hive.git && cd hive
make install # create venv + install deps
make check # lint + typecheck + test (337 tests, 92% coverage)
