Obsidian Hybrid Search MCP Server

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

Local serverstdio

What is the Obsidian Hybrid Search MCP Server?

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

What you get

Your Obsidian vault already contains your best thinking. Obsidian Hybrid Search makes that thinking easier to find, reuse, and bring into AI-assisted work.

  • Hybrid search —
  • BM25 + fuzzy title + semantic embeddings, fused with RRF
  • Alias search —
  • notes with aliases: in frontmatter are indexed and searchable by any alias; alias matches are boosted in BM25 (weight 5×) and fuzzy title scoring
  • Four search modes —
  • hybrid, semantic, fulltext, title (for text queries)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
searchSearch the vault. Use query for text search (mode: hybrid/semantic/fulltext/title) or path for semantic similarity. Combine path with related: true for graph traversal. Pass queries[] for multi-query fan-out (parallel se
readFetch one or more notes by vault-relative path. Returns full content, title, aliases, tags, links, and backlinks. On path miss: returns found: false with top-3 fuzzy suggestions. Accepts a single path or an array. Use sn
reindexReindex the vault or a specific file
statusShow total notes, indexed count, last indexed time

How to install the Obsidian Hybrid Search MCP Server

claude mcp add obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=your-value --env OBSIDIAN_PREFIX=your-value --env OBSIDIAN_RESPECT_GITIGNORE=your-value --env OBSIDIAN_IGNORE_PATTERNS=your-value --env OBSIDIAN_INCLUDE_PATTERNS=your-value --env OPENAI_API_KEY=your-value --env OPENAI_BASE_URL=your-value --env OPENAI_EMBEDDING_MODEL=your-value -- npx -y obsidian-hybrid-search

Configuration

VariableDescriptionRequired
OBSIDIAN_VAULT_PATHFilesystem location the server is allowed to use.Optional
OBSIDIAN_PREFIXConfiguration value read at startup.Optional
OBSIDIAN_RESPECT_GITIGNOREConfiguration value read at startup.Optional
OBSIDIAN_IGNORE_PATTERNSConfiguration value read at startup.Optional
OBSIDIAN_INCLUDE_PATTERNSConfiguration value read at startup.Optional
OPENAI_API_KEYCredential the server authenticates with.Yes
OPENAI_BASE_URLEndpoint or connection string the server talks to.Yes
OPENAI_EMBEDDING_MODELConfiguration value read at startup.Optional

Example prompts to try

  • “Use Obsidian Hybrid Search to search.”
  • “Use Obsidian Hybrid Search to read.”
  • “Use Obsidian Hybrid Search to reindex.”

Frequently asked questions

Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.