obsidian

An Obsidian vault is a folder of markdown files. There is no Obsidian process to talk to, no API, and no plugin installed on the Obsidian side — the obsidian_* tools read and write the files directly, and Obsidian picks the changes up on its own. If it is open, the user will see your note appear.

The vault is the user's own writing. Treat it that way: read a lot, write only what they asked for, and never present a note's contents as your own summary without saying which note it came from.

Tools

• obsidian_vaults — every vault on this machine, which one is open, which is the default.
• obsidian_search — find notes by title, content, or both. Returns paths plus the passages that matched.
• obsidian_read — one note: body, frontmatter as fields, tags, and its wikilinks resolved to paths.
• obsidian_recent — the notes modified most recently, with a preview line.
• obsidian_backlinks — the notes that link TO a note, and the line each link sits on.
• obsidian_create — a NEW note. Refuses to overwrite an existing one.
• obsidian_append — add to the end of an existing note. Refuses when it does not exist.

Every tool takes an optional vault (folder name or full path). Omit it for the vault open in Obsidian, or the most recently opened one.

What Obsidian means, that a plain file reader gets wrong