Whimsical

Productivityby Whimsical, Inc.

Open in ChatGPT Open in Claude Website

Launched Apr 29, 2026 on ChatGPTLaunched May 31, 2026 on Claude

Explain and visualize concepts with flowcharts, mindmaps, wireframes and sequence diagrams.

13ChatGPT Tools

11Claude Tools

Whimsical, Inc.Developer

ProductivityCategory

Use Cases

designproductivity

Available Tools

Create

create

Full Description

Create 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.

Parameters (1 required, 8 optional)

Required

typestring

What to create. Use 'board' for freeform/sketch layouts where you control absolute positions (ideal for recreating hand-drawn notes, whiteboards, or any visual layout). Use 'flowchart', 'mindmap', 'sequence_diagram', 'sticky_notes', or 'wireframe' for semantic diagrams that auto-layout.

Options:boardfolderflowchartmindmapsequence_diagramsticky_notestablewireframestamp

Optional

board_idstring

Add to existing board. Omit to create new board. Required for wireframe.

dataobject

Content payload. Board (freeform layout): {items: [{type:"text"|"shape"|"note"|"conn"|"icon"|"link", text, x, y, ...}], groups?: [...]}. Field names are snake_case: shape_type, from_id, to_id, temp_id, font_size, icon_name (NOT camelCase). Only emit conn items for arrows actually present in the source — do not invent connectors. Call how_to('board') for the full schema and examples. Mindmap: {markdown: "Root\n- Child\n - Grandchild"} (indented bullets). Flowchart/sequence_diagram: call how_to(type) for syntax. Wireframe: call how_to('wireframe') for flexbox DSL. Table: {markdown: "| A | B |\n|---|---|\n| 1 | 2 |"} or {columns: ["A","B"], rows: [["1","2"]]}.

parent_idstring

Folder ID (base58) to create in. Use file_tree to browse folders. Defaults to Private section.

placementobject

Position relative to a previous diagram's bbox (returned in every creation response). Use direction 'right' or 'below' to build grids. Mutually exclusive with x/y.

titlestring

Title or name for the created item

workspace_idstring

Workspace ID (UUID). Use list_workspaces to see options. Defaults to most recently active workspace.

xnumber

X position on board. Mutually exclusive with placement.

ynumber

Y position on board. Mutually exclusive with placement.

Create Document

doc_create

Full Description

Create a Whimsical document. Markdown content — headings, lists, links, code blocks. For diagrams, boards, or folders, use create.

Parameters (0 required, 4 optional)

Optional

datastring

Document content as a markdown string.

parent_idstring

Folder ID to create in. Defaults to Private section.

titlestring

Document title

workspace_idstring

Workspace ID (UUID). Use list_workspaces to see options. Defaults to most recently active workspace.

Edit

edit

Full Description

Edit 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).

Parameters (2 required)

Required

idstring

Board or doc ID (from create, fetch, or a previous tool response)

operationsarray

Array of operations to perform

Fetch Content

fetch

Full Description

Read 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.

Parameters (1 required, 12 optional)

Required

idstring

File or object ID (6-char short-id, UUID, or base58) from search results or a previous tool call

Optional

board_idstring

Parent board ID — required when fetching a table object. The table_id goes in 'id'.

crop_idsarray

Specific object IDs to crop the image to (image mode only).

detailstring

Detail level (boards only). "simple" (default): type, id, text only. "detailed": includes x, y, width, height, color, and the board's color palette.

Options:simpledetailed

expand_groupsboolean

Show all objects flat instead of collapsing groups into summaries (boards only).

grep_textarray

Filter to items whose text contains any of these terms (boards and docs, case-insensitive).

imageboolean

Return a rendered PNG image instead of text (boards only). Use scope, crop_ids, or viewport to crop.

limitinteger

Max objects/blocks to return (default: 50 for boards, 200 for docs, max: 200)

scopestring

IMPORTANT for editing: ID of a compound diagram (flowchart, mindmap, sequence diagram) to drill into. Returns the actual node/shape text instead of the board overview summary. You MUST use scope before find_replace — board overview shows summaries like 'Root (5 nodes)' that won't match actual text.

select_idsarray

Return only items with these IDs (boards and docs)

select_kindsarray

