Skip to content
mcp/harbor
Windsurf

Obsidian Semantic Search for Windsurf

io.github.dalecb/obsidian-semantic-mcp

Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.

client:Windsurf transport:stdio runtime:npm

Install Obsidian Semantic Search in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

Obsidian Semantic Search in other clients

Obsidian Semantic Search MCP server