cyanheads/obsidian-mcp-server

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.
14 Tools • 3 Resources
## Overview
Your Obsidian vault, through the Local REST API plugin. Read, search, and write notes, edit a single heading, block, or frontmatter field in place, and manage tags, with folder-scoped read/write permissions built in.
### Tools
| Tool | Description |
| obsidian_get_note | Read a note as raw content, full structured form, document map, or a single section |
| obsidian_list_notes | List notes and folders under a vault path, recursively, with extension and name filters |
| obsidian_list_tags | List vault tags with usage counts, most-used first |
| obsidian_search_notes | Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable |
| obsidian_write_note | Create a note, replace one section, or overwrite a whole file with overwrite: true |
| obsidian_append_to_note | Append to a note (creating it if missing) or to one heading, block, or frontmatter field |
| obsidian_patch_note | Append, prepend, or replace against one heading, block reference, or frontmatter field |
| obsidian_replace_in_note | Literal or regex search-replace inside one note, body-only by default |
| obsidian_manage_frontmatter | Get, set, or delete one frontmatter key |
| obsidian_manage_tags | Add, remove, or list a note's tags in frontmatter, inline, or both |
| obsidian_delete_note | Permanently delete a note, optionally after the user confirms (OBSIDIAN_DELETE_ELICITATION) |
| obsidian_open_in_ui | Open a file in the Obsidian app, optionally in a new pane |
| obsidian_list_commands | List command-palette commands (opt-in via OBSIDIAN_ENABLE_COMMANDS) |
| obsidian_execute_command | Run a command-palette command by ID (opt-in via OBSIDIAN_ENABLE_COMMANDS) |
### Resources
| Resource | Description |
| obsidian://vault/{+path} | A note's content, frontmatter, tags, and file metadata |
| obsidian://tags | Every vault tag with its usage count, as an uncapped snapshot |
| obsidian://status | Plugin reachability, auth status, versions, and registered API extensions |
Note and tag data are also reachable through tools (obsidian_get_note, obsidian_list_tags); obsidian://status has no tool equivalent.
## Capability reference
### obsidian_get_note tool
target is a vault path, the active file, or a periodic note (daily through yearly, optional date); format is content, full, document-map, or section, and full takes includeLinks: true for vault-internal outgoing links
result.format discriminates the payload; a section read that matches several headings returns the first and lists every full path in candidates
A path with no exact match but one case-insensitive match in its folder reads that file: result.path is the real name, requestedPath the one sent, and a notice names both
### obsidian_list_notes tool
Walks from path (default vault root) to depth 1–20 (default 2), filtered by extension and nameRegex (≤256 chars); a folder that fails nameRegex is not walked
Returns entries[] (file / directory), totals, and appliedFilters; the walk stops at 1,000 entries with excluded.reason: "entry_cap", and a folder the depth limit stopped carries truncated: true