MCP Server

Obsidian Hybrid Search MCP Server

Name: Obsidian Hybrid Search MCP Server
Author: io.github.flowing-abyss

io.github.flowing-abyss/obsidian-hybrid-search

Repository Registry

What is the Obsidian Hybrid Search MCP server?

Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.

How to install Obsidian Hybrid Search

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_PREFIX": "<YOUR_OBSIDIAN_PREFIX>",
        "OBSIDIAN_IGNORE_PATTERNS": "<YOUR_OBSIDIAN_IGNORE_PATTERNS>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<YOUR_OBSIDIAN_RESPECT_GITIGNORE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<YOUR_OBSIDIAN_INCLUDE_PATTERNS>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "<YOUR_OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<YOUR_OPENAI_EMBEDDING_MODEL>",
        "LOCAL_EMBEDDING_MODEL": "<YOUR_LOCAL_EMBEDDING_MODEL>",
        "RERANKER_MODEL": "<YOUR_RERANKER_MODEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_PREFIX": "<YOUR_OBSIDIAN_PREFIX>",
        "OBSIDIAN_IGNORE_PATTERNS": "<YOUR_OBSIDIAN_IGNORE_PATTERNS>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<YOUR_OBSIDIAN_RESPECT_GITIGNORE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<YOUR_OBSIDIAN_INCLUDE_PATTERNS>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "<YOUR_OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<YOUR_OPENAI_EMBEDDING_MODEL>",
        "LOCAL_EMBEDDING_MODEL": "<YOUR_LOCAL_EMBEDDING_MODEL>",
        "RERANKER_MODEL": "<YOUR_RERANKER_MODEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_PREFIX": "<YOUR_OBSIDIAN_PREFIX>",
        "OBSIDIAN_IGNORE_PATTERNS": "<YOUR_OBSIDIAN_IGNORE_PATTERNS>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<YOUR_OBSIDIAN_RESPECT_GITIGNORE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<YOUR_OBSIDIAN_INCLUDE_PATTERNS>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "<YOUR_OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<YOUR_OPENAI_EMBEDDING_MODEL>",
        "LOCAL_EMBEDDING_MODEL": "<YOUR_LOCAL_EMBEDDING_MODEL>",
        "RERANKER_MODEL": "<YOUR_RERANKER_MODEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "obsidian-hybrid-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search",
        "mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_PREFIX": "<YOUR_OBSIDIAN_PREFIX>",
        "OBSIDIAN_IGNORE_PATTERNS": "<YOUR_OBSIDIAN_IGNORE_PATTERNS>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<YOUR_OBSIDIAN_RESPECT_GITIGNORE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<YOUR_OBSIDIAN_INCLUDE_PATTERNS>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "<YOUR_OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<YOUR_OPENAI_EMBEDDING_MODEL>",
        "LOCAL_EMBEDDING_MODEL": "<YOUR_LOCAL_EMBEDDING_MODEL>",
        "RERANKER_MODEL": "<YOUR_RERANKER_MODEL>"
      }
    }
  }
}

Claude Code

claude mcp add obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_PREFIX=<YOUR_OBSIDIAN_PREFIX> --env OBSIDIAN_IGNORE_PATTERNS=<YOUR_OBSIDIAN_IGNORE_PATTERNS> --env OBSIDIAN_RESPECT_GITIGNORE=<YOUR_OBSIDIAN_RESPECT_GITIGNORE> --env OBSIDIAN_INCLUDE_PATTERNS=<YOUR_OBSIDIAN_INCLUDE_PATTERNS> --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env OPENAI_BASE_URL=<YOUR_OPENAI_BASE_URL> --env OPENAI_EMBEDDING_MODEL=<YOUR_OPENAI_EMBEDDING_MODEL> --env LOCAL_EMBEDDING_MODEL=<YOUR_LOCAL_EMBEDDING_MODEL> --env RERANKER_MODEL=<YOUR_RERANKER_MODEL> -- npx -y obsidian-hybrid-search mcp