io.github.es617/obsidian-sync-mcp

Read the content of a note from the Obsidian vault. Returns the markdown content and a deep link to open it in Obsidian.

Write or update a note in the Obsidian vault. Creates the note if it doesn't exist. Replaces the entire content if it does — read first if you need to preserve existing content.

List markdown notes in the vault with modification timestamps. Examples: list_notes(sort_by='modified', limit=10) for 10 most recent notes. list_notes(name='meeting') to find notes by name. list_notes(folder='daily') for a specific folder. list_notes(tag='project') for notes with a specific tag. Returns up to 100 notes by default.

List all folders in the vault. Use this to discover folder names before writing or listing notes. Returns the folder tree with note counts.

List all tags used in the vault, sorted by frequency. Use this to discover tags before filtering with list_notes.

Edit a note without rewriting it. Use 'append' (default) to add content to the end, 'prepend' to add after frontmatter, or 'replace' to swap old_text with new content. For replace, the old_text must match exactly once.

Delete a note from the Obsidian vault.

Move or rename a note. Use this to rename a note within the same folder, move it to a different folder, or both at once. Creates destination folders automatically.

Get metadata about a note without reading its full content. Returns frontmatter, tags, outgoing links, backlinks (notes that link to this one), size, and timestamps. Use this to navigate the knowledge graph.