# Whimsical

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: WhimsicalCode
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WhimsicalCode/mcp-server-guide
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/whimsical

## What it 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.

## Requirements
- Remote server: `https://mcp.whimsical.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.whimsical.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add whimsical --url https://mcp.whimsical.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whimsical": {
            "url": "https://mcp.whimsical.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whimsical": {
            "type": "http",
            "url": "https://mcp.whimsical.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http whimsical https://mcp.whimsical.com/mcp
```

## When to use it
- 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
- 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.

## Similar
- [hand-drawn-diagrams](https://affpapa.org/en/nevibecode/skills/muthuishere-hand-drawn-diagrams.md) — skill · 620 installs
- [claude-design](https://affpapa.org/en/nevibecode/skills/claude-design.md) — skill · 2200 installs
- [prototype-strategy](https://affpapa.org/en/nevibecode/skills/prototype-strategy.md) — skill · 2100 installs
- [om-mockup-prototype](https://affpapa.org/en/nevibecode/skills/om-mockup-prototype.md) — skill · 1500 installs
- [ui-ux](https://affpapa.org/en/nevibecode/skills/ui-ux.md) — skill · 884 installs
- [mobile-first-website-design](https://affpapa.org/en/nevibecode/skills/mobile-first-website-design.md) — skill · 318 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md