mlorentedev avatar

Hive Vault

mlorentedev/hive

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 tools

Public 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_PATH

Absolute path to your Obsidian vault (or any Markdown directory)

HIVE_OLLAMA_ENDPOINT

Ollama API endpoint for local worker delegation

OPENROUTER_API_KEYsecret

OpenRouter API key for cloud worker delegation

HIVE_VAULT_SCOPES

JSON mapping of scope names to vault subdirectories

Readme

hive-vault

CI codecov PyPI Python 3.12+ Docs License: MIT

badge

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.


View the full README on GitHub

Details

Repository
github.com/mlorentedev/hive
Category
Documents & Knowledge
Package
hive-vault
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from mlorentedev

Related Documents & Knowledge MCP servers

View all
1psychquant avatarChe Word Mcppsychquant/che-word-mcpSwift-native MCP server for Word (.docx) manipulation with 148 tools5stars
2adelelo13 avatarNeuromcpadelelo13/neuromcpSemantic memory for AI agents with hybrid search, knowledge graph, and consolidation4stars
3getalai avatarPresentationsgetalai/alai-mcp-serverGenerate, edit, and export AI presentations to PDF, PPTX, or a shareable link.4stars
4indhar01 avatarMemographindhar01/memographGraph-based memory system for LLMs with knowledge graphs and semantic search.4stars
5entire-vc avatarEvc Team Relay Mcpentire-vc/evc-team-relay-mcpMCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.3stars
6lukisch avatarBACH FileCommanderlukisch/bach-filecommander-mcp43 tools for filesystem, process management, sessions, search, OCR, ZIP, and PDF export.3stars