Obsidian Integration MCP Server

Knowledge & MemoryPython

Interact with your Obsidian vault through Claude

Available Tools

list_files_in_vault

Lists all files and directories in the root directory of your Obsidian vault

list_files_in_dir

Lists all files and directories in a specific Obsidian directory

get_file_contents

Return the content of a single file in your vault

search

Search for documents matching a specified text query across all files in the vault

patch_content

Insert content into an existing note relative to a heading, block reference, or frontmatter field

append_content

Append content to a new or existing file in the vault

delete_file

Delete a file or directory from your vault

This MCP server enables seamless integration between Claude and your Obsidian knowledge base. It leverages the Obsidian Local REST API community plugin to allow Claude to read, search, and modify files in your vault. With this integration, you can have Claude analyze your notes, create summaries, append new content, and help organize your knowledge base.

Overview

The Obsidian Integration MCP allows Claude to interact directly with your Obsidian vault, enabling powerful knowledge management workflows. This integration bridges the gap between Claude's analytical capabilities and your personal knowledge base.

Prerequisites

Before using this MCP, you need to:

Have Obsidian installed on your computer
Install and enable the "Local REST API" community plugin in Obsidian
- Search for "Local REST API" in the Obsidian community plugins section
- Enable the plugin and copy your API key from the plugin settings

Installation

Step 1: Install the MCP

You can install the Obsidian Integration MCP using the uvx package manager:

uvx install mcp-obsidian

Step 2: Configure Claude Desktop

Add the following configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your_api_key_here",
        "OBSIDIAN_HOST": "your_obsidian_host"
      }
    }
  }
}

Replace your_api_key_here with the API key from the Obsidian Local REST API plugin settings. The default host is http://localhost:27123 but you can change it if needed.

Alternatively, you can create a .env file in your working directory with these variables:

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

Usage

Once installed, you can instruct Claude to interact with your Obsidian vault. Here are some example prompts:

"Get the contents of my 'Project Ideas.md' note and summarize the key points"
"Search my vault for all references to 'machine learning' and create a summary"
"Create a new note called 'Meeting Summary.md' with a summary of our discussion"
"Find my latest meeting notes and extract the action items"

Troubleshooting

If you encounter issues:

Ensure the Obsidian Local REST API plugin is enabled and properly configured
Verify your API key is correctly set in the Claude Desktop configuration
Make sure Obsidian is running when you try to use the MCP
Check the server logs with: tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log

For more detailed debugging, you can use the MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian