Hive Vault MCP server
On-demand Obsidian vault access for AI coding assistants — 17 tools, 5 resources, 4 prompts.
10 stars506 downloads/wk
Reviews
Write oneNobody has reviewed Hive Vault yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Hive Vault tools (10, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
capture_lessonCapture lessons: inline (structured fields) or batch (raw text via worker).
delegate_taskOffload work to a cheaper model or summarize vault files.
session_briefingCall at the start of every new session to load project context.
vault_healthReturn vault health metrics, validation, and optional usage analytics.
vault_listList vault projects, or files within a project.
vault_patchwrite actionSurgical find-and-replace in a vault file with auto git commit.
vault_queryRead content from a vault project — use instead of direct filesystem access.
vault_searchSearch the vault: full-text, ranked, or recent changes.
vault_writewrite actionWrite to the vault: append, replace a section, or create a new file.
worker_statusShow worker health: budget, connectivity, available models, and usage stats.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan27 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install Hive Vault in Claude Code, Cursor or VS Code
claude mcp add hive-vault -- uvx hive-vault
What the publisher says
From the Hive Vault repository's README, as published. We do not edit it. Read it on GitHub
hive-vault
<!-- mcp-name: io.github.mlorentedev/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.
Measured on a real vault with 19 projects, 200+ files. See benchmarks.
Quick Start
Hive runs without a vault — vault tools return a friendly error until VAULT_PATH is set, so you can install first and configure later.
# Minimal — uses default vault path ~/Projects/knowledge
claude mcp add -s user hive -- uvx --upgrade hive-vault
# With a custom vault path
claude mcp add -s user hive -e VAULT_PATH=$HOME/path/to/vault -- uvx --upgrade hive-vault
# Gemini CLI
gemini mcp add -s user -e VAULT_PATH=$HOME/path/to/vault hive-vault uvx -- --upgrade hive-vaultDefault vault path: ~/Projects/knowledge. Override with VAULTPATH (or HIVEVAULT_PATH) as shown above.
For Codex CLI, GitHub Copilot, Cursor, Windsurf, and other clients, see Getting Started.
Then ask your assistant: "Use vaultlist to see my vault"*
Requirements
Hive degrades gracefully — every recommended or optional dependency reveals more capability without breaking the baseline.
- Required
- Python 3.12+ (works on 3.13).
- A directory of markdown files. The vault structure used by 00meta / 10projects / 50work / 80agents is optional — without it, vault tools still operate but the scope routing is flat.
- Recommended
- git initialised inside the vault. Without it, vaultwrite / vaultpatch still write to disk; they just skip the per-write commit (and vault_commit reports the working tree as untracked).
- The Obsidian desktop app to author the vault by hand.
- The obsidian-git plugin with auto-commit set to 5–10 minutes. Pair it with vaultwrite(commit=False) / vaultpatch(commit=False) to push the git workload off the synchronous tool path; see Recommended configuration below.
- Optional
- Ollama running qwen2.5-coder:7b (or compatible) for local, free delegatetask / capturelesson worker calls.
- An OpenRouter API key (OPENROUTERAPIKEY) as a free-tier and paid fallback worker.
- A backup git remote (e.g. private GitHub repo) so vault history survives a disk loss.
Recommended configuration
Per ADR-006 (commit policy), the recommended pairing for write-heavy flows is:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Hive Vault: common questions
- Is Hive Vault MCP server safe?
- Mostly: it is graded B (83/100). Read the Hive Vault safety report
- How do I install Hive Vault?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Hive Vault need an API key?
- Yes. The registry entry asks for
OPENROUTER_API_KEY. - Is Hive Vault maintained?
- The last commit was 2 days ago (2026-09-26). The latest release is v1.12.2.
- What can I use instead of Hive Vault?
- Servers from other publishers that do the same job: Obsidian Hybrid Search MCP server, Seekstone MCP server and Obsidian Vault MCP server. Compare all Hive Vault alternatives.
Alternatives to Hive Vault
Same job from other publishers: the closest match first, then the best rated.
- Obsidian Hybrid SearchSearch Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.not reviewedEstablishedB
- SeekstoneFilesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.not reviewedGrowingA
- Obsidian Vault MCPLocal Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.not reviewedGrowingA
- Obsidian TurbochargedGoverned Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.not reviewedGrowingB
- EnquireLong-term memory for AI agents — your Obsidian vault as searchable persistent memory.not reviewedGrowingA