An AI coding agent skill to create, read, and structure documents, tasks, and whiteboards via the unified Craft MCP v2 API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install craft-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install craft-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Craft MCP v2 Integration?
This skill enables an AI coding agent to interact directly with Craft documents through the Craft Model Context Protocol (MCP) v2. It unifies complex note-taking and document management workflows into a streamlined system, making it an essential component of Openclaw Skills. Using a unified tool architecture, agents can execute reads, writes, and rollbacks via single-command sequences.
By leveraging JSON-based array formatting, this integration ensures that headings, code blocks, checklists, toggles, and tables compile correctly without parsing errors. The capability allows you to construct structured documentation, team wikis, and multi-layered task trackers directly within your production Craft workspace.
Craft MCP v2 Integration Use Cases
- Automating project specification sheets and technical documentation from codebase contexts using Openclaw Skills.
- Creating structured meeting notes, task boards, and toggles dynamically during agent-led research tasks.
- Managing Craft database collections and populating custom fields or single-select statuses programmatically.
- Restructuring existing Craft workspaces by bulk-reading and editing specific block nodes without disrupting parent page designs.
- Adding Excalidraw-compatible diagram elements directly onto live Craft whiteboards.
How Craft MCP v2 Integration Works
- The agent uses Openclaw Skills to connect to the production Craft server via the MCP v2 client.
- To read or search content, the agent issues a command through
craft_readwith depth parameters or custom search terms. - To write or mutate data, the agent invokes
craft_writeusing JSON-formatted block arrays, avoiding formatting errors common to basic markdown strings. - If transient network anomalies (such as Cloudflare 502/503/504 errors) occur, the skill applies a structured exponential backoff strategy before retrying the mutation.
- A pre-finalize readback is executed to verify document rendering, nested styles, and structural layouts before concluding the operation.
Craft MCP v2 Integration Setup
To deploy this workflow, ensure your environment is configured for MCP v2 execution. This integration operates directly with your production account, so valid API access tokens and space identifiers are required. You can test your connection with the following command:
craft_read: "connection info"
Ensure your AI coding agent has this configuration defined in its execution context to expose the craft_write, craft_read, and blocks_revert tools.
Craft MCP v2 Integration Data Schema & Taxonomy
The integration organizes data by identifying every document through its underlying rootBlockId. Blocks are sequenced elements that support diverse styling properties. Below is the main element-to-input mapping schema:
| Element Type | Input Format | Styling Property |
|---|---|---|
| Headings | JSON textStyle: h1 to h4 |
Standard margins, double newline rules |
| Tasks | JSON listStyle: task |
Supports todo, done, or canceled states |
| Code Blocks | JSON type: code |
Requires language parameter (no triple backticks) |
| Toggles | JSON listStyle: toggle |
Indentation levels from 0 to 5 define nesting |
| Collections | JSON database schema | Map custom properties using snake_case top-level keys |
All elements accept custom block styling such as hex background colors, alignment options, and decoration settings (e.g., blockquotes and callouts.
Craft MCP v2 Integration Advanced Features
- Batch Execution: Supports chaining multiple commands separated by semicolons in a single tool call to optimize latency and minimize HTTP requests.
- Session-Safe Retries: Employs a stateful backoff policy (60s, then 120s) with workspace snapshotting to recover cleanly from network interruptions.
- Database Schema Alignment: Dynamically updates and retrieves items from custom collections, converting user-defined parameters to snake_case structures.
- Excalidraw Element Insertion: Programmatically populates whiteboards with shapes, text blocks, and vector connections using standard JSON.
- Comprehensive Reversion: Utilizes
blocks_revertalongside target stamp validation to roll back accidental mutations safely within Openclaw Skills integrations.
SKILL.md
Loading
Related Openclaw Skills
PuzzleTide Crossword
PuzzleTide Crossword helps Openclaw Skills generate valid, numbered crossword grids locally from custom clues, themes, or word banks.
PuzzleTide Agent Evals
Openclaw Skills for generating, running, and grading reproducible puzzle benchmarks that verify LLM and agent reasoning locally.
Stock Analysis Expert
Openclaw Skills' Stock Analysis Expert turns A-share market data into a nine-layer investment report with scores, signals, and risk controls.
Grok Build
Openclaw Skills for Grok Build turns xAI's terminal AI coding agent into a full-screen TUI for interactive coding, file edits, shell automation, search, and headless workflows.
TRPG YAML to SVG Maps
Openclaw Skills turns TRPG YAML map definitions into clean, readable SVG visual maps without modifying the source YAML.
TRPG Maps Update
Openclaw Skills for migrating and standardizing briefing_package map systems by moving large YAML maps to maps/, wiring map_ref, and enabling map_config visuals.
Featured*
