Advertise
MCP.so
Sign In

Obsidian Index MCP server

@tcsavage

Repository

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

tcsavage

About Obsidian Index MCP server

MCP server providing sementic search over Obsidian vaults

Obsidian Index MCP server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-obsidian-index": {
      "command": "uv",
      "args": [
        "run",
        "obsidian-index",
        "mcp",
        "--vault",
        "<VAULT_PATH>",
        "--database",
        "<DATABASE_PATH>",
        "--reindex",
        "--watch"
      ]
    }
  }
}

Obsidian Index MCP server tools

1

Performs semantic search over indexed notes

Overview

What is Obsidian Index MCP server?

Obsidian Index MCP server is an MCP server that provides semantic search over an Obsidian vault and exposes recently modified notes as resources. It is designed for users of Obsidian who want to integrate semantic search and note retrieval into MCP-compatible tools.

How to use Obsidian Index MCP server?

Install via PyPI using uv run obsidian-index or uvx obsidian-index. Launch the server with --vault <VAULT_PATH>, --database <DATABASE_PATH>, --reindex, and --watch flags. The server exposes one tool (search-notes) and the recent notes as resources.

Key features of Obsidian Index MCP server

  • Semantic search over indexed Obsidian vault notes.
  • Exposes recently modified notes as resources.
  • Notes addressed by obsidian:// URL scheme with text/markdown MIME type.
  • Supports multiple vaults via repeated --vault flag.
  • Watches vault changes and updates index automatically with --watch.
  • Reindexes all notes with --reindex flag.

Use cases of Obsidian Index MCP server

  • Quickly find relevant notes in a large Obsidian vault using semantic search.
  • Integrate Obsidian note retrieval into AI assistant contexts (e.g., Claude Desktop).
  • Automatically index and search notes across multiple vaults.
  • Provide recent note context to MCP-compatible clients for enhanced responses.

Frequently asked questions

1

What kind of search does it perform?

It performs semantic search over indexed notes in the Obsidian vault.

2

How do I run the server?

Use `uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch` in your terminal.

3

What are the configuration options for Claude Desktop?

Add a JSON entry to `claude_desktop_config.json` using the `uv` or `uvx` command with the appropriate arguments (see Quickstart section in the README).

4

Are there any dependencies?

The server requires Python (with the package installed via `uv`) and the Obsidian Index package itself. No additional runtime dependencies are listed.

5

How can I debug the server?

Use the MCP Inspector: run `npx @modelcontextprotocol/inspector uv --directory <PATH_TO_PROJECT> run obsidian-index`.

Comments

More Memory & Knowledge MCP servers

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

HandbookHub MCP

veryayskiy

Search saved employee handbooks from your AI assistant. Four read-only tools list authorized handbooks, browse policies, search content, and read source pages with citation links. Uses scoped bearer tokens and Streamable

UmmahAPI

Yousuf Kazmi

Islamic source data for assistants: Quran, hadith, tafsir, duas, prayer times and qibla. Answers come from real sources with citations instead of recalled text, so verses and hadith are not hallucinated. 36,000+ hadiths

AOCI-CODE

aoci-spec

Local MCP server and CLI that keeps a Git-versioned, model-written index of a codebase and its database schema, so coding agents start each task with the whole system in view.

1.7K

Stele

Stele-Dev

Shared memory for AI coding agents. Claude Code, Cursor and Codex read your project's decisions, lessons and tasks before they act.

Advertise