Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.
npx -y obsidian-brain{
"VAULT_PATH": "YOUR_VALUE_HERE",
"DATA_DIR": "YOUR_VALUE_HERE",
"EMBEDDING_PRESET": "english",
"EMBEDDING_MODEL": "YOUR_VALUE_HERE",
"EMBEDDING_PROVIDER": "transformers",
"OLLAMA_BASE_URL": "http://localhost:11434",
"OLLAMA_EMBEDDING_DIM": "YOUR_VALUE_HERE",
"OLLAMA_NUM_CTX": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_NO_WATCH": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_NO_CATCHUP": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "3000",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "60000",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "30000",
"OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_CONFIG_DIR": "YOUR_VALUE_HERE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-sweir1-obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain"
],
"env": {
"VAULT_PATH": "YOUR_VALUE_HERE",
"DATA_DIR": "YOUR_VALUE_HERE",
"EMBEDDING_PRESET": "english",
"EMBEDDING_MODEL": "YOUR_VALUE_HERE",
"EMBEDDING_PROVIDER": "transformers",
"OLLAMA_BASE_URL": "http://localhost:11434",
"OLLAMA_EMBEDDING_DIM": "YOUR_VALUE_HERE",
"OLLAMA_NUM_CTX": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_NO_WATCH": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_NO_CATCHUP": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "3000",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "60000",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "30000",
"OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS": "YOUR_VALUE_HERE",
"OBSIDIAN_BRAIN_CONFIG_DIR": "YOUR_VALUE_HERE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
Obsidian Brain is an MCP server for Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y obsidian-brain; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y obsidian-brain. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y obsidian-brain. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y obsidian-brain. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y obsidian-brain. Add required environment variables before starting Cursor or VS Code.
Obsidian Brain uses STDIO transport. Use the package or command config in Install.
Obsidian Brain inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
Obsidian Brain is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
obsidian-brainstdio | npm | 1.7.9 | Env: VAULT_PATH required Env: DATA_DIR Env: EMBEDDING_PRESET Env: EMBEDDING_MODEL Env: EMBEDDING_PROVIDER Env: OLLAMA_BASE_URL Env: OLLAMA_EMBEDDING_DIM Env: OLLAMA_NUM_CTX Env: OBSIDIAN_BRAIN_NO_WATCH Env: OBSIDIAN_BRAIN_NO_CATCHUP Env: OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS Env: OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS Env: OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS Env: OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS Env: OBSIDIAN_BRAIN_CONFIG_DIR |