---
canonical_url: "https://docs.composio.dev/toolkits/craft_mcp"
markdown_url: "https://docs.composio.dev/toolkits/craft_mcp.md"
product: "platform"
version: null
last_updated: null
---

# Craft MCP

Craft MCP lets agents search, read, create, update, and delete authorized Craft documents, daily notes, tasks, collections, and structured workspace content.

- **Category:** model context protocol
- **Auth:** DCR_OAUTH
- **Composio-managed OAuth available?** No
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `CRAFT_MCP`
- **Version:** 20260910_00

## Tools

### Blocks revert

**Slug:** `CRAFT_MCP_BLOCKS_REVERT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `revertInfo` | object | Yes |  |

### Craft read

**Slug:** `CRAFT_MCP_CRAFT_READ`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string | Yes | Command to execute. Use --help to discover commands. |

### Craft write

**Slug:** `CRAFT_MCP_CRAFT_WRITE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string | Yes | Command to execute. Use --help to discover commands. |