Skip to content
Conduit

mcp server

obsidian-bridge

Connect Cursor agents to your local Obsidian vault via Local REST API — MCP tools, setup skills, and vault-safety rules.

dkdottk/obsidian-bridgecommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-bridge"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 23, 2026

Obsidian Bridge

Connect Cursor agents to your local Obsidian vault — calmly, securely, and with production-grade tooling.

Obsidian Bridge is a Cursor Plugin that ships an MCP server for reading, writing, searching, patching, and organizing notes through the Obsidian Local REST API. Vault traffic stays on your machine; the API key never leaves Cursor Configure / your environment.

Highlights

  • Local-first MCP bridge (127.0.0.1:27124 by default)
  • Daily notes, search, tags, append/patch, open-in-Obsidian
  • Setup + note-writing skills, vault-safety rules, hub-and-spoke graph guidance
  • Typed TypeScript server, tests, and CI

Install (Cursor Marketplace)

  1. Install / enable Local REST API in Obsidian
    (obsidian://show-plugin?id=obsidian-local-rest-api) and copy the API key.
  2. Build once so the plugin ships the MCP binary:
npm install
npm run build
  1. In Cursor, add this GitHub repo as a marketplace:
    https://github.com/dkdottk/obsidian-bridge
    (prefer GitHub over file:// — Cursor’s sandbox blocks git ls-remote on the file protocol).
  2. Install Obsidian Bridge → Plugins → Configure → paste the API key.
  3. Ask Cursor: “Check Obsidian status.”

Defaults: https://127.0.0.1:27124.

Marketplace layout

.cursor-plugin/marketplace.json   ← required for Cursor marketplace import
plugins/obsidian-bridge/          ← the installable plugin
  .cursor-plugin/plugin.json
  mcp.json
  skills/ rules/ assets/ dist/

What the agent can do

  • Capture to daily notes
  • Create, append, and patch notes
  • Search the vault and browse tags
  • Open notes in the Obsidian UI
  • Run Obsidian commands when you explicitly ask
  • Keep vault graphs readable (hub-and-spoke / MOC linking)

Plugin components

PieceRole
MCP serverVault tools over Local REST API
obsidian-setup skillThree-step connect flow
obsidian-notes skillCapture / organize habits
obsidian-hub-spoke-graph skillIndex/hub/leaf linking rules
Vault safety + hub-spoke rulesAlways-on guardrails

Develop

npm install
npm run ci

Useful scripts:

  • npm run build — compile to dist/ and sync into the plugin
  • npm test — Vitest suite
  • npm run typecheck — max-strict TypeScript
  • npm run lint — ESLint

See docs/setup.md, docs/architecture.md, and docs/tools.md.

Security

Your API key stays in Cursor plugin variables / local environment. It is never committed and never logged. The bridge only calls a localhost endpoint you control. See SECURITY.md.

Author

Danylo Kravchenko · dkdottk@gmail.com

License

AGPL-3.0-only — free to use, study, modify, and share.

If you distribute a modified version, or run a modified version as a network service, you must offer the corresponding source under AGPL-3.0. See the LICENSE for full terms.

↑↓ navigate openesc close