Obsidian Hybrid Search MCP Server

What this does

Obsidian Hybrid Search exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

OBSIDIAN_VAULT_PATH
OBSIDIAN_PREFIX
OBSIDIAN_IGNORE_PATTERNS
OBSIDIAN_RESPECT_GITIGNORE
OBSIDIAN_INCLUDE_PATTERNS
OBSIDIAN_CONTENT_IGNORE_PATTERNS
OPENAI_API_KEY
OPENAI_BASE_URL
OPENAI_EMBEDDING_MODEL
LOCAL_EMBEDDING_MODEL
RERANKER_MODEL

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install Obsidian Hybrid Search?

Run the Claude Code command in the install section to add Obsidian Hybrid Search to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with Obsidian Hybrid Search?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Obsidian Hybrid Search as well.

Does Obsidian Hybrid Search need an API key?

Yes. Before it can run, set these environment variables: OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_IGNORE_PATTERNS, OBSIDIAN_RESPECT_GITIGNORE, OBSIDIAN_INCLUDE_PATTERNS, OBSIDIAN_CONTENT_IGNORE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, LOCAL_EMBEDDING_MODEL, RERANKER_MODEL. They go in the env block of your MCP config.