Filter by type (boards and docs). For boards: shape, note, text, icon, frame, link, task, table, attachment, image, w-annotation, sd-actor. Groups: flowchart, mindmap, wireframe, sequence-diagram, stack, section. For docs: block element tags (p, h1, h2, ul, ol, etc.).

spatialboolean

Include spatial annotations (boards only, requires detail: detailed). Default: false.

viewportobject

Bounding box in board coordinates to crop the image to (image mode only).

Browse Folder Tree

file_tree

Full Description

Browse workspace folder hierarchy.

Parameters (0 required, 3 optional)

Optional

depthinteger

How many levels deep to show (default 2, max 5)

folder_idstring

Folder or section ID (base58) to browse. Omit to see the full workspace tree.

workspace_idstring

Target workspace ID. Defaults to most recently active workspace. Use list_workspaces to see options.

Generate Diagram

generate_diagram

Full Description

Auto-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.

Parameters (1 required, 5 optional)

Required

typestring

Diagram type to generate

Options:flowchartmindmapsequence_diagramsticky_notes

Optional

board_idstring

Add to existing board. Omit to create a new board.

dataobject

Content data — format varies by type. Use how_to(type) for syntax.

parent_idstring

Folder ID to create in. Defaults to Private section.

titlestring

Title for the board

workspace_idstring

Workspace ID (UUID). Use list_workspaces to see options. Defaults to most recently active workspace.

Generate Mind Map

generate_mind_map

Full Description

Generate 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'

Parameters (0 required, 5 optional)

Optional

board_idstring

Add to existing board. Omit to create a new board.

dataobject

Mind map content as {"markdown": "Root Topic\n- Child 1\n - Grandchild\n- Child 2"}. First line is root, children use '- ' bullets, indent 2 spaces per level.

parent_idstring

Folder ID to create in. Defaults to Private section.

titlestring

Title for the board

workspace_idstring

Workspace ID (UUID). Use list_workspaces to see options. Defaults to most recently active workspace.

Generate Wireframe

generate_wireframe

Full Description

Generate 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.

Parameters (0 required, 5 optional)

Optional

board_idstring

Add to existing board. Omit to create a new board.

dataobject

Content data — format varies by type. Use how_to(type) for syntax.

parent_idstring

Folder ID to create in. Defaults to Private section.

titlestring

Title for the board

workspace_idstring

Workspace ID (UUID). Use list_workspaces to see options. Defaults to most recently active workspace.

Get Board Items

get_board_items

Full Description

Fetch board objects for Whimbed rendering in the widget.

Parameters (1 required, 3 optional)

Required

fileIdstring

Board file ID (base58 or UUID)

Optional

fieldsarray

Object fields to include (omit for all). Lightweight: rect, objectType, text, fillColor, parentId, url. Heavy: gfx, rgfx, overlayGfx, hitboxes, shadowPathD.

limitinteger

Max objects per page (omit for all)

offsetinteger

Object offset for pagination (default 0)

How To

how_to

Full Description

Look 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.

Parameters (0 required, 1 optional)

Optional

topicstring

Topic keyword (e.g. 'flowchart', 'table', 'colors') or search query

List Workspaces

list_workspaces

Full Description

List 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).

Search Workspace

search

Full Description

Search workspace files and content by name or full text.

Parameters (1 required, 2 optional)

Required

querystring

Search text

Optional

modestring

Search mode: "files" (default) searches filenames, "all" searches all content

Options:filesall

workspace_idstring

Target workspace ID. Defaults to most recently active workspace. Use list_workspaces to see options.

Edit Wireframe Layout

wireframe_edit

Full Description

Reflow or edit Whimsical wireframe elements. Use how_to('wireframe-edit') for syntax.

Parameters (2 required, 4 optional)

Required

board_idstring

Board file ID

target_idstring

Wireframe frame ID to edit (from board_read or create)

Optional

frame_typestring

Override frame type if auto-detection fails. Valid: plain, desktop, iphone-14, iphone-x, iphone-8, ipad, android, android-tablet, apple-watch

layoutobject

Layout mode: JSON layout tree for structural changes with flexbox reflow. Cannot be used with operations.

operationsarray

Operations mode: direct property edits and deletes. Cannot be used with layout.

titlestring

Frame title (preserves existing if omitted)

Links

Website Privacy Policy Terms of Service