Overview Python MCP server that lets an MCP client such as Claude Desktop list, read, search, append to, patch and delete notes in an Obsidian vault. It talks to Obsidian through the Local REST API community plugin, using an API key plus host and port (defaults 127.0.0.1 and 27124). It runs over stdio via uvx, uv, or a Docker Compose service.
Who it is for: Obsidian users who want Claude or other MCP clients to work with their vault
Strengths Seven tools: list, read, search, append, patch, delete files and directories Runs via uvx with no clone, or through a provided Docker Compose file Patch inserts relative to a heading, block reference or frontmatter field MIT licensed, small Python codebase Weaknesses Requires Obsidian running with the Local REST API plugin enabled Pinned to mcp 1.x; mcp 2.0 crashes at import Search is a plain text query; no semantic or embedding search delete_file can remove files or directories, so client permissions need care What it needs no GPU Docker + Compose Needs Obsidian, obsidian-local-rest-api plugin, Python >= 3.11, uv Also in MCP servers Rank Project Score 1 servers Reference MCP servers for files, git, fetch, memory and time 94 out of 100 score 2 xiaohongshu-mcp MCP server that lets AI clients post, search and comment on Xiaohongshu 87 out of 100 score 3 apify-mcp-server Official MCP server exposing Apify Store Actors as tools for web scraping 87 out of 100 score # 4ha-mcp MCP server that lets AI assistants configure and control Home Assistant 85 out of 100 score # 5excel-mcp-server MCP server that lets AI clients create and edit Excel files without Excel 75 out of 100 score
How to choose Check what it can write or delete, not only what it reads. Prefer servers that scope credentials per tool or per user. See whether it runs locally (stdio) or as a remote server you have to secure. Health
Releases No GitHub releases
Top contributor 77% of commits10 of 13 in the last 12 months
Security advisories NoneOn GitHub, in the last 12 months
OpenSSF Scorecard Not checked Read from GitHub, deps.dev and OpenSSF on 12 Nov 2026. Bots and coding-agent accounts are left out of the commit counts. Not part of the score: how we check .
License in plain words MIT Permissive
Use it at work Yes
Change it and rebrand it Yes
Sell it or host it for others Yes Your part: Keep the copyright and license notice in copies you ship.
A plain summary, not legal advice. Read the license on GitHub ↗ (opens in a new tab)
Set it up Needs before it works: Obsidian, obsidian-local-rest-api plugin, Python >= 3.11, uv.
Bring in an engineer who knows mcp-obsidian . By the hour for upkeep and fixes, or a fixed price for a build. Our own engineering service; it never changes a rank.
Where to run it Referral links: if you sign up through one, we get a commission. They never change a rank.
Ask your AI assistant The rankings as an MCP server for Claude, Cursor, ChatGPT and any MCP client. Free, no key, read-only.
Setup for other apps → Claude Code claude mcp add archestack -- npx -y @archestack/mcpCopy
Connector URL https://mcp.archestack.com/mcpCopy
Then ask: Compare mcp-obsidian with its top alternatives on Archestack
Share this rank #17 of 18 in MCP servers on Archestack, as of 12 Nov 2026.
Show it in your README or on your site The badge below goes in a README; a card with the rank, score and signals goes on a site or blog. Both update twice a day.
Copy for README Copy for your site
Show code README (Markdown)
[](https://archestack.com/best-of-ai/projects/mcp-obsidian/)Site or blog (HTML)
<iframe src="https://archestack.com/embed/best-of-ai/mcp-obsidian/" title="mcp-obsidian on Archestack" width="400" height="270" style="border:0;max-width:100%" loading="lazy"></iframe>How badges work Preview the card
Best of Open-Source AI on GitHub Each review comes from the project's README and facts we check on GitHub. The fix form opens with mcp-obsidian filled in.