Design Engineer Logo
Visit Repo
Open Graph preview

MCP Obsidian Server

MCP server that interacts with Obsidian via the Obsidian rest API community plugin

Site favicon
💡 Knowledge Base

Overview

mcp-obsidian

Description:
Server that enables direct interaction with Obsidian vault through REST API integration

Category: Note-Taking & Knowledge Management

Overview: This server implementation provides comprehensive tools for managing and interacting with Obsidian vaults, featuring:

  • File listing across vault and directories
  • Content retrieval and search functionality
  • Content modification capabilities (patching and appending)
  • Integration with Obsidian's Local REST API

Key Features:

  • List vault files and directories
  • Search across vault contents
  • Get specific file contents
  • Patch content with heading/block reference support
  • Append content to new/existing files

Prerequisites:

  • Obsidian REST API community plugin
  • Valid API key from plugin settings

Configuration:

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": ["mcp-obsidian"],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>"
    }
  }
}

Installation Path:

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

Debugging:

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

Log Monitoring:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log