# Mcp Server Guide

> Whimsical MCP Server Guide - connect AI agents to your Whimsical workspace

- **Type:** MCP server
- **Install:** `agentstack add mcp-whimsicalcode-mcp-server-guide`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [WhimsicalCode](https://agentstack.voostack.com/s/whimsicalcode)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [WhimsicalCode](https://github.com/WhimsicalCode)
- **Source:** https://github.com/WhimsicalCode/mcp-server-guide

## Install

```sh
agentstack add mcp-whimsicalcode-mcp-server-guide
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Whimsical MCP Server Guide

The Whimsical MCP server gives your AI coding agent a Whimsical workspace to work in. Ask it to create flowcharts, mind maps, wireframes, sequence diagrams, or sticky notes from your conversation. Iterate with follow-up prompts, open a board in Whimsical to edit and share it, or search your workspace for boards to reference.

For full documentation, see the [Whimsical MCP docs](https://help.whimsical.com/integrations/remote-mcp).

## Features

- **Create boards and diagrams.** Generate flowcharts, mind maps, sequence diagrams, and wireframes from your AI agent.
- **Edit existing content.** Modify boards, add or remove shapes, update text, and rearrange layouts.
- **Search your workspace.** Find files by name or content.
- **Read board content.** Extract structured data from existing boards for context.
- **Create and edit docs.** Write and update Whimsical docs.

## Installation & Setup

### Cursor

1. Open **Cursor → Settings → Cursor Settings**.
2. Go to the **MCP** tab.
3. Click **+ Add new global MCP server**.
4. Enter the following configuration and save:

```json
{
  "mcpServers": {
    "whimsical": {
      "url": "https://mcp.whimsical.com/mcp"
    }
  }
}
```

For more information, see [Cursor's official documentation](https://docs.cursor.com/context/model-context-protocol).

### Claude Code

Run the following command to add the Whimsical MCP server:

```bash
claude mcp add --transport http whimsical https://mcp.whimsical.com/mcp
```

### Claude.ai

Connect directly from the [Anthropic Connectors Directory](https://claude.ai/connectors).

### ChatGPT (VS Code / Copilot)

1. Use the shortcut `⌘ Shift P` to search for `MCP: Add Server`.
2. Select `HTTP`.
3. Paste the server URL `https://mcp.whimsical.com/mcp` in the search bar. Then hit `Enter`.
4. When you're prompted for a server ID, enter `whimsical`.
5. Select whether you want to add this server globally or only for the current workspace.

### Other editors

Any code editor or tool that supports Streamable HTTP can connect to the Whimsical MCP server using this configuration:

```json
{
  "mcpServers": {
    "whimsical": {
      "url": "https://mcp.whimsical.com/mcp"
    }
  }
}
```

## Authentication

The Whimsical MCP server uses OAuth 2.0. When you first connect, you'll be redirected to sign in with your Whimsical account and authorize access to your workspace.

## Troubleshooting

- **OAuth doesn't open or fails.** Run `/mcp` in Claude Code (or the equivalent reconnect action in your client) to reauthenticate. The browser will redirect back to your client once you've signed in to Whimsical.
- **Tools don't appear after install.** Run `/reload-plugins` in Claude Code, or restart your editor in other clients.
- **`401` or "Missing Bearer token".** Your OAuth session has expired. Reauthenticate via `/mcp`.
- **No Whimsical account.** Create one at ; the MCP server signs you in to your existing workspace via OAuth.

## Examples

### Create a flowchart from a description

**Prompt:** "Create a flowchart in Whimsical showing a user authentication flow: login page → validate credentials → if valid go to dashboard, if invalid show error and retry"

The agent creates a new board in your workspace with the complete flowchart, including decision nodes, connectors, and labels.

### Generate a mind map for brainstorming

**Prompt:** "Create a mind map in Whimsical to brainstorm features for a mobile app, with branches for onboarding, core features, monetization, and growth"

The agent creates a mind map with the central topic and its branches.

### Create a wireframe for a new feature

**Prompt:** "Create a wireframe in Whimsical for a settings page with a sidebar navigation, a profile section with avatar and form fields, and a danger zone at the bottom"

The agent creates a wireframe with the UI elements laid out to represent the page structure.

### Create a technical architecture diagram

**Prompt:** "Create a technical diagram in Whimsical showing the architecture of my ACME project: a React frontend talks to an API gateway, which routes to auth, billing, and notification microservices, each with their own database"

The agent creates a board with labeled components, service boundaries, and connectors showing the data flow between systems.

### Search and read existing boards

**Prompt:** "Search my Whimsical workspace for anything related to 'API design' and summarize what you find"

The agent searches your workspace, reads the matching boards, and summarizes them.

## Support

- **Documentation:** https://help.whimsical.com/integrations/remote-mcp
- **Report Issues:** Contact Whimsical support at support@whimsical.com
- **Privacy Policy:** https://whimsical.com/terms/privacy

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [WhimsicalCode](https://github.com/WhimsicalCode)
- **Source:** [WhimsicalCode/mcp-server-guide](https://github.com/WhimsicalCode/mcp-server-guide)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-whimsicalcode-mcp-server-guide
- Seller: https://agentstack.voostack.com/s/whimsicalcode
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.