About Hive Vault
Hive Vault is an MCP server in the Security category: a2A ZK wallet recovery — guardian swarm, no seed phrase, HiveLaw enforcement.
Install
uvx hive-vaultpip install hive-vaultThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (11)
capture_lessonCapture lessons inline / batch-extract from text / look up existing lessons by keyword (`find=`)
Parameters not published.
delegate_taskRoute tasks to cheaper models or summarize vault files
Parameters not published.
session_briefingTasks + lessons + git log + health in one call
Parameters not published.
vault_commitFlush pending `commit=False` writes into one git commit
Parameters not published.
vault_healthServer identity (version, vault path, backends), health metrics, drift detection, usage stats, opt-in runtime block
Parameters not published.
vault_listBrowse projects and files with glob filtering
Parameters not published.
vault_patchSurgical find-and-replace. `commit=False` defers the git commit for batching
Parameters not published.
vault_queryLoad project context, tasks, roadmap, lessons — or any file by path
Parameters not published.
vault_searchFull-text search with metadata filters, regex, ranked results, recent changes, lesson-usage ranking (`rank_by`)
Parameters not published.
vault_writeCreate, append, or replace vault files. `commit=False` defers the git commit for batching
Parameters not published.
worker_statusBudget, connectivity, available models
Parameters not published.
Ask AI
Ask AI about Hive Vault
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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 -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-vault
Set
VAULT_PATHto your Obsidian vault directory. Default:~/Projects/knowledge.
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)
License
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.