Obsidian — Claude Code MCP server: what it does, how to install
Connects AI assistants to an Obsidian vault via the Local REST API plugin for note reading, searching, and precise editing.
no license updated 2026-10-29
Open on GitHubWhat Obsidian does
This server bridges your AI agent and an Obsidian knowledge base using the community Local REST API plugin. It can inspect root directories, list files in specific folders, read note contents, run text searches across the vault, and remove files.
Writing tools support both appending to notes and precise modifications. Through patch_content, the model can insert text relative to a heading, a block reference, or a frontmatter property. Appending works on both existing and new files.
Obsidian must stay running with the REST plugin enabled. The server executes through uvx and depends on two parameters: OBSIDIAN_API_KEY and OBSIDIAN_HOST.
What it helps with
- search for matching text across the entire vault
- retrieve and summarize architecture meeting notes
- insert updates under a specific heading or frontmatter field
- append generated action items to an existing note
Example prompts for the agent
- Search Obsidian for notes mentioning Azure CosmosDb and explain their context
- Read the latest architecture discussion note and extract key decisions
- Summarize our meeting and save it as a new note named summary meeting.md
How to install Obsidian
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Obsidian
How do you install the Obsidian MCP server?
Enable the Local REST API community plugin inside Obsidian and copy your key. Then add uvx mcp-obsidian to your MCP configuration with OBSIDIAN_API_KEY and OBSIDIAN_HOST.
What capabilities does this server provide?
It grants file browsing, text search across the vault, note reading, file deletion, and targeted content patching.
Does it support targeted edits inside an existing note?
Yes, the patch_content tool allows inserting text relative to headings, block references, or frontmatter fields.