obsidian-sync-mcp

<!-- mcp-name: io.github.es617/obsidian-sync-mcp -->

Give any AI agent remote read/write access to your Obsidian vault over MCP. Run it locally from your machine, or deploy it to the cloud so it works even when your laptop is off.

> Example: From your phone, ask your AI: "What's in my daily note for today?" — and get the full content back, with a link to open it in Obsidian.

---

The server has two modes:

• Local mode — reads .md files directly from your vault folder. No database needed.
• Remote mode — reads from CouchDB via Self-hosted LiveSync, the community plugin that replaces iCloud/Obsidian Sync with a CouchDB backend (600k+ downloads). The server uses livesync-commonlib — the same library that powers the plugin — for proper chunk handling and E2E encryption support.

Both modes expose the same MCP tools over HTTP, so any MCP-compatible agent can connect: Claude, Copilot, custom agents, anything that speaks the Model Context Protocol.

---

| You have... | Do this | What happens | |---|---|---| | LiveSync already | Point MCP server at your CouchDB | Add AI access to your existing setup | | A Mac that's always on | Run in local mode + tunnel | Reads files directly, no database | | Nothing yet, want it always on | Deploy to Fly.io | CouchDB + MCP server in the cloud |

---

If you're already using Self-hosted LiveSync, you just need the MCP server. No database setup, no plugin changes — point it at your existing CouchDB.

npx obsidian-sync-mcp