Obsidian Sync Mcp
Connects Claude or any MCP client to your Obsidian vault with eight tools for reading, writing, editing, moving, and deleting notes, plus listing folders, tags, and backlinks. Runs in filesystem mode against local markdown files or CouchDB mode with Self-hosted LiveSync for always-on cloud access. Deploy it on Fly.io with the included setup script for about $2-4/month, or run it locally with npx. Every response includes an Obsidian deep link so you can jump straight from Claude's answer into the note on Mac or iOS. Built-in OAuth provider handles authentication when you expose it over HTTPS.
- GitHub stars
- 21
- tools
- 10
- auth
- Secret needed
- transport
- HTTP
- env vars
- 11
- last updated
- Mar 30, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
read_noteRead a note's markdown content by path
Read a note's markdown content by path
No parameter schema in public metadata yet.
write_noteCreate or overwrite a note (replaces entire content)
Create or overwrite a note (replaces entire content)
No parameter schema in public metadata yet.
edit_noteEdit a note without rewriting it — append, prepend (after frontmatter), or replace exact text
Edit a note without rewriting it — append, prepend (after frontmatter), or replace exact text
No parameter schema in public metadata yet.
list_foldersList all folders in the vault with note counts — use to discover folder names
List all folders in the vault with note counts — use to discover folder names
No parameter schema in public metadata yet.
list_tagsList all tags in the vault with counts — use to discover tags before filtering
List all tags in the vault with counts — use to discover tags before filtering
No parameter schema in public metadata yet.
list_notesList notes with timestamps. Filter by folder, name, tag, or date. Sort by name or modified.
List notes with timestamps. Filter by folder, name, tag, or date. Sort by name or modified.
No parameter schema in public metadata yet.
search_notesSearch note text for terms (OR, case-insensitive substrings); paths and frontmatter titles are searched first. Filter by folder, tag, or date. Returns paths with one context line each, never the note body, after a status line that states which CouchDB sequence the index is cau...
Search note text for terms (OR, case-insensitive substrings); paths and frontmatter titles are searched first. Filter by folder, tag, or date. Returns paths with one context line each, never the note body, after a status line that states which CouchDB sequence the index is cau...
No parameter schema in public metadata yet.
delete_noteDelete a note
Delete a note
No parameter schema in public metadata yet.
move_noteMove or rename a note — works across folders, creates destination folders automatically
Move or rename a note — works across folders, creates destination folders automatically
No parameter schema in public metadata yet.
get_note_metadataGet frontmatter, tags, outgoing links, backlinks, size, and timestamps — navigate the knowledge graph
Get frontmatter, tags, outgoing links, backlinks, size, and timestamps — navigate the knowledge graph
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
VAULT_PATHPath to your Obsidian vault directory (filesystem mode)
COUCHDB_URLCouchDB server URL (CouchDB mode)
COUCHDB_USERCouchDB username
COUCHDB_PASSWORDsecretCouchDB password (required in CouchDB mode)
COUCHDB_DATABASECouchDB database name
COUCHDB_PASSPHRASEsecretLiveSync E2E encryption passphrase (must match plugin setting)
COUCHDB_OBFUSCATE_PROPERTIESSet to 'true' if 'Obfuscate Properties' is enabled in LiveSync (obfuscates file paths, sizes, dates)
VAULT_NAMEVault name for deep links and index storage
MCP_AUTH_TOKENsecretPassword for OAuth authentication
BASE_URLPublic URL for OAuth callbacks (required when using a tunnel)
PORTHTTP port
Readme
Obsidian Sync MCP
Give any AI agent access to your Obsidian vault over MCP. Run it locally against your vault files, or pair it with Self-hosted LiveSync and deploy to the cloud so it works even when your machine 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.
How it works
The server connects to your vault in two ways:
Details
- Repository
- github.com/es617/obsidian-sync-mcp
- Category
- Documents & Knowledge
- Package
obsidian-sync-mcp- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active
More from es617
Related Documents & Knowledge MCP servers
View all
Context Memjubakitiashvili/context-memPersistent memory for AI agents — 98%+ retrieval recall, 99% token savings, 44 tools13stars
Google Drivedomdomegg/google-drive-mcpAllow AI systems to list, search, upload, download, and manage files and folders in Google Drive.7stars
SharePoint MCP Serverravikant1918/sharepoint-mcpMCP server for Microsoft SharePoint — manage folders, documents, and metadata.7stars
Confluence Cloudaaronsb/confluence-cloudMCP server for Confluence Cloud — page editing, navigation, and content management0stars
Cindyloo Dropbox Mcp Servercindyloo/dropbox-mcp-serverSearch, browse, and read your Dropbox files. Find documents by name or content, list folders, and…0stars
Knowledge Ravencom.knowledge-raven/mcpMake your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.0stars