Obsidian Brain
About
Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.
Use this server
Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.
Transportstdio (runs a local command)
Env vars
VAULT_PATH DATA_DIR EMBEDDING_PRESET EMBEDDING_MODEL EMBEDDING_PROVIDER OLLAMA_BASE_URL OLLAMA_EMBEDDING_DIM OLLAMA_NUM_CTX OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL OBSIDIAN_BRAIN_NO_WATCH OBSIDIAN_BRAIN_NO_CATCHUP OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS OBSIDIAN_BRAIN_CONFIG_DIR OBSIDIAN_BRAIN_DEBUG OBSIDIAN_BRAIN_LOG_FORMATClaude Code
claude mcp add --env VAULT_PATH= --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_OLLAMA_AUTO_PULL= --env OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL= --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= --env OBSIDIAN_BRAIN_DEBUG= --env OBSIDIAN_BRAIN_LOG_FORMAT= obsidian-brain -- npx obsidian-brain
Cursor
If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.
VS Code
code --add-mcp '{"name":"obsidian-brain","command":"npx","args":["obsidian-brain"],"env":{"VAULT_PATH":"","DATA_DIR":"","EMBEDDING_PRESET":"","EMBEDDING_MODEL":"","EMBEDDING_PROVIDER":"","OLLAMA_BASE_URL":"","OLLAMA_EMBEDDING_DIM":"","OLLAMA_NUM_CTX":"","OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL":"","OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL":"","OBSIDIAN_BRAIN_NO_WATCH":"","OBSIDIAN_BRAIN_NO_CATCHUP":"","OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS":"","OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS":"","OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS":"","OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS":"","OBSIDIAN_BRAIN_CONFIG_DIR":"","OBSIDIAN_BRAIN_DEBUG":"","OBSIDIAN_BRAIN_LOG_FORMAT":""}}'
JSON
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"obsidian-brain"
],
"env": {
"VAULT_PATH": "",
"DATA_DIR": "",
"EMBEDDING_PRESET": "",
"EMBEDDING_MODEL": "",
"EMBEDDING_PROVIDER": "",
"OLLAMA_BASE_URL": "",
"OLLAMA_EMBEDDING_DIM": "",
"OLLAMA_NUM_CTX": "",
"OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL": "",
"OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL": "",
"OBSIDIAN_BRAIN_NO_WATCH": "",
"OBSIDIAN_BRAIN_NO_CATCHUP": "",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "",
"OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS": "",
"OBSIDIAN_BRAIN_CONFIG_DIR": "",
"OBSIDIAN_BRAIN_DEBUG": "",
"OBSIDIAN_BRAIN_LOG_FORMAT": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.