Markdown Vault MCP

List every note with no links in or out, with no limit on the count. stats reports orphan_count; check it first on a large vault. Args: wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right after a document mutation whose effect this read should reflect). Default False answers immediately from the current index; almost always already up to date; …

List the links in a note, each with an exists flag that is false when the target is missing. Use get_context when you also need its backlinks or similar notes. Args: path: Path of the note holding the links, such as `"notes/topic.md"`; case-sensitive. limit: Maximum outlinks to return; omit for all. wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right a…

List the most recently modified notes, newest first. Use it to pick up recent activity without a search query. Args: limit: Maximum notes to return (default 20). folder: Only notes in this folder and its sub-folders, such as `"Journal"`; `""` for top-level notes only; omit for the whole vault. wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right after a…

Find the notes closest in meaning to a given note; returns them ranked by similarity with their closest sections, the note itself excluded. Needs semantic_search_available from stats. A note whose embeddings are not built yet has no similar notes. Args: path: Path of the note to compare against, such as `"notes/topic.md"`; case-sensitive. limit: Maximum notes to return (default 10). chunks_per_file: Maximum sections per note, at least 1; omit for the server default. folder: Only notes in this folder or below, such as `"3-Resources"`; `""` for top-level…

Return the heading outline of a note, or of every note under a folder. For a note: a list of {heading, level}, the title first as level 1. For a folder: {path, notes, truncated}, each note with its path, title and headings. Args: path: A note path ending in .md, such as `"a/b.md"`, or a folder, such as `"a/b"`. max_level: Deepest heading level to keep, such as 2 for H1 and H2; omit for all. The title always stays. max_notes: Folders only: notes to include, first by path (default 200); truncated is true when more exist. wait_for_pending_writes: When True, wait …

Pull from and push to the vault's git remote now; returns what each leg did. With direction "both" the pull runs first, and a failed pull skips the push. Args: direction: `pull`, `push` or `both` (default). dry_run: Report what a pull would do without changing anything; the push leg reports applied false without contacting the remote. Returns: Dict with the following fields: - direction (str): The requested direction, echoed back. - head_sha (str): Local HEAD SHA after the operation. May differ from the pre-call HEAD when the pull leg advanced the br…

List notes, and optionally attachments, with path, title and frontmatter but no body text. Use search to find notes by what they say. Args: folder: Only notes in this folder and its sub-folders, such as `"Journal"`; `""` for top-level notes only; omit for the whole vault. pattern: Glob matched against paths, such as `"Journal/*.md"` or `"**/*meeting*.md"`. include_attachments: Also list non-note files, marked kind=`"attachment"` with their mime_type. Default false. filters: Frontmatter values to match, all of them, such as `{"tags": "craft"}`; …

List every folder that holds notes; `""` stands for the top level. Pass one as the folder argument of search, list_documents and the other folder-scoped tools. Args: wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right after a document mutation whose effect this read should reflect). Default False answers immediately from the current index; almost …

List the distinct values one indexed frontmatter field takes across the vault. Use the values in the filters argument of search. Args: field: A field from indexed_frontmatter_fields in stats (default `"tags"`). wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right after a document mutation whose effect this read should reflect). Default False answers…

