Obsidian Semantic Search
About
Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.
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
OBSIDIAN_VAULT_ROOT OBSIDIAN_SEMANTIC_MCP_HOME OBSIDIAN_EMBED_MODEL OLLAMA_BASE_URL OBSIDIAN_SEMANTIC_STARTUP_INDEX OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE OBSIDIAN_SEMANTIC_EXCLUDE OBSIDIAN_SEMANTIC_SENSITIVE_PATHSClaude Code
claude mcp add --env OBSIDIAN_VAULT_ROOT= --env OBSIDIAN_SEMANTIC_MCP_HOME= --env OBSIDIAN_EMBED_MODEL= --env OLLAMA_BASE_URL= --env OBSIDIAN_SEMANTIC_STARTUP_INDEX= --env OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE= --env OBSIDIAN_SEMANTIC_EXCLUDE= --env OBSIDIAN_SEMANTIC_SENSITIVE_PATHS= obsidian-semantic-mcp -- npx @dalecb/obsidian-semantic-mcp
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-semantic-mcp","command":"npx","args":["@dalecb/obsidian-semantic-mcp"],"env":{"OBSIDIAN_VAULT_ROOT":"","OBSIDIAN_SEMANTIC_MCP_HOME":"","OBSIDIAN_EMBED_MODEL":"","OLLAMA_BASE_URL":"","OBSIDIAN_SEMANTIC_STARTUP_INDEX":"","OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE":"","OBSIDIAN_SEMANTIC_EXCLUDE":"","OBSIDIAN_SEMANTIC_SENSITIVE_PATHS":""}}'
JSON
{
"mcpServers": {
"obsidian-semantic-mcp": {
"command": "npx",
"args": [
"@dalecb/obsidian-semantic-mcp"
],
"env": {
"OBSIDIAN_VAULT_ROOT": "",
"OBSIDIAN_SEMANTIC_MCP_HOME": "",
"OBSIDIAN_EMBED_MODEL": "",
"OLLAMA_BASE_URL": "",
"OBSIDIAN_SEMANTIC_STARTUP_INDEX": "",
"OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "",
"OBSIDIAN_SEMANTIC_EXCLUDE": "",
"OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.