Obsidian Hybrid Search

Obsidian Hybrid Search is a local MCP server: Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval. Install it from npm as obsidian-hybrid-search.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add obsidian-hybrid-search -e OBSIDIAN_VAULT_PATH=... -e OBSIDIAN_PREFIX=... -e OBSIDIAN_IGNORE_PATTERNS=... -e OBSIDIAN_RESPECT_GITIGNORE=... -e OBSIDIAN_INCLUDE_PATTERNS=... -e OPENAI_API_KEY=... -e OPENAI_BASE_URL=... -e OPENAI_EMBEDDING_MODEL=... -e LOCAL_EMBEDDING_MODEL=... -e RERANKER_MODEL=... -- npx -y obsidian-hybrid-search

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "...",
        "OBSIDIAN_PREFIX": "...",
        "OBSIDIAN_IGNORE_PATTERNS": "...",
        "OBSIDIAN_RESPECT_GITIGNORE": "...",
        "OBSIDIAN_INCLUDE_PATTERNS": "...",
        "OPENAI_API_KEY": "...",
        "OPENAI_BASE_URL": "...",
        "OPENAI_EMBEDDING_MODEL": "...",
        "LOCAL_EMBEDDING_MODEL": "...",
        "RERANKER_MODEL": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_IGNORE_PATTERNS, OBSIDIAN_RESPECT_GITIGNORE, OBSIDIAN_INCLUDE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, LOCAL_EMBEDDING_MODEL, RERANKER_MODEL