Jason Epel

← AI Projects

Applications

Obsidian ↔ Claude MCP Bridge

MCP integration

obsidian-claude-mcp.epel.us

What it does

  • Designed and shipped a two-component TypeScript system that gives Claude Desktop live read and write access across one or many Obsidian vaults — working through Obsidian's running app, so Claude sees the real search index, backlinks, and metadata rather than raw files on disk.
  • Built an esbuild-bundled Obsidian community plugin that runs a token-authenticated localhost server per vault, paired with a stdio MCP server that auto-discovers open vaults and exposes tools spanning read, search, write, cross-vault copy and move, and deep links.
  • Engineered for safety and easy setup: localhost-only binding with constant-time token auth and per-vault read-only toggles, packaged as a free macOS and Linux download with idempotent install scripts and tagged GitHub Actions releases.

Keyboard shortcuts

The page has three zones: Pages (the top bar), On this page (the list beside Experience and Skills) and Content. The zone you are in is outlined.

← →
In Pages: previous or next page. In Content: the card or section to the left or right; at the left edge, ← goes back to the “On this page” list.
↓ ↑
From Pages, ↓ enters the page. Then move through the list or the content; → goes from the list into its section.
Enter
Open the highlighted item, or open/close a role (Space also opens or closes a highlighted role). In a card with several links, the arrows reach each link.
Esc
On a project page: back to the projects, with its card highlighted. Elsewhere: back one zone (Content, then On this page, then Pages); twice quickly: back to the top.
Mouse
The arrows start in the zone and at the item under the pointer.
?
Show this list (or use the ? button at the bottom left). Esc closes it.