Whimsical — Claude Code MCP server: features and setup
Create and update Whimsical boards and docs through an AI agent. Use it to turn a request into a diagram or find material in your workspace.
claude mcp add --transport http mcp https://mcp.whimsical.com/mcpWhat Whimsical does
Whimsical turns a prompt into an editable board. Ask for a flowchart, sequence diagram, mind map, or wireframe, then open the result in Whimsical. The server can also search workspace content, read boards and docs, modify diagrams, and handle comments.
Whimsical hosts the server, which connects over HTTP. Sign-in uses OAuth 2.1 with PKCE, so there is no API key to manage. In Claude Code, add it with claude mcp add --transport http whimsical https://mcp.whimsical.com/mcp, then authenticate through /mcp. The free plan allows up to 50 board objects per month; paid plans have no object limit.
What it helps with
- turn a user journey into a flowchart
- map the steps in an OAuth sequence
- outline ideas for a mobile app as a mind map
- find workspace boards and docs by topic
- change a diagram and leave a team comment
Example prompts for the agent
- Create a Whimsical flowchart for user registration, including input checks and the path to the home page.
- Search my Whimsical workspace for API architecture material and summarize the results.
- Add a rate-limiting step to the API diagram and leave a comment asking the team to review the change.
How to install Whimsical
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.whimsical.com/mcpPlatform CLI: remote server
codex mcp add whimsical --url https://mcp.whimsical.com/mcpConfig file
{
"mcpServers": {
"whimsical": {
"url": "https://mcp.whimsical.com/mcp"
}
}
}Config file
{
"servers": {
"whimsical": {
"type": "http",
"url": "https://mcp.whimsical.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http whimsical https://mcp.whimsical.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Whimsical
How do I install Whimsical in Codex?
Run codex mcp add whimsical --url https://mcp.whimsical.com/mcp, then sign in to Whimsical when the client asks you to authorize.
What does Whimsical do?
This MCP server lets an agent create and edit Whimsical boards and docs, search workspace content, and manage comments.
Do I need an API key to connect Whimsical?
No. Authentication uses OAuth 2.1 with PKCE, and the server connects over remote HTTP.
