mcp server

Obsidian

Reads, searches and edits notes in an Obsidian vault through the Local REST API plugin.

MarkusPfundstein/mcp-obsidianlistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
Obsidian desktop with the Local REST API community plugin enabled
Python 3.11+

~/Library/Application Support/Claude/claude_desktop_config.json

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

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

Tools provided

As listed by the project. Your agent asks before calling them, depending on its settings.

list_files_in_vaultList vault files
get_file_contentsRead a note
searchSearch the vault
patch_contentPatch a note
append_contentAppend to a note
delete_fileDelete a file

README

synced Oct 13, 2026

Obsidian

Reads, searches and edits notes in an Obsidian vault through the Local REST API plugin.

Install

uvx mcp-obsidian

Configuration

Variable	Required	Description
`OBSIDIAN_API_KEY`	Yes	API key from the Obsidian Local REST API plugin
`OBSIDIAN_HOST`	No	Host of the REST API (default 127.0.0.1)
`OBSIDIAN_PORT`	No	Port of the REST API (default 27124)

Tools

list_files_in_vault — List vault files
get_file_contents — Read a note
search — Search the vault
patch_content — Patch a note
append_content — Append to a note
delete_file — Delete a file

About this listing

Details were gathered from the project's public pages on 2026-10-13 and have not been reviewed by a person yet. Read the project's own documentation before giving it access to anything sensitive.

Sources: