Install guide · Claude Desktop
Install Obsidian MCP Server for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "maxkuminov-obsidian-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/maxkuminov/obsidian-mcp:v1.2.0" ], "env": { "DATABASE_URL": "YOUR_DATABASE_URL", "VAULT_PATH": "/obsidian", "SECRET_KEY": "YOUR_SECRET_KEY", "MCP_HOSTNAME": "", "EMBEDDING_PROVIDER": "ollama", "OLLAMA_URL": "http://ollama:11434", "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY", "TEI_URL": "http://tei:80", "TEI_EMBEDDING_MODEL": "BAAI/bge-m3", "TEI_EMBED_BATCH_SIZE": "16" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |