Obsidian Hybrid Search

io.github.flowing-abyss/obsidian-hybrid-search

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

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search@0.17.4"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<your OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_IGNORE_PATTERNS": ".obsidian/**,templates/**,*.canvas",
        "OBSIDIAN_RESPECT_GITIGNORE": "true",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "OPENAI_BASE_URL": "https://api.openai.com/v1",
        "OPENAI_EMBEDDING_MODEL": "text-embedding-3-small",
        "LOCAL_EMBEDDING_MODEL": "Xenova/multilingual-e5-small",
        "RERANKER_MODEL": "onnx-community/gte-multilingual-reranker-base"
      }
    }
  }
}
Environment variables
  • OBSIDIAN_VAULT_PATHrequiredAbsolute path to the Obsidian vault to index and search.
  • OBSIDIAN_IGNORE_PATTERNSComma-separated glob patterns to exclude from indexing.
  • OBSIDIAN_RESPECT_GITIGNORERead applicable .gitignore files and repository info/exclude rules when indexing; set to false, 0, or no to disable both.
  • OPENAI_API_KEYsecretOptional API key for OpenAI-compatible remote embeddings; omit to use local embeddings.
  • OPENAI_BASE_URLOptional OpenAI-compatible API base URL for OpenRouter, Ollama, LM Studio, or similar providers.
  • OPENAI_EMBEDDING_MODELRemote embedding model name when using an OpenAI-compatible API.
  • LOCAL_EMBEDDING_MODELLocal embedding model used when no remote embedding API is configured.
  • RERANKER_MODELOptional ONNX cross-encoder reranker model used when reranking is requested.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.17.4
Registry
active
Published
11/4/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that Obsidian Hybrid Search is listed here — it’s also the link we check for a free listing.

Obsidian Hybrid Search — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-flowing-abyss-obsidian-hybrid-search?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Obsidian Hybrid Search — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Obsidian Hybrid Search — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-flowing-abyss-obsidian-hybrid-search?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.