Obsidian Hybrid Search
Rank #944io.github.flowing-abyss/obsidian-hybrid-search
Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.
Obsidian Hybrid Search is a Model Context Protocol (MCP) server published by flowing-abyss. It ranks #944 of 132,046 servers tracked on MCP Toplist, and its repository has 105 GitHub stars. Obsidian Hybrid Search is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 28 tracked versions. It was first listed on May 24, 2026 and most recently updated on Sep 21, 2026.
Ranks ahead of 131,102 of 132,046 servers on MCP Toplist.
Use Obsidian Hybrid Search
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add obsidian-hybrid-search -e "OBSIDIAN_VAULT_PATH=<your OBSIDIAN_VAULT_PATH>" -e "OBSIDIAN_PREFIX=<your OBSIDIAN_PREFIX>" -e "OBSIDIAN_IGNORE_PATTERNS=<your OBSIDIAN_IGNORE_PATTERNS>" -e "OBSIDIAN_RESPECT_GITIGNORE=<your OBSIDIAN_RESPECT_GITIGNORE>" -e "OBSIDIAN_INCLUDE_PATTERNS=<your OBSIDIAN_INCLUDE_PATTERNS>" -e "OPENAI_API_KEY=<your OPENAI_API_KEY>" -e "OPENAI_BASE_URL=<your OPENAI_BASE_URL>" -e "OPENAI_EMBEDDING_MODEL=<your OPENAI_EMBEDDING_MODEL>" -e "LOCAL_EMBEDDING_MODEL=<your LOCAL_EMBEDDING_MODEL>" -e "RERANKER_MODEL=<your RERANKER_MODEL>" -- npx -y obsidian-hybrid-search mcpReplace each placeholder with your own value before saving.
[mcp_servers.obsidian-hybrid-search]
command = "npx"
args = ["-y", "obsidian-hybrid-search", "mcp"]
[mcp_servers.obsidian-hybrid-search.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>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"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>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"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>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"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>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"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>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.flowing-abyss%2Fobsidian-hybrid-search)<a href="https://mcptoplist.com/server/io.github.flowing-abyss%2Fobsidian-hybrid-search"><img src="https://mcptoplist.com/badge/io.github.flowing-abyss%2Fobsidian-hybrid-search.svg" alt="MCP Toplist: Top 1% of 132,046" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 4 registries
flowing-abyss
Available versions (28)
| Version | Published |
|---|---|
| 0.15.6 | Sep 21, 2026 |
| 0.15.5 | Sep 20, 2026 |
| 0.15.4 | Sep 20, 2026 |
| 0.15.3 | Sep 17, 2026 |
| 0.15.2 | Aug 31, 2026 |
| 0.15.1 | Aug 24, 2026 |
| 0.15.0 | Aug 19, 2026 |
| 0.14.3 | Aug 17, 2026 |
| 0.14.2 | Aug 14, 2026 |
| 0.14.1 | Aug 10, 2026 |
| 0.14.0 | Aug 9, 2026 |
| 0.13.25 | Aug 3, 2026 |
| 0.13.24 | Jul 27, 2026 |
| 0.13.23 | Jul 21, 2026 |
| 0.13.22 | Jul 15, 2026 |
| 0.13.21 | Jul 14, 2026 |
| 0.13.20 | Jul 13, 2026 |
| 0.13.19 | Jul 11, 2026 |
| 0.13.18 | Jul 6, 2026 |
| 0.13.17 | Jul 6, 2026 |
| 0.13.16 | Jun 29, 2026 |
| 0.13.15 | Jun 26, 2026 |
| 0.13.14 | Jun 25, 2026 |
| 0.13.13 | Jun 22, 2026 |
| 0.13.12 | Jun 18, 2026 |
| 0.13.11 | Jun 16, 2026 |
| 0.13.10 | Jun 15, 2026 |
| 0.13.8 | Jun 12, 2026 |
Frequently asked questions
- Who maintains Obsidian Hybrid Search?
- Obsidian Hybrid Search is maintained by flowing-abyss, which publishes 1 MCP server (28 total versions) tracked on MCP Toplist.
- Is Obsidian Hybrid Search listed on the Official MCP Registry?
- Yes — Obsidian Hybrid Search is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
- How many versions does Obsidian Hybrid Search have?
- MCP Toplist tracks 28 versions of Obsidian Hybrid Search, most recently published on Sep 21, 2026.
- Where can I find the source code for Obsidian Hybrid Search?
- The source code for Obsidian Hybrid Search is hosted at github.com/flowing-abyss/obsidian-hybrid-search.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.