Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.
Obsidian Hybrid Search MCP server exists for a simple reason — assistants are far more useful when they can act on Obsidian Hybrid Search directly instead of describing what you should do. Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.
Your Obsidian vault already contains your best thinking. Obsidian Hybrid Search makes that thinking easier to find, reuse, and bring into AI-assisted work.
The server ships on npm as obsidian-hybrid-search, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Once Obsidian Hybrid Search is connected, these are the calls the assistant has available:
search — Search the vault. Use query for text search (mode: hybrid/semantic/fulltext/title) or path for semantic similarity. Combine path with related: trueread — Fetch one or more notes by vault-relative path. Returns full content, title, aliases, tags, links, and backlinks. On path miss: returns found: falsereindex — Reindex the vault or a specific filestatus — Show total notes, indexed count, last indexed timeYou will need 8 environment variables: OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_RESPECT_GITIGNORE, OBSIDIAN_IGNORE_PATTERNS, OBSIDIAN_INCLUDE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Obsidian Hybrid Search's toolset — search, read, reindex and 1 more — is a fair guide to whether it matches your workflow. It is maintained by flowing-abyss; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Obsidian Hybrid Search's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| search | Search 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 |
| read | Fetch 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 |
| reindex | Reindex the vault or a specific file |
| status | Show total notes, indexed count, last indexed time |
### Full config (OpenRouter)
```json
{
"mcpServers": {
"obsidian-hybrid-search": {
"command": "npx",
"args": ["-y", "-p", "obsidian-hybrid-search@latest", "obsidian-hybrid-search-mcp"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
"OBSIDIAN_PREFIX": "myvault_",
"OBSIDIAN_RESPECT_GITIGNORE": "true",
"OBSIDIAN_IGNORE_PATTERNS": ".obsidian/**,templates/**,*.canvas",
"OBSIDIAN_INCLUDE_PATTERNS": "private/notes/**",
"OPENAI_API_KEY": "sk-or-v1-...",
"OPENAI_BASE_URL": "https://openrouter.ai/api/v1",
"OPENAI_EMBEDDING_MODEL": "openai/text-embedding-3-small"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| OBSIDIAN_VAULT_PATH | Filesystem location the server is allowed to use. | Optional |
| OBSIDIAN_PREFIX | Configuration value read at startup. | Optional |
| OBSIDIAN_RESPECT_GITIGNORE | Configuration value read at startup. | Optional |
| OBSIDIAN_IGNORE_PATTERNS | Configuration value read at startup. | Optional |
| OBSIDIAN_INCLUDE_PATTERNS | Configuration value read at startup. | Optional |
| OPENAI_API_KEY | Credential the server authenticates with. | Yes |
| OPENAI_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| OPENAI_EMBEDDING_MODEL | Configuration value read at startup. | Optional |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.