Craft

Read/search Craft; batch with semicolons. Keywords: find/open/read/search docs/pages/cards/blocks, daily notes, tasks/inbox/logbook, folders/spaces, collections/tables/schema/items/fields/relations, links/URLs/richUrl, images/files/videos, themes/washi. Cmds: folders list [--filter <regex>] folders explore-icons <term> documents list [--location unsorted|trash|templates|daily_notes | --folder <folderId>] documents resolve-link <url> -> rootBlockId for blocks/write commands tasks list [--scope active|upcoming|inbox|logbook|document|all] # all = every task block in full-space, not a union of other scopes blocks get <rootBlockId> [--depth <depth>] [--format json|markdown] blocks get --date today blocks explore-themes --type page|fonts|code blocks explore-washi blocks search-unsplash <query> collections list [--document <rootBlockId>] collections schema --collection <collectionId> collections items-get --collection <collectionId> collections views-list --collection <collectionId> connection info whiteboards elements get --whiteboard <whiteboardId> images view --url <image-url> search <query> [--location unsorted|trash|templates|daily_notes] Common flags: --offset, --cursor, --filter <regex>, --format json|markdown. Help: "<entity> <action> --help". Example batch: folders list; documents list; blocks get ABC-123 --format markdown For Craft links, run 'documents resolve-link <url>' first; use returned rootBlockId for blocks get/write commands, not raw URL documentId.

craft_read

Write; batch semicolons. docs blocks daily notes tasks todos folders collections tables schema items links files; add append update rename delete trash move reorder repeat Cmds: folders create --name <name> [--parent <folderId>] [--icon <emoji>] documents create --title <requestedTitle> [--destination unsorted|templates | --folder <folderId>] tasks add --markdown <text> [--state todo|done|canceled] [--schedule <date>] [--deadline <date>] tasks update --id <taskId> [--state done] [--markdown <text>] tasks delete --id <taskId> blocks add --id <pageId> --markdown <text> [--position start|end] blocks add --siblingId <blockId> --markdown <text> [--position before|after] blocks update --id <blockId> --markdown <text> blocks delete --id <blockId> blocks move --id <blockId> --targetId <pageId> [--position start|end] collections create --name <name> --title <titleColumn> --<Property> <type> --document <rootBlockId> collections rename --collection <collectionId> --name <name> collections items-add --collection <collectionId> --<PropertyName> <value> collections items-update --collection <collectionId> --id <itemId> --<PropertyName> <value> collections items-delete --collection <collectionId> --id <itemId> collections views-create/update/delete/set-active --collection <collectionId> ... comments add --comments '[{"blockId":"blockId","content":"text"}]' whiteboards create [--position <json>]; whiteboards elements add/update/delete --whiteboard <whiteboardId> ... MD: MCP command text needs actual newline chars; not to type backslash-n text for rows; \n\n=blocks. After + Toggle, rewrite child text as " - child"; never plain/flush-left. update:first replaces;rest inserts. Style:--theme-id,--font,--separator,--washi-pattern,--cover-url,--backdrop-type/color(s)/url,--cover-crop. IDs:resolve;rootBlockId!=URL docId. Coll:schema;prop:. Date YYYY-MM-DD/today/tomorrow/yesterday. Ext:<callout>,+ Toggle,> quote. Help:<entity> <action> --help

craft_write

Reverts a previous mutation if blocks haven't been modified since. Used by widgets for undo/redo functionality.

blocks_revert

Opens a file picker for the user to upload a file (image, PDF, etc.) to a specific position in a document. The user will drag-and-drop or select a file in the widget.

file_picker_open

Uploads a file from a temporary URL to a document position. Called by the file picker widget after the user selects a file.

file_upload_from_url