Obsidian Hybrid Search

Package (npm 0.17.5)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_VALUE>",
        "OPENAI_API_KEY": "<YOUR_VALUE>"
      }
    }
  }
}

• OBSIDIAN_VAULT_PATH required — Absolute path to the Obsidian vault to index and search.
• OBSIDIAN_PREFIX — Optional prefix for MCP tool names when configuring multiple vaults.
• OBSIDIAN_IGNORE_PATTERNS — Comma-separated glob patterns to exclude from indexing.
• OBSIDIAN_RESPECT_GITIGNORE — Read applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
• OBSIDIAN_INCLUDE_PATTERNS — Comma-separated patterns to re-include notes ignored only by Git ignore rules.
• OBSIDIAN_CONTENT_IGNORE_PATTERNS — Comma-separated regex rules for note body text to leave out of search, e.g. /%%[\s\S]*?%%/g. Original files and read stay unchanged.
• OPENAI_API_KEY secret — Optional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
• OPENAI_BASE_URL — Optional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
• OPENAI_EMBEDDING_MODEL — Remote embedding model name when using an OpenAI-compatible API.
• LOCAL_EMBEDDING_MODEL — Local embedding model used when no remote embedding API is configured.
• RERANKER_MODEL — Optional ONNX cross-encoder reranker model used when reranking is requested.

This server takes extra arguments — see its repository.