Whimsical
About
Let AI take control of your visual workspace for brainstorming, flowcharts, mind maps, wireframes, and technical diagrams.
Details
- Transport
- SSE
Explore
how_to
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. Pass `domain` for structured JSON lookups (icons/colors/font-sizes/kinds) instead of markdown topics.
create
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…
doc_create
Create a Whimsical document. Markdown content — headings, lists, links, code blocks. For diagrams, boards, or folders, use `create`.
generate_diagram
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. Flowchart…
generate_mind_map
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'
generate_wireframe
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.
delete
Move 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.
edit
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 (update/delete/move/insert_after/append/layout) to edit mindmap nodes in place; sd_update for sequence diagrams. Docs: update_block/insert_after_block/append_blocks/delete_block (all markdown); insert_nest to nest a new board, doc, folder or tabbed-folder inside the doc; move_block …
search
Search workspace files and content by name or full text.
fetch
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.
file_tree
Browse the workspace file hierarchy. With no arguments, lists the Private, Shared, and team sections (teams are sections within a workspace, not separate workspaces) plus the folders and files inside each. Pass filter="teams" to list just the teams (name + id). Pass folder_id — a folder, section, or team id — to list the tree below that parent.
list_workspaces
List all workspaces the user belongs to, with the teams in each. Returns workspace IDs, names, role ("member" can create content / "guest" is read-only), and each workspace's teams (id + name). Teams are sections within a workspace — pass a team id as parent_id to create content in that team.
get_board_items
Fetch board objects for Whimbed rendering in the widget.
get_theme_data
Fetch the board theme's dark color map for Whimbed rendering in the widget.
wireframe_edit
Reflow or edit Whimsical wireframe elements. Use how_to('wireframe-edit') for syntax.
auto_layout
Re-arrange a Whimsical flowchart's shapes using the editor's auto-layout (ELK). Connectors re-route automatically. Use after adding shapes via `create` or `edit` to clean up the layout.
comment_read
Read comment threads on a board or doc. Returns EDNL-formatted threads with author, time, content, an `:on` short-id that links the thread to its parent object/block/row (on docs this covers text-selection and whole-block comments; omitted for file-level and doc-title threads), and a `:cell` short-id when the thread targets a specific table cell (column UUID). Pass `item_id` as a board or doc id to read every thread, as a board-object / doc-block / table-row id to filter to that anchor, as a …
comment_edit
Create, reply, edit, resolve, unresolve, or delete comment threads. Content is markdown — paragraphs, lists, links. Returns the updated thread in EDNL format. Edit and delete are author-only. Actions: - create: new thread on a board, doc, board object, or table cell (item_id + content; pass cell_id when item_id is a table row) - reply: add a reply (thread_id + content) - edit: edit a comment's content (comment_id + content) - resolve: mark thread resolved (thread_id) - unresolve: reopen thre…
Search and reference your Whimsical files
Your AI can search and read Whimsical files so you can reference them in context. Try “Find the system architecture diagram I made last month” or “Summarize the user flow we mapped out in Whimsical”.
- MCP server searches all files in your workspace
- Finds a matching file (or files)
- Returns links to the matching files, or embeds them directly in the chat
- Generates the summary you requested
Use your AI to create mind maps, wireframe outlines, and planning documents directly in Whimsical. Try “Create a mind map of the key features for this project” or “Make a wireframe outline for a new settings page”.
- MCP server creates a new file in your workspace
- Generates a mind map or wireframe based on the provided context
- Provides an embed and link direct in the chat where you can see and interact with the output
This article covers Whimsical's remote MCP - the recommended option for most people.
Remote MCP connects AI tools such as ChatGPT, Claude, and Cursor to Whimsical via our hosted MCP server. There's nothing to install, and it works anywhere your AI assistant supports remote MCP servers.
If you'd rather run MCP locally, you can use our desktop MCP instead. It runs through the Whimsical desktop app and can give AI coding tools access to files and code on your machine — useful for agents like Claude Code, Codex, and Copilot. The Whimsical desktop app has to be open for it to work.
To set up the desktop MCP, just](https://mcp.whimsical.com/mcp)reach out to our support team.
- Whimsical MCP
- Step 1: Set up your MCP client
- Claude
- ChatGPT
- Cursor
- Other clients
- Step 2: Authentication
- Step 3: Verify the connection
- Step 4: Prompt your MCP client
- Create process or sequence diagrams
- Search and reference your Whimsical files
- [Plan and brainstorm visually
Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.
Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar
Automated document processing and extraction
Create notes, search, & think with your Fabric AI workspace
Perform queries and entity operations in your Fibery workspace.
Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.
Turn your Make scenarios into callable tools for AI assistants.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