Move a folder and everything under it to a new location, rewriting every link into it across the vault: rename for a whole folder. Notes whose links could not be rewritten are listed in failed_links. Args: old_dir: Folder to move, such as `"drafts"`. new_dir: Destination folder, such as `"archive/2026"`; an existing folder is merged into. Returns: Dict with old_dir (str), new_dir (str), files_moved (int) and updated_links (int), plus: - failed_links (list[str]): paths of notes whose links could not be rewritten; the move itself stands. - remote (dict, …

Rewrite wikilinks as bundle-root-absolute Markdown links, the Open Knowledge Format's recommended style; returns counts of links converted and skipped. A wikilink whose target is not in the vault stays as it is. Running it again changes nothing already converted. Args: folder: Only notes in this folder and below, such as `"guides"`; omit for the whole vault. Returns: Dict with: - files_changed (int): notes rewritten. - links_converted (int): wikilinks turned into Markdown links. - links_skipped (int): wikilinks left as they are because the target is not in…

Write a folder's Open Knowledge Format index.md: a link to each note directly in it with its description, and one to each subfolder's index.md, replacing the old listing and keeping its frontmatter. Subfolders without an index.md get one too. Args: folder: Folder to index, such as `"guides"`; omit for the bundle root. Returns: Dict with: - path (str): the index.md written. - entries (int): notes and subfolder links listed. - frontmatter_preserved (bool): true when the file already had frontmatter, which is kept; false when it had none, though the fields the …

Create a folder's Open Knowledge Format log.md from the git history of the notes under it, one dated section per day, newest first. It never replaces an existing log.md. It covers the 100 most recent commits. A vault without git history gets an empty log. Args: folder: Folder to write log.md in, whose history it covers, such as `"guides"`; omit for the bundle root and the whole vault's history. Returns: Dict with path (str), commits (int) and dates (int, the number of distinct days), plus: - remote (dict, optional): present only while the vault's git clone can…

Audit how far the vault conforms to the Open Knowledge Format, with example paths per rule; works on a vault not yet declared as a bundle.

Record that a person reviewed a note, raising its Open Knowledge Format trust tier to human-reviewed; returns the verifier recorded. The user may be asked to confirm the review. The record means a person looked, not that the content is correct. Args: path: Path of the note the user reviewed. Returns: On the modern protocol's first round, an input request asking the client for human confirmation. After confirmation, a dict with: - `path`: the verified note. - `verifier`: the `human:<subject>` actor recorded. - `verified_count`: the number of verification entries afte…

Return a note's text, frontmatter and etag, or an attachment's bytes as base64. Look paths up with search or list_documents first rather than guessing them. Args: path: Path in the vault, such as `"Journal/note.md"` or `"assets/diagram.pdf"`; case-sensitive. section: A heading, such as the heading field of a search result; returns that section and its sub-sections instead of the whole note. Notes only. revision: A commit SHA from get_history or from a write result's previous_revision; returns the note as it stood then, without an etag. Pass path as…

Rename or move a note or attachment; with update_links, links to it in other notes follow it. For a note, always pass update_links=True. Parent folders are created as needed. Args: old_path: Current path, such as `"drafts/idea.md"` or `"assets/old.png"`. new_path: New path, such as `"projects/idea.md"`, where nothing exists yet. if_match: Etag from read of old_path; omit when renaming several linked notes together. update_links: Rewrite links to old_path in other notes so they point at new_path; attachment references are not tracked. Default false; pass …

Search notes by keyword and meaning; returns notes ranked by score, each with its best-matching sections as snippets. Use list_documents for a complete listing and read for a path you already know. Args: query: Words to match or a natural-language question. limit: Maximum notes to return (default 10). mode: Omit for the best mode this vault serves. `"keyword"` suits exact terms, operators and filenames; `"semantic"` matches meaning only; `"hybrid"` combines both. `"semantic"` and `"hybrid"` need semantic_search_available from stats. folder: Only notes …

Open an interactive card for the user showing a note's backlinks, outlinks, similar notes, tags and frontmatter. It shows the note to the user and returns only counts; use get_context for the data. Args: path: Path of the note, such as `"Journal/2024-01-15.md"`. Returns: - path (str): The note path. - view (str): Always `"context"`. - summary (str): Text summary with backlink, outlink, and similarity counts.

Report the vault's size, link health and capabilities: the search modes it serves and the frontmatter fields search can filter on. Args: wait_for_pending_writes: When True, wait until your recent document mutations have been applied to the index before answering, so the results reflect those changes. Use it right after modifying notes when this read must see them (such as right after a document mutation whose effect this read should reflect). Default False answers immediately from the current index; almost always already up to date; …

Return the full NoteContext for a note (app-only). Called by the SPA context card view via `app.callServerTool()`. Not visible to the LLM. Args: path: Relative note path (such as `"Journal/2024-01-15.md"`). Returns: Dict with path, title, folder, frontmatter, modified_at, backlinks, outlinks, similar, folder_notes, and tags; see 'get_context' for field details. Returns `{"error": "..."}` if the note is not found.

Return the most-linked notes and their connections as a graph (app-only). Called by the SPA graph view for the hub overview. Not visible to the LLM. Args: limit: Max number of hub notes to include. Returns: Dict with: - nodes (list): List of dicts, each with: - id (str): Unique identifier for the node. - label (str): Display name for the node. - group (str): `"hub"` or `"note"`. - folder (str): Parent folder path. - backlink_count (int): Number of inbound links. - note_type (str, optional): The note's OKF `type` frontmatter value; pr…

Return the link neighborhood of a note as a node/edge graph (app-only). Called by the SPA graph view via `app.callServerTool()`. Not visible to the LLM. Args: path: Center note path. depth: How many hops to traverse (default 1). include_semantic: When True, add dashed semantic-similarity edges for each interior node (requires embeddings to be configured; silently omitted when unavailable). max_nodes: Soft cap on returned node count (default 200). BFS and any semantic expansion both stop once the cap is hit; the response sets `truncated=True`. B…

List folders and notes in a vault directory (app-only). Called by the SPA browser view via `app.callServerTool()`. Not visible to the LLM. Args: folder: Folder to list (root if omitted). Returns: Dict with: - folders (list[str]): Direct child folder paths. - notes (list): Notes directly inside this folder. List of dicts, each with: - path (str): Relative path of the note. - title (str): Document title. - kind (str): `"note"` or `"attachment"`.

Read a note's full content for preview rendering (app-only). Called by the SPA browser view via `app.callServerTool()`. Not visible to the LLM. Args: path: Relative note path. Returns: Dict with path, title, frontmatter, content (the full raw file, including the frontmatter block), and modified_at (Unix timestamp), or null if the note is not found.

Search the vault (app-only). Called by the SPA browser search bar via `app.callServerTool()`. Not visible to the LLM. Args: query: Search query string. mode: Search mode (keyword, semantic, or hybrid). limit: Max results. Returns: List of result dicts, each with path (str), title (str), snippet (str, first 200 chars of matched chunk), and score (float). Returns `[{"error": "..."}]` on search failure.

Create a note or attachment, or replace one whole; returns its path and whether it was created. Use edit for targeted changes and append to add to the end. Parent folders are created as needed. Args: path: Path in the vault, such as `"Journal/note.md"` or `"assets/photo.png"`; the extension decides between note and attachment. content: The note's Markdown body, without frontmatter. frontmatter: The note's frontmatter, such as `{"title": "My Note", "tags": ["draft"]}`. content_base64: An attachment's bytes, base64-encoded; for paths not ending in .md. …