ObsidianMCPServer

Connect your AI assistant to Obsidian! This Model Context Protocol (MCP) server enables Claude, Cursor, and other AI tools to read, write, search, and manage your Obsidian notes through the Local REST API.

🚀 Quick Setup

1. Install Obsidian Plugin

1. Install "Local REST API" from Community Plugins in Obsidian
2. Set an API key in plugin settings
3. Start the server using Command Palette: "Local REST API: Start"
4. Note the URL: http://127.0.0.1:27123 (default)

2. Install ObsidianMCPServer

Option A: Install from source code directly

git clone https://github.com/otaviocc/ObsidianMCPServer.git
cd ObsidianMCPServer
swift build -c release

# The executable will be at: .build/release/ObsidianMCPServer

Option B: Install via Brew 🤩

brew tap otaviocc/mcp
brew install obsidian-mcp-server

# The executable will be at: `/opt/homebrew/bin/obsidian-mcp-server`

Option C: Install via Mint

mint install otaviocc/ObsidianMCPServer

# The executable will be at: `$HOME/.mint/bin/ObsidianMCPServer`

3. Configure Your AI Tool

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian": {
      "command": "/path/to/ObsidianMCPServer",
      "env": {
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor: Add the same configuration in Settings → Tools & Integration

Replace /path/to/ObsidianMCPServer with your actual path:

• Source build: .build/release/ObsidianMCPServer (from your build directory)
• Brew install: /opt/homebrew/bin/obsidian-mcp-server
• Mint install: $HOME/.mint/bin/ObsidianMCPServer

Also replace your-api-key-here with your plugin's API key.

🛠️ Available Features

Tools

Server: Basic server identification and connection information for the Obsidian MCP interface.

• getServerInfo(): Get Obsidian server details

Active Note: Operations for working with the currently open note in Obsidian's interface, providing direct access to read, modify, and manage the active document and its metadata.

• getActiveNote(): Get currently active note
• updateActiveNote(content): Replace active note content
• deleteActiveNote(): Delete active note
• setActiveNoteFrontmatterString(key, value): Set frontmatter string field
• appendToActiveNoteFrontmatterString(key, value): Append to frontmatter string field
• setActiveNoteFrontmatterArray(key, values): Set frontmatter array field
• appendToActiveNoteFrontmatterArray(key, values): Append to frontmatter array field

Vault Note: File operations for any note in the vault by filename, enabling programmatic access to create, read, update, delete notes and manage their frontmatter throughout the entire vault structure.

• getNote(filename): Get any note by filename
• createOrUpdateNote(filename, content): Create or update a note
• appendToNote(filename, content): Append content to a note
• deleteNote(filename): Delete specific note
• setNoteFrontmatterString(filename, key, value): Set frontmatter string field
• appendToNoteFrontmatterString(filename, key, value): Append to frontmatter string field
• setNoteFrontmatterArray(filename, key, values): Set frontmatter array field
• appendToNoteFrontmatterArray(filename, key, values): Append to frontmatter array field

**Dir

... View full README on GitHub