Skip to content

Obsidian Semantic Search for Grok

io.github.dalecb/obsidian-semantic-mcp

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

client:Grok transport:stdio runtime:npm

Install Obsidian Semantic Search in Grok

.mcp.json (in your project root)

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

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Grok Build reads Claude Code's .mcp.json and Claude Desktop's config unchanged, so a server you have already set up there needs nothing new. The Grok web app and X integration do not take custom servers. Grok docs

Obsidian Semantic Search in other clients