Obsidian Hybrid Search

Package (npm 0.15.6)

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>",
        "OBSIDIAN_PREFIX": "<YOUR_VALUE>",
        "OBSIDIAN_IGNORE_PATTERNS": "<YOUR_VALUE>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<YOUR_VALUE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<YOUR_VALUE>",
        "OPENAI_API_KEY": "<YOUR_VALUE>",
        "OPENAI_BASE_URL": "<YOUR_VALUE>",
        "OPENAI_EMBEDDING_MODEL": "<YOUR_VALUE>",
        "LOCAL_EMBEDDING_MODEL": "<YOUR_VALUE>",
        "RERANKER_MODEL": "<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 root and nested .gitignore files when indexing; set to false, 0, or no to disable.
• OBSIDIAN_INCLUDE_PATTERNS — Comma-separated patterns to re-include notes ignored only by .gitignore.
• 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.