Which integrations are available for this server?

Automatically performs Git commits when creating, appending, replacing, or patching files within the vault. Manages vault content stored in Markdown, allowing tools to browse, read, and update files while preserving project documentation structure. Connects an AI assistant to an Obsidian vault to enable on-demand querying, full-text searching, and management of project context, tasks, roadmaps, and lessons. Integrates with Ollama as a worker to delegate tasks or summarize vault files using local AI models. Utilizes YAML frontmatter within vault files for metadata filtering, structured data retrieval, and health metrics.

hive-vault

PyPI Python 3.12+ Docs License: MIT

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)