mcpserver.so LogoMCPFly
Submit
Obsidian Index MCP Server logo

Obsidian Index MCP Server

by tcsavage

Knowledge ManagementObsidianSemantic SearchNotesIndexing

An MCP server that provides semantic search over an Obsidian vault and exposes recent notes as resources. It allows MCP clients to access and search your Obsidian notes.

View on GitHub

Last updated: N/A

What is Obsidian Index MCP Server?

The Obsidian Index MCP server is a tool that indexes your Obsidian vault and exposes its notes as resources to MCP (Model Context Protocol) clients. It provides a semantic search functionality and allows clients to access recently modified notes.

How to use Obsidian Index MCP Server?

  1. Install the server by following the development/unpublished or published servers configuration instructions for Claude Desktop (or your MCP client). 2. Run the server using the provided command, specifying the vault path, database path, and whether to reindex and watch for changes: uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch. 3. Use the search-notes tool to perform semantic searches over the indexed notes from your MCP client.

Key features of Obsidian Index MCP Server

  • Semantic search over Obsidian notes

  • Exposes recent notes as resources

  • Supports the obsidian:// URL scheme

  • Provides a text/markdown media type for notes

Use cases of Obsidian Index MCP Server

  • Integrating Obsidian notes into MCP-based workflows

  • Semantic searching of Obsidian vaults from other applications

  • Accessing recent notes from MCP clients

  • Building AI-powered tools that leverage Obsidian knowledge

FAQ from Obsidian Index MCP Server

How do I specify the Obsidian vault?

Use the --vault flag followed by the path to your Obsidian vault. You can specify multiple vaults.

What is the database used for?

The database stores the index of your Obsidian notes, enabling semantic search.

Should I use the --reindex flag?

Yes, especially when starting or after making significant changes to your vault. It ensures the index is up-to-date.

What does the --watch flag do?

It monitors your vault for changes and automatically updates the index.

How can I debug the server?

Use the MCP Inspector for the best debugging experience. Follow the instructions in the README to launch it.