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.

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.

List notes, and optionally attachments, with path, title and frontmatter but no body text.

Use search to find notes by what they say.

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.

List the distinct values one indexed frontmatter field takes across the vault.

Use the values in the filters argument of search.

Report the vault's size, link health and capabilities: the search modes it serves and the frontmatter fields search can filter on.

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.

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.

List the most recently modified notes, newest first.

Use it to pick up recent activity without a search query.

Return a note's metadata, backlinks, outlinks, similar notes, folder neighbours, indexed tags and applicable conventions in one call.

Use it instead of get_backlinks, get_outlinks and get_similar when you need more than one of them.

Return the vault owner's authoring conventions for a note or folder, vault root first and the most specific last.

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.

Page through all matching indexed notes with an exact total.

Queries with text rank by keyword score then path; blank queries rank by modification time descending then path. Pages are live views, so concurrent writes can move notes between pages. Use read to retrieve full note content.

Count every matching indexed note without fetching content.

The exact total is independent of search result caps and counts each note once.

Group every matching indexed note into bounded frequency buckets.

Counts cover the whole population. Multi-value tag buckets can sum above total; missing counts notes without a tag value. UTC months use YYYY-MM. Buckets rank by count descending then key.casefold() and raw key.

Discover note paths with direct matches before optional typo matches.

Returns metadata without bodies. Exact paths rank first, then case-insensitive literal prefix matches, followed by other literal matches and approximate matches. Coverage describes the approximate scan; truncated independently describes omitted results. Use read with a returned path to retrieve its content.

List the notes that link to a note.

Use get_context when you also need its outlinks or similar notes.

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.

List the links whose target is missing from the vault, each with the note that holds it.

stats reports broken_link_count; a rename without update_links leaves such links behind. Links to attachments are not checked.

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.

List the notes with the most backlinks, most first.

Use get_backlinks for the notes that link to one of them.

Find the shortest chain of links between two notes, following links in either direction.

Check embedding provider and vector-index status.

Report FTS index readiness, progress, and last build error.

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.

Replace text in an existing note, chosen by an exact old_text, by a range of lines, or by an old_text within a range of lines.

Read the note first for its current text. When old_text has no exact match, a unique match after normalising Unicode, dashes, quotes and whitespace is used and reported as match_type "normalized".

Add text to the end of an existing note without reading it first.

Prefer it over edit when the change only adds at the end, such as a log entry. The text starts on a new line; begin it with a blank line or a heading to start a paragraph or section.

Permanently delete a note or attachment; only git history can bring it back.

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.

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.

Download a URL on the server and save it in the vault as a note or attachment; returns its path, size and final_url.

The bytes never pass through the conversation, so use it for large files and then pass the path to other tools.

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.

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.

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.

List the commits that touched a note, an attachment, a folder or the whole vault, newest first.

A vault without git history returns no commits.

Return how a note or attachment changed from an earlier commit to now, as one unified diff or one per commit.

Pass exactly one of since_sha and since_timestamp; find commits with get_history. A vault without git history returns an empty diff.

Open an interactive vault explorer for the user to look through: the file tree, the link graph or one note's relationships.

It shows the vault to the user and returns nothing to read; use search, read, list_documents or get_context for content.

Return the full NoteContext for a note (app-only).

Called by the SPA context card view via app.callServerTool(). Not visible to the LLM.

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.

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.

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.

List folders and notes in a vault directory (app-only).

Called by the SPA browser view via app.callServerTool(). Not visible to the LLM.

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.

Search the vault (app-only).

Called by the SPA browser search bar via app.callServerTool(). Not visible to the LLM.

Report the version information of markdown-vault-mcp; returns server_name, server_version, core_version, the MCP protocol revisions supported and the revision and client of this connection, and, when configured, the upstream service's version. Use it when asked which version or build is running or which protocol revision is in use.

Bring the search index up to date with files changed outside this server, such as by an editor or a sync tool; returns counts of added, modified, deleted and unchanged notes.

Writes through this server's tools update the index themselves, so do not call it after them.

Bring the vector index behind semantic and hybrid search up to date with the notes; returns the number of chunks embedded.

Embeddings are built automatically, so it is needed only after reindex with force, after a failed build (last_build_embeddings_error in get_index_status), or with force to rebuild them all.

Get the status of a background job started by a long-running tool on this server; returns status (working, completed or failed) with the result or error once it finishes. Job records expire, so fetch a finished job's result promptly. On this server, background jobs come from slow summarize, reindex, and build_embeddings calls.