Your Obsidian vaults, open to Claude.
A custom-built bridge that gives Claude Desktop live read and write access to your Obsidian vaults — one or many. Claude works through Obsidian's own search index, backlinks, and metadata, not just the files on disk, and a single install reaches every vault you have open at once.
Free · macOS & Linux · needs Obsidian and Claude Desktop
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/WorkThe 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 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.