obsidian-mcp-server
Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.
What can you do with obsidian-mcp-server?
- Typed client for the Obsidian Local REST API plugin; section writes speak markdown-patch 2.0 to plugin v5.0 and later and 1.x to v4.x, chosen from the reported plugin version
- Regex inputs are capped (nameRegex at 256 chars, useRegex at 1024) and rejected with regexunsafe` when they nest quantifiers
- Recovery-guided errors: every declared failure carries a reason, a JSON-RPC code, and a recovery.hint written for that case
- Size deltas: every mutating tool returns previousSizeInBytes / currentSizeInBytes, so a caller can spot an accidental clobber without a follow-up read
- Ambiguity surfaced as data: shared heading names return candidates, and tag operations report applied vs. skipped
- Discriminated output contracts: format on obsidiangetnote, mode on obsidiansearchnotes, operation on obsidianmanagefrontmatter and obsidianmanagetags
Features as listed in the project's README, checked 16 Nov 2026.
About obsidian-mcp-server
Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP. Your Obsidian vault, through the Local REST API plugin. Read, search, and write notes, edit a single heading, block, or frontmatter field in place, and manage tags, with folder-scoped read/write permissions built in.
Opening text of the project's README, checked 16 Nov 2026.
Install
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": [
"-y",
"obsidian-mcp-server"
],
"env": {
"OBSIDIAN_API_KEY": "<your OBSIDIAN_API_KEY>"
}
}
}
}Config as documented in its source, checked 16 Nov 2026. Placeholders such as API keys are the project's own: replace them with your values.
Requirements listed
- The Obsidian Local REST API plugin, v4.0.0 or later, enabled in your vault. Its API key is OBSIDIANAPIKEY.
- Periodic-note targets work natively on plugin v5.0.1 and earlier. From v5.0.2 they need the periodic-notes API extension; without it they fail with periodicunsupported`.
Setup documented for
Tools (14)
| obsidian_get_note | Read a note as raw content, full structured form, document map, or a single section |
| obsidian_list_notes | List notes and folders under a vault path, recursively, with extension and name filters |
| obsidian_list_tags | List vault tags with usage counts, most-used first |
| obsidian_search_notes | Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable and reads are unscoped |
| obsidian_write_note | Create a note, replace one section, or overwrite a whole file with overwrite: true |
| obsidian_append_to_note | Append to a note (creating it if missing) or to one heading, block, or frontmatter field |
| obsidian_patch_note | Append, prepend, or replace against one heading, block reference, or frontmatter field |
| obsidian_replace_in_note | Literal or regex search-replace inside one note, body-only by default |
| obsidian_manage_frontmatter | Get, set, or delete one frontmatter key |
| obsidian_manage_tags | Add, remove, or list a note's tags in frontmatter, inline, or both |
| obsidian_delete_note | Permanently delete a note, optionally after the user confirms (OBSIDIANDELETEELICITATION) |
| obsidian_open_in_ui | Open a file in the Obsidian app, optionally in a new pane |
| obsidian_list_commands | List command-palette commands (opt-in via OBSIDIANENABLECOMMANDS) |
| obsidian_execute_command | Run a command-palette command by ID (opt-in via OBSIDIANENABLECOMMANDS) |
Tool names from the README, checked 16 Nov 2026.
obsidian-mcp-server compared with other Obsidian servers
| Server | Licence | Tools | Last commit | Stars |
|---|---|---|---|---|
| obsidian-mcp-server | Apache-2.0 | 14 | 11 Nov 2026 | 706 |
| obsidian-mcp | MIT | 12 | 8 Oct 2026 | 751 |
Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.
Verified facts
- Maintainer
- cyanheads
Source · checked 16 Nov 2026
- Licence
- Apache-2.0
Source · checked 16 Nov 2026
- Transport
- stdio
- streamable-http
Source · checked 16 Nov 2026
- Required settings
- Environment variables: OBSIDIAN_API_KEY
Source · checked 16 Nov 2026
- Setup documented for
- Claude Code
Source · checked 16 Nov 2026
- Repository
- github.com/cyanheads/obsidian-mcp-server
Source · checked 16 Nov 2026
- Package
- obsidian-mcp-server (npm)
Source · checked 16 Nov 2026
- Latest version
- 3.9.0
Source · checked 16 Nov 2026
- Last commit
- 11 Nov 2026
Source · checked 16 Nov 2026
- GitHub stars
- 706
Source · checked 16 Nov 2026
- Open issues
- 16
Source · checked 16 Nov 2026
Each value links to where it was found and shows the date it was checked. How we verify
Frequently asked questions
What does obsidian-mcp-server do?
Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.
Which MCP clients does obsidian-mcp-server document setup for?
Its README documents setup for Claude Code.
How do I install obsidian-mcp-server?
Add the install config shown on this page to your MCP client's configuration; the package is obsidian-mcp-server (npm). Check the README for client-specific steps.
What licence is obsidian-mcp-server under?
Apache-2.0, as reported by the repository on 16 Nov 2026.
Is obsidian-mcp-server still maintained?
The last commit was on 11 Nov 2026, and the repository had 16 open issues.
What settings does obsidian-mcp-server need?
Environment variables: OBSIDIAN_API_KEY.
What tools does obsidian-mcp-server expose?
14 tools: obsidian_get_note, obsidian_list_notes, obsidian_list_tags, obsidian_search_notes, obsidian_write_note, obsidian_append_to_note, obsidian_patch_note, obsidian_replace_in_note, obsidian_manage_frontmatter, obsidian_manage_tags, obsidian_delete_note, obsidian_open_in_ui, and more.
