Obsidian Hybrid Search

io.github.flowing-abyss/obsidian-hybrid-search · v0.17.6

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

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add obsidian-hybrid-search -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -e OBSIDIAN_PREFIX=<OBSIDIAN_PREFIX> -e OBSIDIAN_IGNORE_PATTERNS=<OBSIDIAN_IGNORE_PATTERNS> -e OBSIDIAN_RESPECT_GITIGNORE=<OBSIDIAN_RESPECT_GITIGNORE> -e OBSIDIAN_INCLUDE_PATTERNS=<OBSIDIAN_INCLUDE_PATTERNS> -e OBSIDIAN_CONTENT_IGNORE_PATTERNS=<OBSIDIAN_CONTENT_IGNORE_PATTERNS> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e OPENAI_BASE_URL=<OPENAI_BASE_URL> -e OPENAI_EMBEDDING_MODEL=<OPENAI_EMBEDDING_MODEL> -e LOCAL_EMBEDDING_MODEL=<LOCAL_EMBEDDING_MODEL> -e RERANKER_MODEL=<RERANKER_MODEL> -- npx -y [email protected]

claude_desktop_config.json

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

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "obsidian-hybrid-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_PREFIX": "<OBSIDIAN_PREFIX>",
        "OBSIDIAN_IGNORE_PATTERNS": "<OBSIDIAN_IGNORE_PATTERNS>",
        "OBSIDIAN_RESPECT_GITIGNORE": "<OBSIDIAN_RESPECT_GITIGNORE>",
        "OBSIDIAN_INCLUDE_PATTERNS": "<OBSIDIAN_INCLUDE_PATTERNS>",
        "OBSIDIAN_CONTENT_IGNORE_PATTERNS": "<OBSIDIAN_CONTENT_IGNORE_PATTERNS>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<OPENAI_EMBEDDING_MODEL>",
        "LOCAL_EMBEDDING_MODEL": "<LOCAL_EMBEDDING_MODEL>",
        "RERANKER_MODEL": "<RERANKER_MODEL>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`OBSIDIAN_VAULT_PATH` Required	Absolute path to the Obsidian vault to index and search.
`OBSIDIAN_PREFIX` Optional	Optional prefix for MCP tool names when configuring multiple vaults.
`OBSIDIAN_IGNORE_PATTERNS` Optional	Comma-separated glob patterns to exclude from indexing.
`OBSIDIAN_RESPECT_GITIGNORE` Optional	Read applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
`OBSIDIAN_INCLUDE_PATTERNS` Optional	Comma-separated patterns to re-include notes ignored only by Git ignore rules.
`OBSIDIAN_CONTENT_IGNORE_PATTERNS` Optional	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` Optional, secret	Optional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
`OPENAI_BASE_URL` Optional	Optional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
`OPENAI_EMBEDDING_MODEL` Optional	Remote embedding model name when using an OpenAI-compatible API.
`LOCAL_EMBEDDING_MODEL` Optional	Local embedding model used when no remote embedding API is configured.
`RERANKER_MODEL` Optional	Optional ONNX cross-encoder reranker model used when reranking is requested.

Details

Package	`[email protected]` (NPM, stdio)
First published	13 Nov 2026
Last updated	13 Nov 2026
Registry name	`io.github.flowing-abyss/obsidian-hybrid-search`

More search and web servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Obsidian Hybrid Search often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-flowing-abyss-obsidian-hybrid-search/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-flowing-abyss-obsidian-hybrid-search)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.