Skip to main content
πŸ“– The AI Tool Bible
Obsidian MCP logo

Obsidian MCP

βœ“ Text source-checked Oct 22, 2026

A 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

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)MCP Servers

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.

From the vendor's pages

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

Reading notes and retrieving their SHA-256 etagsCreating new notes atomically without overwriting existing contentSearching vault content, filenames, or tagsAdding tags to notes

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.

Compare Obsidian MCP with similar tools

All alternatives β†’

Explore related

Reviews