obsidian-mcp-server

MCP.Pizza Chef: cyanheads

Fourteen tools cover reading notes, listing folders and tags, searching by plain text or ranked relevance, and making precise changes — adding text under one specific heading, replacing a single section, or updating one property at the top of a note. It reaches your vault through the Local REST API community plugin, which has to be installed and switched on, and you paste the key that plugin generates into your client. Version matters: plugin 4.0 through 5.x, and daily-note targets need 5.0.1 or earlier.

Notes
Writing

Use This MCP server To

Append today's meeting notes under one heading Search my vault and rank results by relevance Change a single property at the top of a note Replace one section of a long note only List every tag with how often it's used Open a note in the Obsidian app from chat

README

obsidian-mcp-server

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

14 Tools • 3 Resources

Version License Docker MCP SDK npm TypeScript Bun

Install in Claude Desktop Install in Cursor Install in VS Code

Framework


obsidian-mcp-server FAQ

Which apps does it work in?
There are one-click install buttons for Claude Desktop, Cursor and VS Code, and it runs anywhere else that accepts a standard MCP setup.
Do I need a key?
Yes. Install the Local REST API plugin in Obsidian, generate a key in its settings, and paste that into your client's configuration.
Does Obsidian have to be running?
Yes. The connection goes through a plugin inside Obsidian, so the app needs to be open on the same computer.
Can I use this to add a line to my daily note without touching the rest?
Yes — that is the whole point. It appends under a chosen heading rather than rewriting the file. Daily and weekly note targets need plugin version 5.0.1 or earlier.
How is this different from other Obsidian connectors?
It edits precisely — one heading, one section, one property — rather than only reading notes or replacing them wholesale, and it can run locally or over the web.
Can it delete notes?
Yes, and it asks you to confirm first in clients that support confirmation prompts.
How hard is setup?
Install the plugin, copy its key, then use an install button or paste a short settings block. Running from source needs Bun 1.3 or Node 24.
Why does the plugin version matter so much?
Newer plugin releases dropped the behaviour this server relies on for section-level edits, so stay within the versions the project lists.