Whimsical

Name: Whimsical
Author: whimsical

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

该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链

接入信息

传输形态: http
鉴权方式: 鉴权未知
端点: https://whimsical.run.tools

鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段

{
  "mcpServers": {
    "Whimsical": {
      "url": "https://whimsical.run.tools"
    }
  }
}

能力清单

工具	说明
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)

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。