Obsidian Brain MCP Server

Standalone Node MCP server: semantic search + knowledge graph + vault editing for Obsidian, no plugin required.

Remote serverstreamable-httpGo

What is the Obsidian Brain MCP Server?

Standalone Node MCP server: semantic search + knowledge graph + vault editing for Obsidian, no plugin required.

The short version

A standalone Node MCP server that gives Claude (and any other MCP client) semantic search + knowledge graph + vault editing over an Obsidian vault. Runs as one local stdio process — no plugin, no HTTP bridge, no API key, nothing hosted. Your vault content never leaves your machine.

  • Works without Obsidian running — — unlike Local REST API-based servers, obsidian-brain reads .md files directly from disk. Obsidian can be closed; your vault is just a folder
  • No Local REST API plugin required — — nothing to install inside Obsidian for the core experience
  • Chunk-level semantic search with RRF hybrid retrieval — — embeddings at markdown-heading granularity, fused with FTS5 BM25 via Reciprocal Rank Fusion. Finds the exact chunk, ranks on meaning
  • The only Obsidian MCP server with PageRank + Louvain + graph analytics — — ask for your vault's most influential notes, bridging notes, theme clusters. Nobody else ships this
  • Ollama provider for high-quality local embeddings — — switch to qwen3-embedding:0.6b, nomic-embed-text, bge-m3, etc. with one env var
  • All in one npx install — — no clone, no build, no API key, no hosted endpoint. Vault content never leaves your machine

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Obsidian Brain MCP Server

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "npx",
      "args": ["-y", "cache."],
      "env": {
        "VAULT_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
VAULT_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Obsidian Brain to Chunk.”
  • “Use Obsidian Brain to Write.”
  • “Use Obsidian Brain to Maintenance.”

Frequently asked questions

Standalone Node MCP server: semantic search + knowledge graph + vault editing for Obsidian, no plugin required. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.