What is the Hive Vault MCP server?
On-demand Obsidian vault access for AI coding assistants — 17 tools, 5 resources, 4 prompts.
How to install Hive Vault
Copy-paste configuration for popular MCP clients.
transport: stdio
Config generated by PluginBench — verify against the source before use.Environment / auth
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
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"hive-vault": {
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<YOUR_VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<YOUR_HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<YOUR_HIVE_VAULT_SCOPES>"
}
}
}
}Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hive-vault": {
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<YOUR_VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<YOUR_HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<YOUR_HIVE_VAULT_SCOPES>"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hive-vault": {
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<YOUR_VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<YOUR_HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<YOUR_HIVE_VAULT_SCOPES>"
}
}
}
}VS Code
.vscode/mcp.json
{
"servers": {
"hive-vault": {
"type": "stdio",
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<YOUR_VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<YOUR_HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<YOUR_HIVE_VAULT_SCOPES>"
}
}
}
}Claude Code
claude mcp add hive-vault --env VAULT_PATH=<YOUR_VAULT_PATH> --env HIVE_OLLAMA_ENDPOINT=<YOUR_HIVE_OLLAMA_ENDPOINT> --env OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY> --env HIVE_VAULT_SCOPES=<YOUR_HIVE_VAULT_SCOPES> -- uvx hive-vaultRelated MCP servers
Modify PDF text, replace with regex, and analyze layout while preserving fonts.
View repository →