Obsidian MCP
β Text source-checked Oct 22, 2026A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.
Source-checked against the vendor's site Β· rebuilt from the vendor's own pagesProfile updated Link checked How we rate
In short
Obsidian MCP is a free, local server enabling AI assistants to safely read and modify configured Obsidian vaults without opening the app.
Obsidian MCP is a local Model Context Protocol server that allows MCP-compatible assistants to safely read and modify explicitly configured Obsidian vaults. The server works directly with Markdown files, so the Obsidian application does not need to be open for it to function. Version 2 of the server supports both MCP 2026-07-28 and 2025-era clients by default and requires Node.js 22 or newer to run.
The vendor says that the server operates locally and never listens on a network interface or sends telemetry. Users can configure up to ten vaults for the server to access. File mutations are journaled, conflict-checked, atomically replaced, and rolled back as a single transaction.
Because MCP clients can invoke destructive tools, the documentation advises users to back up important vaults and review client permission prompts. Legacy protocol and v1 positional-path compatibility are deprecated and print exact migration instructions to stderr.
According to Obsidian MCP: Obsidian MCP is a local Model Context Protocol server that allows MCP-compatible assistants to safely read and modify explicitly configured Obsidian vaults. Its pages list this strength: The server runs locally without listening on a network interface or sending telemetry. They also state this limitation: The server requires Node.js 22 or newer to run.
β The AI Tool Bible editorial team
Pros
- β The server runs locally without listening on a network interface or sending telemetry.
- β File mutations are journaled, conflict-checked, atomically replaced, and rolled back as a single transaction.
- β The vendor says that all tool schemas are strict JSON Schema 2020-12 contracts generated from Zod.
- β The server works directly with Markdown files, so the Obsidian application does not need to be running.
Cons
- β οΈ The server requires Node.js 22 or newer to run.
Facts
- Pricing
- free - Free and open-source (MIT). No paid tiers; users only pay for their own Obsidian license if they choose Commercial/Sync/Publish add-ons. (not source-checked)
- Open source
- Yes (license: MIT) (not source-checked)
- GitHub stars
- 747 (checked Oct 29, 2026) (not source-checked)
- Last GitHub push
- Oct 8, 2026 (not source-checked)
- First commit
- Dec 2024 (not source-checked)
- Package downloads (30 d)
- 13,558 Β· npm obsidian-mcp Β· checked Oct 17, 2026 (not source-checked)
Where this tool sits
Use cases
Frequently asked
- Is Obsidian MCP free to use?
- Yes, it is free and open-source under the MIT license. There are no paid tiers, though users may pay for optional Obsidian add-ons like Sync or Publish separately.
- Do I need the Obsidian app open to use it?
- No, the server works directly with Markdown files. The Obsidian application does not need to be open for the MCP server to function and access your vaults.
- What are the system requirements?
- You need Node.js 22 or newer to run the server. It supports both MCP 2026-07-28 and 2025-era clients by default, ensuring compatibility with modern MCP-compatible assistants.
- Is my data sent to the cloud?
- No, the server operates locally and never listens on a network interface or sends telemetry. It ensures your data remains on your machine while allowing safe, journaled file mutations.
- How many vaults can I configure?
- Users can configure up to ten vaults for the server to access. File mutations are journaled, conflict-checked, and rolled back as a single transaction to ensure safety.