add_board_content
ChatGPTAdd a diagram, sticky notes, a table or a wireframe to an existing board. Create the board first with create_file(type:'board'). Steps/decisions/process → flowchart; hierarchy/outline → mindmap; actors exchanging messages → sequence_diagram; clustered short notes → sticky_notes; tabular data → table; UI screen → wireframe. These lay themselves out; for freeform shapes, text and connectors at absolute positions use edit's add operations instead. Mind maps: pass data.markdown directly (no how_to needed). Sequence diagrams: use data.diagram with arrow syntax (A -> B: msg) — no how_to needed for basic diagrams. Flowcharts: MUST call how_to('flowchart') first for the structured format. Wireframes: MUST call how_to('wireframe') first. To change an existing wireframe use wireframe_edit.
add_doc_content
ChatGPTAppend markdown to the end of an existing doc — headings, lists, links, code blocks, tables. To change or insert blocks elsewhere in the doc, use edit with its doc operations (see how_to('doc')).
auto_layout
ChatGPTRe-arrange a Whimsical flowchart's shapes using the editor's auto-layout (ELK). Connectors re-route automatically. Use after adding shapes via add_board_content or edit to clean up the layout.
create
ChatGPTCreate content in Whimsical — diagrams, folders, or boards. Pick by intent: source is a sketch, hand-drawn note, photographed whiteboard, or any layout where absolute positions matter → type:'board' (pass data.items for one-shot creation; MUST call how_to('board') first). Source describes semantic structure (steps, hierarchy, sequence, UI) → flowchart, mindmap, sequence_diagram, or wireframe — these auto-layout. Mind maps: pass data.markdown directly (no how_to needed). Sequence diagrams: use data.diagram with arrow syntax (A -> B: msg) — no how_to needed for basic diagrams. Flowcharts: MUST call how_to('flowchart') first for the structured format. Wireframes: MUST call how_to('wireframe') first. For documents, use doc_create.
create_file
ChatGPTCreate a board, doc or folder in Whimsical. Boards start empty: add diagrams, sticky notes, tables and wireframes with add_board_content, or individual shapes, text and connectors with edit (see how_to('board')). Files start empty: fill a doc with add_doc_content. Pass add_page_to_id to add the new file as a page next to an existing one: added to it if it is a multipage, to its multipage if it is a page of one, otherwise the file is first turned into a multipage holding it as the first page — the same as Add page in the app. Use it when the user asks for a new page, tab or sheet of an existing file.
delete
ChatGPTMove a Whimsical file, folder, or doc to trash. The item can be restored from the Whimsical trash UI. Pass the item id from a previous file_tree or search result. To delete shapes, text, or connectors inside a board, use the edit tool with a delete operation instead.
doc_create
ChatGPTCreate a Whimsical document. Markdown content — headings, lists, links, code blocks. For diagrams, boards, or folders, use create.
edit
ChatGPTEdit a Whimsical board or doc. Fetch the board first to get object IDs. Boards: add/update/delete shapes, text, connectors (use temp_id), icons, tables; find_replace/delete_by_text for compound diagrams; mm_update to restructure mindmaps; sd_update for sequence diagrams. Docs: update_block/insert_after_block/append_blocks/delete_block (all markdown). Use how_to('edit') for advanced syntax (table columns, group ops, doc table ops).
fetch
ChatGPTRead boards, docs, or folders by ID. Returns text by default; set image=true for a PNG snapshot. Use scope to drill into a group, select_kinds to filter by type, grep_text to search.
file_tree
ChatGPTBrowse workspace folder hierarchy.
generate_diagram
ChatGPTAuto-laid-out semantic diagrams ONLY (flowchart, mind map, sequence diagram). DO NOT use for sketches, hand-drawn notes, photographed whiteboards, or any input where absolute positions matter — even if the user says 'diagram' — use create(type:'board') instead (see how_to('board')). Mind maps: pass data.markdown directly (no how_to needed). Sequence diagrams: use data.diagram with arrow syntax (A -> B: msg, A --> B: dashed, A ->> B: open arrow) — no how_to needed for basic diagrams. Flowcharts: MUST call how_to('flowchart') first for the structured format.
generate_mind_map
ChatGPTGenerate a Whimsical mind map from indented text. Format: first line is root, children use '- ' bullets, indent 2 spaces per level. Example: 'Root Topic\n- Child 1\n - Grandchild\n- Child 2'
generate_wireframe
ChatGPTGenerate a Whimsical wireframe with flexbox layout — containers, buttons, inputs, images, icons. IMPORTANT: ALWAYS call how_to('wireframe') first and use the Whimsical-specific syntax — wireframes use a flexbox DSL that requires the correct format.
get_board_items
ChatGPTFetch board objects for Whimbed rendering in the widget.
get_theme_data
ChatGPTFetch the board theme's dark color map for Whimbed rendering in the widget.
how_to
ChatGPTLook up Whimsical-specific syntax, examples, and guides. MUST call before creating flowcharts or wireframes. NOT needed for mind maps (pass data.markdown) or simple sequence diagrams (use arrow syntax in data.diagram). Call with no args to see available topics and stamps.
list_workspaces
ChatGPTList all workspaces the user belongs to. Returns workspace IDs, names, and role. Role is "member" (can create content) or "guest" (read-only — cannot create or modify content).
move
ChatGPTMove a Whimsical file, folder, or doc into another folder or doc — for reorganising a workspace or archiving finished work. Pass ids from a previous file_tree or search result. The destination must be a folder, a multipage, a section, a team, or a doc — not a board. Moving into a doc nests the item at the end of the doc; reposition it with the edit tool's move_block. Moving out of a doc removes it from the doc. Both items must live in the same workspace.
search
ChatGPTSearch workspace files and content by name or full text.
wireframe_edit
ChatGPTReflow or edit Whimsical wireframe elements. Use how_to('wireframe-edit') for syntax.
create
Claudedoc_create
Claudeedit
Claudefetch
Claudefile_tree
Claudegenerate_diagram
Claudegenerate_mind_map
Claudegenerate_wireframe
Claudehow_to
Claudelist_workspaces
Claudesearch
Claude
