Whimsical
Whimsical's official MCP server.
Что умеет
- 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`.
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
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.
Как подключить
Как подключить Whimsical к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://whimsical.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Whimsical к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://whimsical.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Whimsical к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://whimsical.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (18)
Технические названия из tools/list. Нужны только разработчикам.
| 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) |