Whimsical
Read Whimsical workspace content through the REST API beta and create/edit/search visual files through the official Whimsical MCP server
Tools
| Name | Description |
|---|---|
get_userGet Whimsical user information by user ID | Get Whimsical user information by user ID |
list_teamsList Whimsical teams in the workspace | List Whimsical teams in the workspace |
list_commentsList comments on a Whimsical item | List comments on a Whimsical item |
list_filesList files within a Whimsical file, folder, section, or team | List files within a Whimsical file, folder, section, or team |
get_fileGet Whimsical file information and optional doc content | Get Whimsical file information and optional doc content |
list_mcp_toolsList tools exposed by the official Whimsical MCP server | List tools exposed by the official Whimsical MCP server |
call_mcp_toolCall any official Whimsical MCP tool with JSON arguments | Call any official Whimsical MCP tool with JSON arguments |
mcp_searchSearch across Whimsical files, folders, sections, and board content | Search across Whimsical files, folders, sections, and board content |
mcp_fetchRead a Whimsical board, doc, or folder by ID | Read a Whimsical board, doc, or folder by ID |
mcp_createCreate a Whimsical board, diagram, wireframe, sticky note set, table, or stamp | Create a Whimsical board, diagram, wireframe, sticky note set, table, or stamp |
mcp_create_docCreate a Whimsical doc with markdown content | Create a Whimsical doc with markdown content |
mcp_editAdd, update, or delete objects on an existing Whimsical board or doc | Add, update, or delete objects on an existing Whimsical board or doc |
mcp_wireframe_editReflow or edit elements of an existing Whimsical wireframe | Reflow or edit elements of an existing Whimsical wireframe |
mcp_auto_layoutRe-arrange a Whimsical flowchart using automatic layout | Re-arrange a Whimsical flowchart using automatic layout |
mcp_file_treeBrowse the Whimsical workspace folder hierarchy | Browse the Whimsical workspace folder hierarchy |
mcp_list_workspacesList Whimsical workspaces available to the connected account | List Whimsical workspaces available to the connected account |
mcp_read_commentsRead Whimsical comment threads on a board or doc | Read Whimsical comment threads on a board or doc |
mcp_edit_commentCreate, reply to, edit, resolve, reopen, or delete a Whimsical comment thread | Create, reply to, edit, resolve, reopen, or delete a Whimsical comment thread |
custom_api_callCall any Whimsical REST API beta endpoint | Call any Whimsical REST API beta endpoint |
Triggers
| Name | Description |
|---|---|
file_changedPoll files under a Whimsical parent item and emit new or changed files after the initial baseline | Poll files under a Whimsical parent item and emit new or changed files after the initial baseline |
comment_changedPoll comments on a Whimsical item and emit new or changed comments after the initial baseline | Poll comments on a Whimsical item and emit new or changed comments after the initial baseline |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('whimsical', 'get_user', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'whimsical',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Whimsical to my app?
Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Whimsical support?
Whimsical supports 19 tools including Get User, List Teams, List Comments, List Files, Get File, and more.
Can I use Whimsical with AI agents?
Yes. Add Whimsical to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Whimsical to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Whimsical as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Whimsical tools exposed by that workspace.
Does Whimsical work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Whimsical work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Whimsical?
Whimsical exposes 19 tools, including Get User, List Teams, List Comments, List Files, Get File, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Whimsical be used in stateful agent workflows?
Yes. Agents can combine Whimsical tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Whimsical use?
Whimsical uses Custom. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Whimsical integration cost?
The Whimsical integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Whimsical support?
Whimsical supports 2 triggers including File Changed, Comment Changed.
Connect Whimsical in minutes
Get 20,000 free action executions every month. No credit card required.