mcp-obsidian
An MCP server for an Obsidian vault via the Local REST API plugin: search, read, append and patch notes
- 4,507 ★ on the repository
- Last commit
- MIT
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-obsidianDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads and edits notes and can delete vault files
This is third-party code. Review the repository files before installing.
What it does
The server talks to Obsidian through the community Local REST API plugin and gives the agent access to the vault. The agent lists files at the root and in folders, reads notes and searches text across the vault. It can append to new or existing notes, insert content relative to a heading, block or frontmatter field, and delete files. It runs via uvx or Docker.
Who it is for. For people who keep notes in Obsidian and want to work with them through an agent.
Good fit when
- You need to find where a topic appears in your notes and summarize the context
- You need meeting takeaways written into a new note
- You need to add a section under a specific heading of an existing note
Not a fit when
- Obsidian is not running or the Local REST API plugin cannot be installed
- The vault holds data the agent must not be able to delete
Example request
Find Obsidian notes that mention CosmosDB and explain the contextMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
OBSIDIAN_API_KEYrequired, secret- Local REST API plugin key
OBSIDIAN_HOST- Obsidian host, default 127.0.0.1
OBSIDIAN_PORT- Plugin port, default 27124
Limitations
Works only while Obsidian runs with the Local REST API plugin enabled and its key set. Needs Python 3.11 or newer and is incompatible with mcp SDK 2.0. The delete tool has no confirmation of its own.
How to disable. Remove the mcp-obsidian block from the MCP config and optionally disable the Local REST API plugin.
FAQ
Where do I get the API key?
In the Local REST API plugin settings inside Obsidian.
Why can't Claude find uvx?
Put the full uvx path in the config; which uvx prints it.
Discussion
No questions or reviews yet.
Related
MCP serversObsidian MCP Server
obsidian-mcp-server
An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags
Obsidian MCP
obsidian-mcp
A local MCP server for Obsidian vaults: reads and edits explicitly configured folders of Markdown files, Obsidian need not be open
A local MCP server for safe read, search and edit of notes in an Obsidian vault, restricted to the vault root
Obsidian plugin with a REST API and a built-in MCP server: an agent reads, searches and surgically edits vault notes from Claude Code or Cursor
Obsidian MCP Plugin
obsidian-mcp-plugin
An Obsidian plugin: an MCP server runs inside Obsidian with eight tools for the vault, search and graph. Installed through the plugin catalog or .mcpb
Minutes
minutes
A local-first MCP server for meeting memory: on-device recording and transcription into Markdown, searchable from Claude Code, Codex, Cursor and any MCP client
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| mcp-obsidian (this entry) | no | API key | 4,507 | |
| Obsidian MCP Server | no | API key | 700 | search and edit |
| Obsidian MCP Plugin | no | API key | 467 | the MCP server runs inside a running Obsidian |
| Obsidian MCP | no | not required | 747 | a local server for chosen folders of an Obsidian vault |
README in short
The README lists the server tools and gives example prompts. It states the Python and mcp SDK version requirements and two ways to pass the API key: via config or a .env file. It includes Claude Desktop configs, a Docker setup and debugging tips with MCP Inspector. MIT licensed.