obsidian-mcp-router

List all configured Obsidian vaults (local and remote). Returns five fields: defaultVault (the name resolved by the cascade for the current session), vaults[] (active vaults, each pinged for online status + latency + missingApiKey + isDefault), disabled[] (vaults skipped by the disabledVaults config…

List files and subdirectories inside a vault. Pass a directory path (relative to vault root) to drill in, or omit it to list the vault root.

Read the full content of a file from a vault. Returns markdown text, metadata, and frontmatter. The result includes contentSha256 — pass it back as ifMatch on a later write/patch/delete/move to refuse the change if the file was modified in between (optimistic concurrency).

Plain-text (substring) search across a vault. Returns matches with surrounding context. For meaning-based search, use search_smart instead.

Create a new file or replace the entire content of an existing file. Pass ifNew: true to refuse to overwrite an existing file (server returns 409). Pass ifMatch (a contentSha256 from get_file) for an atomic compare-and-swap: the write is refused with a 409 conflict if the file changed since you read…

Append content to the end of a file. Creates the file if it doesn't exist (unless requireExisting is true). Use this for journals, logs, or running notes.

Move or rename a file. Implemented as GET source → PUT destination → DELETE source (no native endpoint exists on Local REST API). Pass overwrite: true to replace an existing destination.

Read frontmatter from a file. Pass key to get a single property; omit it to get the full frontmatter object. Returns parsed values (numbers, booleans, arrays preserved — not just strings).

Set or replace a single frontmatter property. Convenience wrapper around patch_file with targetType: frontmatter. The value can be a string, number, boolean, array, or object — type is preserved.

Apply multiple frontmatter updates in sequence (NOT atomic — partial failures possible). Returns a per-key result. For atomic multi-key updates, prefer get_frontmatter + modify + write_file.

Permanently delete a file from the vault. Two-phase: call with preview:true to get a sealed plan (approvedPlanSha256), then call with confirm:true (echoing that seal) to proceed. The confirm:true guard prevents accidental deletes; the seal refuses the delete if the file drifted (changed/created/remo…

Surgical edit of a specific section, block, or frontmatter field of a file — without rewriting the whole file. Use this when you want to insert under a specific heading, replace a block by ID, or update a single frontmatter property.

Execute a Templater template against the vault. Optionally writes the rendered result to a new file. Requires the templater-obsidian plugin enabled in the target vault. The arguments map is exposed inside the template via tp.mcpTools.prompt("key") — note: directly under tp, NOT under tp.user.

Semantic (meaning-based) search using Smart Connections embeddings. Returns ranked chunks with cosine similarity scores and breadcrumbs (heading path). Hits under an `archives/` folder (archived decision deliberation, `type: decision-archive`) are excluded by default — the response then carries `arc…

Restrict the router to a single vault for the current session. While locked, every tool call that targets a different vault throws "Router is locked to ..."; calls without an explicit `vault` resolve to the locked one; cross-vault fan-out (`vault: "*"`) is refused. Use `unlock_vaults` to lift the lo…

Lift the single-vault lock and restore normal multi-vault routing. Pass `persist: true` to ALSO remove the OBSIDIAN_ROUTER_LOCKED line from the current workspace .env (otherwise the lock would re-apply at next startup if the .env still has it set).

Convert a local PDF file to markdown via the bundled `markitdown` Python CLI. Returns the markdown text — does NOT write to any vault. Chain with `write_file` to persist the output. Set `MD_ALLOWED_PATHS` to restrict which directories can be read.

Convert a local PDF to markdown via Docling's standard pipeline (layout + table-structure recognition) — higher fidelity than `pdf_to_markdown` on complex tables / multi-column layouts, at ~10x the CPU cost. OPT-IN: requires the Docling extra (install with OBSIDIAN_ROUTER_ENABLE_DOCLING=1, or `npm r…

Render a local PDF's pages to PNG images and return them as MCP image content blocks so the model can visually SEE the pages — complements `pdf_to_markdown`/`pdf_to_markdown_docling`, which only extract TEXT and lose layout, figures, diagrams, and visual formatting. OPT-IN: requires pypdfium2 + Pill…

Convert a local DOCX file to markdown via `markitdown`. Returns markdown text only — does not write to any vault.

Convert a local XLSX spreadsheet to markdown via `markitdown`. Returns markdown text only — does not write to any vault.

Convert a local PPTX presentation to markdown via `markitdown`. Returns markdown text only — does not write to any vault.

Convert a local image to markdown (metadata + OCR-derived description) via `markitdown[all]`. Requires the `[all]` extras — image OCR fails on the slim install.

Convert a local audio file to markdown (with transcription when supported) via `markitdown[all]`. Requires the `[all]` extras — audio transcription fails on the slim install.

Convert a YouTube video page to markdown — includes the transcript when one is available. Falls back to yt-dlp caption extraction when the primary (MarkItDown) path fails; the fallback needs yt-dlp on PATH (or YTDLP_PATH) and degrades with a clear error if it is absent. URL must be http(s); private/…

Convert a Bing search results page to markdown. Pass the full results URL. SPA pages that defer rendering to JS produce raw HTML — the tool detects that and returns a clear error rather than misleading "markdown".

Convert an arbitrary webpage to markdown. URL must be http(s); private/loopback hosts are refused (SSRF guard). For JS-rendered SPAs prefer the `defuddle` skill which uses a headless browser. Optionally pass `relevanceQuery` to apply a BM25 relevance second-pass (see filter_relevant_blocks) that dro…

Convert a git repository into a single markdown document (file tree + source code) via `repomix`. Useful as input to an LLM that needs whole-repo context. Supports GitHub URLs and the `owner/repo` shorthand. Pass `compress: true` for Tree-sitter compression (~70% size reduction).

Set the wiki auto-enrichment mode for the current session. Auto-enrichment is the layer where Claude proactively proposes wiki saves at three triggers (validation pins, result-obtained digests, topic-switch checkpoints). Modes: "ClaudeAsk" (default — propose, user always confirms), "Hybrid" (auto-sa…

Build a click-to-open URL (and a ready-to-paste markdown link) for one or many vault files WITHOUT reading or writing them. Use this when you need to cite a vault file in a chat response and you don't already have the URL from a previous tool call (write/get/patch all return clickToOpenUrl). Single …

Navigate the running Obsidian for a vault to a file — and bring its window to the front — WITHOUT opening a browser. Use this when the user asks to "open" / "show" / "go to" a note: the router calls the bridge's /open route server-side, so (unlike a click-to-open LINK, which a browser-proxying clien…

Get an ephemeral, ready-to-click browser link to VIEW/READ a vault's LIVE Obsidian GUI — navigated to a specific note, with credentials baked into the URL so the user types nothing. Call this WHENEVER the user asks for a link to read/see/open a note (e.g. "give me the link to the document", "can I s…

READ-ONLY. Plan the creation of a NEW local Obsidian vault: returns the computed defaults + a structured questionnaire (the 5 wiki modes with explanations, the themes installed in the source, the registered vaults you can copy config from, the plugin profiles) + warnings + an approvedPlanSha256 (C3 …

Create a NEW local Obsidian vault in one call from a set of wizard answers (typically the defaults/adjustments surfaced by plan_vault). Returns a step-by-step report + port, insecurePort, openUri, and probeResult. SECURITY: refuses any path outside the known vault roots unless allowOutsideRoots:true…