Obsidian Hybrid Search

Name: Obsidian Hybrid Search
Author: flowing-abyss

Community

MCP server by flowing-abyss · updated 5 days ago · ★ 112 · 565 downloads a week

Score 80

Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval. Obsidian Hybrid Search is a community project by flowing-abyss, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub Website

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Install Obsidian Hybrid Search

Built from the published package, never by AI

claude mcp add obsidian-hybrid-search -e OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- npx -y obsidian-hybrid-search

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Obsidian Hybrid Search in Claude Code

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Obsidian Hybrid Search in Claude Desktop

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Obsidian Hybrid Search in Cursor

{
  "servers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Obsidian Hybrid Search in VS Code

codex mcp add obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- npx -y obsidian-hybrid-search

Step-by-step: install Obsidian Hybrid Search in Codex

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Obsidian Hybrid Search in Antigravity CLI

gemini mcp add obsidian-hybrid-search npx -y obsidian-hybrid-search

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Obsidian Hybrid Search in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the obsidian-hybrid-search block.

Maintenance

Last commit 5 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, 112 stars, original repository

Security

No risky patterns in the files we checked

What you need

Setting	Needed	What it is
`OBSIDIAN_VAULT_PATH`Environment variable	Required	Absolute path to the Obsidian vault to index and search.
`OBSIDIAN_PREFIX`Environment variable	Optional	Optional prefix for MCP tool names when configuring multiple vaults.
`OBSIDIAN_IGNORE_PATTERNS`Environment variable	Optional	Comma-separated glob patterns to exclude from indexing. Default: `.obsidian/,templates/,*.canvas`
`OBSIDIAN_RESPECT_GITIGNORE`Environment variable	Optional	Read root and nested .gitignore files when indexing; set to false, 0, or no to disable. Default: `true`
`OBSIDIAN_INCLUDE_PATTERNS`Environment variable	Optional	Comma-separated patterns to re-include notes ignored only by .gitignore.
`OPENAI_API_KEY`Environment variable, secret	Optional	Optional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
`OPENAI_BASE_URL`Environment variable	Optional	Optional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers. Default: `https://api.openai.com/v1`
`OPENAI_EMBEDDING_MODEL`Environment variable	Optional	Remote embedding model name when using an OpenAI-compatible API. Default: `text-embedding-3-small`
`LOCAL_EMBEDDING_MODEL`Environment variable	Optional	Local embedding model used when no remote embedding API is configured. Default: `Xenova/multilingual-e5-small`
`RERANKER_MODEL`Environment variable	Optional	Optional ONNX cross-encoder reranker model used when reranking is requested. Default: `onnx-community/gte-multilingual-reranker-base`

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Weekly newsletter

Like Obsidian Hybrid Search? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Security check

No download-and-run commands, hidden instructions or signs of sending keys out were found.

Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work

Alternatives to Obsidian Hybrid Search

All alternatives →

exa exa-labs

100

Connect AI agents to Exa for web search, content fetching, and multi-step research.

AAA Remote 5.1k

Agent Skills Search Server agentskills

Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.

BAA Remote 26k

brave brave

Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…

AAA Remote 1.5k

Atlassian Rovo MCP Server atlassian

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

AAA Remote 1.1k

Zotero MCP54yyyu

Search, read, annotate, and add to your Zotero research library, local or web.

AAA Local 5.5k

Agent-Native AssetsBuilderIO

Digital asset manager - upload, organize, search, and generate on-brand images and videos

AAA Remote 7.4k

Obsidian Hybrid Search vs exa Obsidian Hybrid Search vs Agent Skills Search Server Obsidian Hybrid Search vs brave

Obsidian Hybrid Search: common questions

How do I install Obsidian Hybrid Search?

In Claude Code run claude mcp add obsidian-hybrid-search -e OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- npx -y obsidian-hybrid-search. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Obsidian Hybrid Search the official server?

Obsidian Hybrid Search is a community project by flowing-abyss, not verified by a company domain.

Is Obsidian Hybrid Search free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is Obsidian Hybrid Search safe to use?

It scores 80 of 100. Grades: maintenance A, licence A, quality B. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.

What are alternatives to Obsidian Hybrid Search?

Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.

Does Obsidian Hybrid Search work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.