
Hive Vault
Connects Claude or other MCP clients to an Obsidian vault without loading everything into context. Query files on demand with vault_query, search with BM25 ranking, write and patch files with optional deferred git commits, and capture lessons that get reinforced with usage over time. The delegate_task tool routes work to cheaper models via Ollama or OpenRouter. Designed for developers who keep project context in markdown and want their AI assistant to remember things between sessions without burning tokens. Ships with a lesson reinforcement system that tracks which knowledge gets reused and surfaces it in future searches. Works standalone or pairs with the obsidian-git plugin for async commits.
- GitHub stars
- 5
- tools
- 13
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- May 16, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
vault_queryLoad project context, tasks, roadmap, lessons — or any file by path
Load project context, tasks, roadmap, lessons — or any file by path
No parameter schema in public metadata yet.
vault_searchFull-text search with metadata filters, regex, ranked results, recent changes, lesson-usage ranking (`rank_by`)
Full-text search with metadata filters, regex, ranked results, recent changes, lesson-usage ranking (`rank_by`)
No parameter schema in public metadata yet.
vault_listBrowse projects and files with glob filtering
Browse projects and files with glob filtering
No parameter schema in public metadata yet.
vault_askOptional semantic Q&A with source citations; disabled until an embeddings backend is configured (`[semantic]` extra)
Optional semantic Q&A with source citations; disabled until an embeddings backend is configured (`[semantic]` extra)
No parameter schema in public metadata yet.
vault_healthServer identity (version, vault path, backends), health metrics, drift detection, usage stats, opt-in runtime block
Server identity (version, vault path, backends), health metrics, drift detection, usage stats, opt-in runtime block
No parameter schema in public metadata yet.
vault_writeCreate, append, or replace vault files. `commit=False` defers the git commit for batching
Create, append, or replace vault files. `commit=False` defers the git commit for batching
No parameter schema in public metadata yet.
vault_patchSurgical find-and-replace. `commit=False` defers the git commit for batching
Surgical find-and-replace. `commit=False` defers the git commit for batching
No parameter schema in public metadata yet.
vault_commitFlush pending `commit=False` writes into one git commit
Flush pending `commit=False` writes into one git commit
No parameter schema in public metadata yet.
vault_deleteDelete one file, committed synchronously so it stays recoverable from git history
Delete one file, committed synchronously so it stays recoverable from git history
No parameter schema in public metadata yet.
capture_lessonCapture lessons inline / batch-extract from text / look up existing lessons by keyword (`find=`)
Capture lessons inline / batch-extract from text / look up existing lessons by keyword (`find=`)
No parameter schema in public metadata yet.
session_briefingTasks + lessons + git log + health in one call
Tasks + lessons + git log + health in one call
No parameter schema in public metadata yet.
delegate_taskRoute tasks to cheaper models or summarize vault files
Route tasks to cheaper models or summarize vault files
No parameter schema in public metadata yet.
worker_statusWhether the worker is configured and reachable, its model, and usage
Whether the worker is configured and reachable, its model, and usage
No parameter schema in public metadata yet.
Sponsors
Configuration
VAULT_PATHAbsolute path to your Obsidian vault (or any Markdown directory)
HIVE_OLLAMA_ENDPOINTOllama API endpoint for local worker delegation
OPENROUTER_API_KEYsecretOpenRouter API key for cloud worker delegation
HIVE_VAULT_SCOPESJSON mapping of scope names to vault subdirectories
Readme
Details
- Repository
- github.com/mlorentedev/hive
- Category
- Documents & Knowledge
- Package
hive-vault- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active