{
  "markdown": "# Whimsical MCP Server Guide\n\nThe 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.\n\nFor full documentation, see the [Whimsical MCP docs](https://help.whimsical.com/integrations/remote-mcp).\n\n## Features\n\n- **Create boards and diagrams.** Generate flowcharts, mind maps, sequence diagrams, and wireframes from your AI agent.\n- **Edit existing content.** Modify boards, add or remove shapes, update text, and rearrange layouts.\n- **Search your workspace.** Find files by name or content.\n- **Read board content.** Extract structured data from existing boards for context.\n- **Create and edit docs.** Write and update Whimsical docs.\n\n## Installation & Setup\n\n### Cursor\n\n1. Open **Cursor → Settings → Cursor Settings**.\n2. Go to the **MCP** tab.\n3. Click **+ Add new global MCP server**.\n4. Enter the following configuration and save:\n\n```json\n{\n  \"mcpServers\": {\n    \"whimsical\": {\n      \"url\": \"https://mcp.whimsical.com/mcp\"\n    }\n  }\n}\n```\n\nFor more information, see [Cursor's official documentation](https://docs.cursor.com/context/model-context-protocol).\n\n### Claude Code\n\nRun the following command to add the Whimsical MCP server:\n\n```bash\nclaude mcp add --transport http whimsical https://mcp.whimsical.com/mcp\n```\n\n### Claude.ai\n\nConnect directly from the [Anthropic Connectors Directory](https://claude.ai/connectors).\n\n### ChatGPT (VS Code / Copilot)\n\n1. Use the shortcut `⌘ Shift P` to search for `MCP: Add Server`.\n2. Select `HTTP`.\n3. Paste the server URL `https://mcp.whimsical.com/mcp` in the search bar. Then hit `Enter`.\n4. When you're prompted for a server ID, enter `whimsical`.\n5. Select whether you want to add this server globally or only for the current workspace.\n\n### Other editors\n\nAny code editor or tool that supports Streamable HTTP can connect to the Whimsical MCP server using this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"whimsical\": {\n      \"url\": \"https://mcp.whimsical.com/mcp\"\n    }\n  }\n}\n```\n\n## Authentication\n\nThe 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.\n\n## Troubleshooting\n\n- **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.\n- **Tools don't appear after install.** Run `/reload-plugins` in Claude Code, or restart your editor in other clients.\n- **`401` or \"Missing Bearer token\".** Your OAuth session has expired. Reauthenticate via `/mcp`.\n- **No Whimsical account.** Create one at <https://whimsical.com>; the MCP server signs you in to your existing workspace via OAuth.\n\n## Examples\n\n### Create a flowchart from a description\n\n**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\"\n\nThe agent creates a new board in your workspace with the complete flowchart, including decision nodes, connectors, and labels.\n\n### Generate a mind map for brainstorming\n\n**Prompt:** \"Create a mind map in Whimsical to brainstorm features for a mobile app, with branches for onboarding, core features, monetization, and growth\"\n\nThe agent creates a mind map with the central topic and its branches.\n\n### Create a wireframe for a new feature\n\n**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\"\n\nThe agent creates a wireframe with the UI elements laid out to represent the page structure.\n\n### Create a technical architecture diagram\n\n**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\"\n\nThe agent creates a board with labeled components, service boundaries, and connectors showing the data flow between systems.\n\n### Search and read existing boards\n\n**Prompt:** \"Search my Whimsical workspace for anything related to 'API design' and summarize what you find\"\n\nThe agent searches your workspace, reads the matching boards, and summarizes them.\n\n## Support\n\n- **Documentation:** https://help.whimsical.com/integrations/remote-mcp\n- **Report Issues:** Contact Whimsical support at support@whimsical.com\n- **Privacy Policy:** https://whimsical.com/terms/privacy\n",
  "bytes": 4773,
  "sha": "7508d07f8bb8da04d93f510c4b951f5fc56c00e4b919406dffdc2ac2c33580c8",
  "repo_slug": "whimsicalcode/mcp-server-guide",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_whimsicalcode_mcp_server_guide_whimsical_e17beeaa/readme"
}