Whimsical
Read Whimsical workspace content through the REST API beta and create/edit/search visual files through the official Whimsical MCP server
Actions
| 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/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 actions programmatically.
What actions does Whimsical support?
Whimsical supports 19 actions 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.
Can Whimsical be used in stateful agent workflows?
Yes. Agents can combine Whimsical actions 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 actions every month. No credit card required.