MCP Server for Obsidian

This repository hosts an MCP server designed to facilitate interaction with Obsidian via the Local REST API community plugin.

Components

Tools

The server provides several tools for Obsidian interaction:

• list_files_in_vault: Lists files and directories in the vault's root.
• list_files_in_dir: Lists files and directories in a specified directory.
• get_file_contents: Retrieves the content of a file.
• search: Searches for documents matching a text query.
• patch_content: Inserts content into a note relative to a heading, block reference, or frontmatter field.
• append_content: Appends content to a new or existing file.

Example prompts

Instruct Claude to use Obsidian first. Examples: summarize architecture call notes, search for Azure CosmosDb mentions, or summarize meeting notes and create an email-ready summary.

Configuration

The Obsidian REST API Key can be configured either in the server config or via a .env file.

Quickstart

Requires the Obsidian REST API plugin. Configuration details are provided for both development and published server setups within Claude Desktop.

Development

Building involves syncing dependencies and updating the lockfile using uv sync. Debugging is recommended using the MCP Inspector.