Skip to content
mcp/harbor
Claude Desktop

Obsidian Brain for Claude Desktop

io.github.sweir1/obsidian-brain

Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.

client:Claude Desktop transport:stdio runtime:npm

Install Obsidian Brain in Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json · windows: %APPDATA%\Claude\claude_desktop_config.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-brain"
      ],
      "env": {
        "VAULT_PATH": "<VAULT_PATH>",
        "DATA_DIR": "<DATA_DIR>",
        "EMBEDDING_PRESET": "<EMBEDDING_PRESET>",
        "EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
        "EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
        "OLLAMA_BASE_URL": "<OLLAMA_BASE_URL>",
        "OLLAMA_EMBEDDING_DIM": "<OLLAMA_EMBEDDING_DIM>",
        "OLLAMA_NUM_CTX": "<OLLAMA_NUM_CTX>",
        "OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL": "<OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL>",
        "OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL": "<OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL>",
        "OBSIDIAN_BRAIN_NO_WATCH": "<OBSIDIAN_BRAIN_NO_WATCH>",
        "OBSIDIAN_BRAIN_NO_CATCHUP": "<OBSIDIAN_BRAIN_NO_CATCHUP>",
        "OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
        "OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
        "OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>",
        "OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS": "<OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS>",
        "OBSIDIAN_BRAIN_CONFIG_DIR": "<OBSIDIAN_BRAIN_CONFIG_DIR>",
        "OBSIDIAN_BRAIN_DEBUG": "<OBSIDIAN_BRAIN_DEBUG>",
        "OBSIDIAN_BRAIN_LOG_FORMAT": "<OBSIDIAN_BRAIN_LOG_FORMAT>"
      }
    }
  }
}

Settings → Developer → Edit Config opens this file. Restart the app after saving. Claude Desktop docs

Obsidian Brain in other clients

Obsidian Brain MCP server