Whimsical MCP integration
Read Whimsical workspace content through the REST API beta and create/edit/search visual files through the official Whimsical MCP server
Sign in, add Whimsical in Apps, then choose the account your AI can use.
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
Is there a Whimsical MCP server through Weavz?
Yes. Add the Whimsical integration to a Weavz workspace, enable the actions you need and connect any required account. Weavz provides the workspace MCP endpoint in Tool Mode or Code Mode. The catalog currently lists 19 Whimsical actions.
What can an AI agent do with Whimsical?
Available actions include Get User, List Teams, List Comments, List Files, Get File, and more. Your workspace exposes only the actions you enable. The agent also needs the intended account access and any required input values.
How do I connect Whimsical to Claude or ChatGPT?
Use a compatible remote MCP client, add the Weavz connector and choose a workspace. Add Whimsical, connect the required account and review the enabled actions. Client availability and account requirements vary; adding the connector does not authorize every app automatically.
Can I use Whimsical through an API or SDK?
Yes, supported actions can run through the Weavz REST API, TypeScript SDK or Python SDK. Configure a workspace and the required connections, use scoped access, and pass the intended end-user context when acting for a customer.
What authentication does Whimsical require?
The catalog lists custom credentials for Whimsical. Use Hosted Connect to authorize the intended account. Required permissions, provider app access and available connection methods depend on the integration.
How do I review sensitive Whimsical actions?
Limit enabled actions, scope credentials to the intended user and configure Human Gates for the operations that need review. A matching policy can pause a send, record change or other sensitive action for an approver before execution.
What limits or costs apply to Whimsical?
Weavz plan limits apply to the actions and resources you use. The external provider may also require an account, a paid plan, API credits or specific permissions, and may enforce its own rate limits. Check current Weavz pricing and the provider’s terms before rollout.
What Whimsical triggers are available?
The catalog lists 2 triggers, including File Changed, Comment Changed. Configure the trigger and your event handler before using incoming events to start work.
Connect Whimsical in minutes
Get 20,000 free action executions every month. No credit card required.