Skip to content
Weavz
Menu
Whimsical

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.

19 tools
2 triggers
Use withChatGPTClaudeClaude CodeCursorCodexMCP clientsSetup guide

Tools

Name
get_user

Get Whimsical user information by user ID

list_teams

List Whimsical teams in the workspace

list_comments

List comments on a Whimsical item

list_files

List files within a Whimsical file, folder, section, or team

get_file

Get Whimsical file information and optional doc content

list_mcp_tools

List tools exposed by the official Whimsical MCP server

call_mcp_tool

Call any official Whimsical MCP tool with JSON arguments

mcp_search

Search across Whimsical files, folders, sections, and board content

mcp_fetch

Read a Whimsical board, doc, or folder by ID

mcp_create

Create a Whimsical board, diagram, wireframe, sticky note set, table, or stamp

mcp_create_doc

Create a Whimsical doc with markdown content

mcp_edit

Add, update, or delete objects on an existing Whimsical board or doc

mcp_wireframe_edit

Reflow or edit elements of an existing Whimsical wireframe

mcp_auto_layout

Re-arrange a Whimsical flowchart using automatic layout

mcp_file_tree

Browse the Whimsical workspace folder hierarchy

mcp_list_workspaces

List Whimsical workspaces available to the connected account

mcp_read_comments

Read Whimsical comment threads on a board or doc

mcp_edit_comment

Create, reply to, edit, resolve, reopen, or delete a Whimsical comment thread

custom_api_call

Call any Whimsical REST API beta endpoint

Triggers

Name
file_changed

Poll files under a Whimsical parent item and emit new or changed files after the initial baseline

comment_changed

Poll comments on a Whimsical item and emit new or changed comments after the initial baseline

Quick Start

TypeScript
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.