MCP server for Obsidian logo

MCP server for Obsidian

by MarkusPfundstein

MCP server to interact with Obsidian via the Local REST API community plugin. It allows you to control and query your Obsidian vault from other applications.

View on GitHub

Last updated: N/A

What is MCP server for Obsidian?

The MCP server for Obsidian is a tool that enables interaction with an Obsidian vault using the Local REST API plugin. It provides a set of tools to list files, retrieve content, search, and modify notes within Obsidian.

How to use MCP server for Obsidian?

  1. Install and configure the Obsidian REST API community plugin.
  2. Configure the MCP server with the Obsidian API key, either in the server config or a .env file.
  3. Configure Claude Desktop to use the MCP server.
  4. Use example prompts to instruct Claude to interact with Obsidian using the available tools.

Key features of MCP server for Obsidian

  • List files and directories

  • Retrieve file contents

  • Search for documents

  • Insert content into existing notes

  • Append content to files

  • Delete files and directories

Use cases of MCP server for Obsidian

  • Summarizing meeting notes

  • Searching for specific information across all notes

  • Automating note creation and modification

  • Integrating Obsidian with other applications

  • Generating reports from Obsidian content

FAQ from MCP server for Obsidian

How do I find my Obsidian API key?

The API key can be found in the Obsidian REST API plugin configuration settings.

How do I configure the MCP server with the API key?

You can configure the server either by adding it to the server config or creating a .env file in the working directory.

What is the Obsidian REST API plugin?

It is a community plugin that exposes Obsidian functionality through a REST API, allowing external applications to interact with the vault.

Where can I find the Claude Desktop configuration file?

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%/Claude/claude_desktop_config.json

How can I debug the MCP server?

The recommended way to debug is using the MCP Inspector. You can launch it using npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian.