Your Obsidian vaults, open to Claude.

What Claude can do with it

• Read & search — list and read notes with their frontmatter and tags, full-text search one vault or all of them at once, follow backlinks and outgoing links, and see the note you're currently editing.
• Write — create, append to, and edit notes; update frontmatter; rename or move notes with backlinks preserved; make folders; append to your daily note; and apply templates.
• Work across vaults — copy a note into another vault (or broadcast a template to all of them), and move notes between vaults.
• Deep links — get obsidian:// links that jump straight to a note, line, or heading.

Writing and command execution are on by default and can be switched off per vault.

How it works

A tiny Obsidian plugin runs a private, token-authenticated server on 127.0.0.1 inside each open vault. A Claude Desktop extension discovers those vaults and routes each request to the right one — so everything flows through Obsidian's live app.

The trade-off: a vault has to be open in Obsidian (with the plugin enabled) for Claude to reach it.

Install

1. Install the plugin into your vaults. Download and unzip the release, then from inside the folder:

# preview the vaults Obsidian knows about
./scripts/install.zsh --list
# install into all of them...
./scripts/install.zsh --all
# ...or name specific vaults
./scripts/install.zsh ~/Vaults/Personal ~/Vaults/Work

The bundle ships the prebuilt plugin — there's nothing to compile.

2. Enable it in Obsidian (once per vault). Open the vault → Settings → Community plugins. If prompted, turn on community plugins (accept Obsidian's trust prompt), then enable MCP Bridge. The bridge registers the vault automatically — no token to copy.

3. Install the Claude Desktop extension (once). Double-click obsidian-mcp-bridge.mcpb from the bundle (or add it via Settings → Extensions), leave the URL/token fields blank, and restart Claude Desktop.

Check it worked: ask Claude to list your Obsidian vaults. Only vaults open in Obsidian with the plugin enabled are reachable; when several are open, tell Claude which one by name.

Other platforms & manual install

No zsh (e.g. Windows)? Copy manifest.json, main.js, and styles.css from the bundle's plugin/ folder into <your-vault>/.obsidian/plugins/mcp-bridge/, enable MCP Bridge under Community plugins, then double-click the .mcpb for Claude Desktop.

What's new

0.4.1

• Maintenance only, with no functional changes: same plugin and same Claude Desktop extension as 0.4.0, re-published to verify the update path end to end. There is nothing to gain by upgrading from 0.4.0.

0.4.0

• The installer can turn the plugin on for you. Placing the files was never enough on its own: until a vault listed the plugin as approved, Obsidian never loaded it and Claude could not see that vault. Run ./scripts/install.zsh --all --enable and it writes that approval for each vault, so you can skip the per-vault toggle. uninstall.zsh reverses it.
• Your vault list stays accurate. Each vault now refreshes its registration about once a minute, and reclaims its port from any leftover entry, so a vault that crashed or was force quit no longer lingers in the list or collides with a vault that starts later.
• A registry health check. ./scripts/health-check.zsh reports every registered vault, and with --fix clears out the entries left behind by vaults that are gone. A vault that is simply slow to load is reported as busy and left alone, so a cleanup never unregisters one that is still running.
• Optional nested-vault detection. If you ever open a sync folder that contains vaults as though it were a vault itself (the iCloud Obsidian folder is the usual way this happens), the bridge can leave those notes to the vaults that own them instead of serving everything twice. Off by default; turn it on in the plugin settings.
• Clearer setup: a step-by-step install guide, and the scripts now check for Node 18+ only where they actually need it.

0.2.0

• One server, many vaults: multi-vault support with automatic discovery, plus tools for copying and moving notes between vaults.
• Note and folder management, and obsidian:// deep links back into the app.
• Install and uninstall scripts.

Full history, including the smaller maintenance releases, is on the releases page.

What's in each release

• obsidian-mcp-bridge.zip — everything you need: the prebuilt plugin, the Claude Desktop extension, and the install scripts. Start here.
• obsidian-mcp-bridge.mcpb — just the Claude Desktop extension on its own, for re-installing that half.

Builds are published automatically from the source project — see all releases.