Whimsical

Name: Whimsical
Author: whimsical

Whimsical's official MCP server.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

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 arro
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:'
Doc Create: Create a Whimsical document. Markdown content — headings, lists, links, code blocks. For diagrams, boards, or folders, use `create`.

What data it sees

Do you need an account

No: the server works without sign-in

Whimsical's official MCP server. Create and edit boards, docs, flowcharts, mind maps, sequence diagrams, wireframes, tables and sticky notes, then read, search and comment on anything already in the workspace.

Tools — create, edit, wireframe_edit, auto_layout, delete, doc_create for writes; fetch, search, file_tree, list_workspaces, get_board_items, comment_read, comment_edit, how_to for reads.

Auth — OAuth 2.1 with PKCE. No API key, no configuration. A free Whimsical account can use every tool.

Docs: https://whimsical.com/learn/integrations/mcp

How to connect

How to connect Whimsical to Claude

The server address to paste into Claude settings:

https://whimsical.run.tools

Open Claude (claude.ai or the desktop app).
Go to Settings → Connectors.
Click Add custom connector.
Paste the server address copied below into Remote MCP server URL and click Add.
In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Whimsical to ChatGPT

The server address to paste into ChatGPT settings:

https://whimsical.run.tools

Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
Open Settings → Connectors and click Create.
Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Whimsical to Cursor

The server address to paste into Cursor settings:

https://whimsical.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (18)

Raw names from tools/list. Only developers need these.

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 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`.
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. Flowcharts: MUST call how_to('flowchart') first for the structured format.
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 to reorder any block, nests included, without changing its ID. Use how_to('edit') for advanced syntax (table columns, group ops, doc table ops).
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 id (root or reply) to fetch that single thread, and add `cell_id` to narrow to a single table cell on that row.
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 thread (thread_id) - delete: delete a comment (comment_id)