Obsidian MCP Server
obsidian-mcp-server
An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags
- 700 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Reads and modifies notes in the local vault
- Uses an Obsidian access key
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/obsidian-mcp-serverDetects 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 modifies notes in the local vault
- Uses an Obsidian access key
This is third-party code. Review the repository files before installing.
What it does
The server connects to Obsidian through the Local REST API plugin and gives an agent tools for the vault. It reads a note whole, by section or as a structure map, lists folders and searches by text, JSONLogic expressions or Omnisearch. Edits can be precise: append to a section, replace a block under a heading, change one frontmatter field, search and replace inside a note or manage tags. Deletion always asks the user to confirm, and read and write access can be limited to specific folders.
Who it is for. For people who keep a knowledge base in Obsidian and want an agent to read and carefully update notes.
Good fit when
- You need to find and gather information from vault notes
- You need to append to a daily note or section without touching the rest
- You need to adjust tags or frontmatter fields in bulk
Not a fit when
- Obsidian is not running or the Local REST API plugin cannot be installed
- The vault exists only in the cloud without the desktop app
Example request
Find Obsidian notes tagged project and append the open tasks to today's daily noteMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
OBSIDIAN_API_KEYrequired, secret- API key from the Obsidian Local REST API plugin
OBSIDIAN_BASE_URL- Plugin URL, defaults to http://127.0.0.1:27123
MCP_TRANSPORT_TYPE- Transport: stdio or http
OBSIDIAN_ENABLE_COMMANDS- Enables the Obsidian command tools
Limitations
Requires a running Obsidian with the Local REST API plugin 4.x or 5.x; 6.0 is incompatible. Needs Bun 1.4+ or Node.js 24+. Periodic notes on plugin 5.0.2+ need a separate extension. Deletion works only in clients that support confirmation requests. Obsidian command execution is off by default.
How to disable. Remove the obsidian-mcp-server block from the MCP client config and optionally disable the Local REST API plugin in Obsidian.
FAQ
Where do I get the key?
In Obsidian: Settings, Community Plugins, Local REST API, which generates the key for OBSIDIAN_API_KEY.
Can access be restricted?
Yes, read and write access can be scoped to folders via environment variables, and command execution is opt-in.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for an Obsidian vault via the Local REST API plugin: search, read, append and patch notes
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 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
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
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
README in short
The README lists the server's tools and resources and describes each tool's behavior in detail. It gives configs for bunx, npx and Docker, a Streamable HTTP mode and version requirements for the Local REST API plugin. A settings table covers the plugin URL, key and access limits. Apache 2.0 licensed.