All 27 Tools

Complete reference for every VaultForge MCP tool, organized by category.

Notes
6 tools
read_note
Read note content and metadata. Supports fuzzy path resolution.
write_note
Create a new note or overwrite an existing one.
edit_note
In-place find and replace. Exact match, must be unique in the file.
edit_regex
Regex find-and-replace with capture groups. Single file or grep-sub across entire vault. Dry run supported.
append_note
Append content to an existing note, or create it if missing.
delete_note
Delete a note. Moves to .trash (safe) or permanent delete. Optional cleanup_empty_parents removes empty parent directories.
Search & Discovery
8 tools
smart_search
BM25-ranked search via Orama. Typo tolerance, stemming (26 languages), field boosting (title 3x, tags 2.5x, headings 2x, content 1x). Returns ranked results with relevance scores and snippets.
search_reindex
Force a full re-index of the vault search index. Use after bulk operations that bypass normal file watching.
search_vault
Fast filename and path search from the in-memory index. For finding files by name, not content.
search_content
Full-text grep search. For exact/literal string matches across vault files. Unranked.
list_dir
Directory listing with created/modified timestamps. Sort by name, date, or size.
recent_notes
Get recently modified files. Instant from index, no filesystem scan.
daily_note
Get or create today’s daily note (or any specific date).
vault_status
Vault statistics: file counts by type, index health, directory count.
Files
3 tools
batch_rename
Rename or move files using explicit pairs or regex patterns. Automatically updates all wikilinks across the vault. Dry run by default.
delete_folder
Delete empty or non-empty directories. Moves to .trash by default. Safety guards prevent deletion of .obsidian, .git, .trash.
prune_empty_dirs
Find and remove all empty directories in the vault. Dry run by default. Bottom-up pruning handles cascading empty directories.
Links
2 tools
update_links
Update all wikilinks across the vault after moving or renaming a file. Dry run by default.
backlinks
Find all files that link to a given file. Returns line numbers, surrounding context, and embed detection (regular link vs !embed).
Metadata
1 tool
frontmatter
Read, write, or merge YAML frontmatter as structured data. No string parsing needed — works with native objects.
Canvas
4 tools
canvas_create
Create a fully laid-out .canvas file from a semantic graph description. Agent describes nodes and edges; dagre (Sugiyama algorithm) calculates all coordinates automatically.
canvas_read
Read a .canvas file and return a semantic graph (node labels + edge connections) instead of raw JSON with coordinates and hex IDs. ~80% fewer tokens than raw format.
canvas_patch
Add, remove, or update canvas elements with relative positioning (e.g., "near: API Gateway, position: below") and fuzzy node matching. Cascade-removes edges when deleting nodes.
canvas_relayout
Re-layout an existing canvas using the dagre algorithm. Preview changes before committing. Fixes messy manual layouts with one call.
Intelligence
2 tools
vault_themes
Scan all vault files, extract distinctive terms via TF-IDF, and cluster by similarity. Returns a theme map with key terms, file counts, folder distribution, coherence scores, orphan files, and cross-folder warnings. One call replaces hundreds of individual file reads.
vault_suggest
Generate actionable reorganization suggestions from the vault theme map. Suggests file moves (consolidate), MOC creation, archiving stale files, and orphan triage. Can execute approved suggestions in batch.
Batch
1 tool
batch
Execute multiple vault operations in a single call: read, write, edit, regex, rename, frontmatter, delete. Supports cleanup_empty_parents on delete operations.