Obsidian Sync MCP Server
by es617io.github.es617/obsidian-sync-mcpv0.5.2
Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install Obsidian Sync MCP server
No published package or hosted endpoint yet — see the repository README for build-from-source instructions.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| VAULT_PATH | — | — | Path to your Obsidian vault directory (filesystem mode) |
| COUCHDB_URL | — | — | CouchDB server URL (CouchDB mode) |
| COUCHDB_USER | — | — | CouchDB username |
| COUCHDB_PASSWORD | — | yes | CouchDB password (required in CouchDB mode) |
| COUCHDB_DATABASE | — | — | CouchDB database name |
| COUCHDB_PASSPHRASE | — | yes | LiveSync E2E encryption passphrase (must match plugin setting) |
| COUCHDB_OBFUSCATE_PROPERTIES | — | — | Set to 'true' if 'Obfuscate Properties' is enabled in LiveSync (obfuscates file paths, sizes, dates) |
| VAULT_NAME | — | — | Vault name for deep links and index storage |
| MCP_AUTH_TOKEN | — | yes | Password for OAuth authentication |
| BASE_URL | — | — | Public URL for OAuth callbacks (required when using a tunnel) |
| PORT | — | — | HTTP port |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-09 · 1d ago · GitHub
Latest release
2026-10-09 · 1d ago · GitHub · v0.9.0
Package published
no data · npm/PyPI
Registry entry updated
2026-03-30 · 6mo ago · official registry · v0.5.2
FAQ
›Does Obsidian Sync require an API key?
Yes. It expects COUCHDB_PASSWORD, COUCHDB_PASSPHRASE, MCP_AUTH_TOKEN, of which 3 are secrets.
›Can I use Obsidian Sync as a remote (hosted) MCP server?
Yes. It is a hosted MCP server; connect to its URL with any client that supports remote MCP.
›Is Obsidian Sync in the official MCP registry?
Yes, as io.github.es617/obsidian-sync-mcp.
Alternatives to Obsidian Sync
Other file system MCP servers.