obsidian-mcp
A simple MCP server for Obsidian
What can you do with obsidian-mcp?
- obsidian_list_vaults — List configured vault ids without exposing host paths.
- obsidian_read_note — Read a bounded page of a note and return its SHA-256 etag.
- obsidian_create_note — Atomically create a note without overwriting.
- obsidian_edit_note — Append, prepend, or replace exact note content.
- obsidian_delete_note — Move a note to MCP trash or permanently delete it with explicit confirmation.
- obsidian_move_note — Move or rename a note and update unambiguous backlinks transactionally.
Tool descriptions from the project's README, checked 16 Nov 2026.
About obsidian-mcp
A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults. Version 2 supports both MCP 2026-07-28 and 2025-era clients by default, and requires Node.js 22 or newer. It works directly with Markdown files, so Obsidian does not need to be open. Legacy protocol and v1 positional-path compatibility are deprecated and print exact migration instructions to stderr.
Opening text of the project's README, checked 16 Nov 2026.
Install
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": [
"-y",
"obsidian-mcp@2",
"serve",
"--vault",
"notes=/absolute/path/to/vault"
]
}
}
}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.
Tools (12)
| obsidian_list_vaults | List configured vault ids without exposing host paths. |
| obsidian_read_note | Read a bounded page of a note and return its SHA-256 etag. |
| obsidian_create_note | Atomically create a note without overwriting. |
| obsidian_edit_note | Append, prepend, or replace exact note content. |
| obsidian_delete_note | Move a note to MCP trash or permanently delete it with explicit confirmation. |
| obsidian_move_note | Move or rename a note and update unambiguous backlinks transactionally. |
| obsidian_create_directory | Transactionally create a directory inside a vault. |
| obsidian_search_vault | Search content, filenames, or tags with bounded cursor pagination. |
| obsidian_add_tags | Add tags to one or more notes atomically. |
| obsidian_remove_tags | Remove exact, nested, or wildcard-selected tags atomically. |
| obsidian_rename_tag | Rename a tag across the vault atomically. |
| obsidian_manage_tags | Unified add/remove tag workflow using the same implementation. |
Tool names from the README, checked 16 Nov 2026.
obsidian-mcp compared with other Obsidian servers
| Server | Licence | Tools | Last commit | Stars |
|---|---|---|---|---|
| obsidian-mcp | MIT | 12 | 8 Oct 2026 | 751 |
| obsidian-mcp-server | Apache-2.0 | 14 | 11 Nov 2026 | 706 |
Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.
Verified facts
- Maintainer
- StevenStavrakis
Source · checked 16 Nov 2026
- Licence
- MIT
Source · checked 16 Nov 2026
- Repository
- github.com/StevenStavrakis/obsidian-mcp
Source · checked 16 Nov 2026
- Last commit
- 8 Oct 2026
Source · checked 16 Nov 2026
- GitHub stars
- 751
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 do?
A simple MCP server for Obsidian
How do I install obsidian-mcp?
Add the install config shown on this page to your MCP client's configuration. Check the README for client-specific steps.
What licence is obsidian-mcp under?
MIT, as reported by the repository on 16 Nov 2026.
Is obsidian-mcp still maintained?
The last commit was on 8 Oct 2026, and the repository had 16 open issues.
What tools does obsidian-mcp expose?
12 tools: obsidian_list_vaults, obsidian_read_note, obsidian_create_note, obsidian_edit_note, obsidian_delete_note, obsidian_move_note, obsidian_create_directory, obsidian_search_vault, obsidian_add_tags, obsidian_remove_tags, obsidian_rename_tag, obsidian_manage_tags.
