Whimsical

Productivityby Whimsical, Inc.

Launched Apr 13, 2026 on ChatGPT

Whimsical is the whiteboard for thinking and planning. It’s built for teams to move from chaos to clarity and turn ideas into action with Boards for diagramming, mindmapping, wireframing, and whiteboarding

It’s faster than heavy design tools built for high-fidelity prototyping and simpler than complex diagramming software tailored for formal documentation, so you go from 0 to 1 in record time.

Whether you’re collaborating with your team, external stakeholders or clients, Whimsical lets you communicate high-level ideas without worrying about the pixels. Turn abstract concepts and messy thoughts into “aha moments” of shared understanding, and keep everybody aligned and moving in the same direction.

13ChatGPT Tools

Whimsical, Inc.Developer

ProductivityCategory

Available Tools

Create

create

Full Description

Create content in Whimsical — docs, diagrams, folders, or boards with content. Do NOT create an empty board — instead use a specific type (flowchart, mindmap, etc.) which auto-creates a board. 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.

Parameters (1 required, 7 optional)

Required

typestring

What to create. Prefer specific types (flowchart, mindmap, sequence_diagram, wireframe, sticky_notes) which auto-create a board. Only use 'board' to create an empty board when explicitly asked.

Options:boarddocfolderflowchartmindmapsequence_diagramsticky_notestablewireframestamp

Optional

board_idstring

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

data

Content payload. 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

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 with markdown — headings, lists, links, and code blocks.

Parameters (0 required, 3 optional)

Optional

data

Document content as a markdown string.

parent_idstring

Folder ID to create in. Defaults to Private section.

titlestring

Document title

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

Generate a Whimsical diagram — flowchart, mind map, or sequence diagram. 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, 4 optional)

Required

typestring

Diagram type to generate

Options:flowchartmindmapsequence_diagramsticky_notes

Optional

board_idstring

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

data

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

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, 4 optional)

Optional

board_idstring

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

data

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

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, 4 optional)

Optional

board_idstring

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

data

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

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 and names.

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