MCP.so
Sign In

Obsidian Index MCP server

@tcsavage

About Obsidian Index MCP server

MCP server providing sementic search over Obsidian vaults

Basic information

Category

Memory & Knowledge

Runtime

python

Transports

stdio

Publisher

tcsavage

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"
      ]
    }
  }
}

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.

FAQ from Obsidian Index MCP server

What kind of search does it perform?

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

How do I run the server?

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

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).

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.

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