Hive Vault MCP Server

by mlorentedevio.github.mlorentedev/hive-vaultv1.12.2

On-demand Obsidian vault access: adaptive context loading, full-text and ranked search, health checks, auto git commits and delegation to cheaper models.

11Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Hive Vault MCP server

claude mcp add hive-vault -e OPENROUTER_API_KEY='<openrouter-api-key>' -- uvx hive-vault

{
  "mcpServers": {
    "hive-vault": {
      "command": "uvx",
      "args": [
        "hive-vault"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "hive-vault": {
      "command": "uvx",
      "args": [
        "hive-vault"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "hive-vault": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hive-vault"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "hive-vault": {
      "command": "uvx",
      "args": [
        "hive-vault"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VAULT_PATH	—	—	Absolute path to your Obsidian vault (or any Markdown directory)
HIVE_OLLAMA_ENDPOINT	—	—	Ollama API endpoint for local worker delegation
OPENROUTER_API_KEY	—	yes	OpenRouter API key for cloud worker delegation
HIVE_VAULT_SCOPES	—	—	JSON mapping of scope names to vault subdirectories

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-10-07 · 3d ago · GitHub · v4.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-05-16 · 5mo ago · official registry · v1.12.2

FAQ

›How do I install the Hive Vault MCP server in Claude Code?

Run: claude mcp add hive-vault -e OPENROUTER_API_KEY='<openrouter-api-key>' -- uvx hive-vault. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Hive Vault require an API key?

Yes. It expects OPENROUTER_API_KEY, of which 1 is a secret.

›Can I use Hive Vault as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Hive Vault in the official MCP registry?

Yes, as io.github.mlorentedev/hive-vault.