Whimsical’s Remote MCP (Model Context Protocol) server can be used in AI chat apps, like ChatGPT, Claude, or Cursor. It gives them secure access to read and write content in your Whimsical workspace, so you can work together to:

• Visualize complex processes on a Whimsical board.
• Map your SOPs with flowcharts.
• Generate wireframes from prompts or code.
• Code working prototypes from your Whimsical wireframes.
• And more...

This doc should get you started using Whimsical remotely with your AI agent - use the list on the right to jump to specific setup instructions.

If you run into any trouble or have questions, just reach out to our support team.

Step 1: Set up your MCP clientCopied!Link to this section

Follow the instructions below for your specific client to add Whimsical’s MCP server.

Claude.ai (in your browser)Copied!Link to this section

1. Open Settings → Connectors
2. Click Add Connector and enter the URL https://mcp.whimsical.com/mcp
3. Authenticate with your Whimsical account

CursorCopied!Link to this section

1. Open Cursor → Settings → Cursor Settings.
2. Go to Tools & MCP.
3. Click Add custom MCP or + New MCP server.
4. Enter the following configuration and save:

ChatGPTCopied!Link to this section

1. Enable Developer Mode:
   - Open ChatGPT and go to Settings → Connectors
   - Under Advanced, enable Developer Mode (if it’s missing, you may be on a team account without permission to enable it.)
2. Create Connector:
   - In Settings → Connectors, click Create
   - Enter Name: Whimsical, Server URL: https://mcp.whimsical.com/mcp
- Check I trust this provider
   - Authenticate with your Whimsical account (will open a new tab)
   - Click Create
3. Use in Chat:
   - Start a new chat
   - Click the + button
   - Enable your Whimsical MCP server connector (The connector must be explicitly added to each chat)

Other clientsCopied!Link to this section

With so many other tools now supporting MCP servers, you can configure them to use Whimsical’s remote MCP server with the following values:

• Name: whimsical-remote
• URL: https://mcp.whimsical.com/mcp

Step 2: AuthenticationCopied!Link to this section

The MCP server requires OAuth authentication with your Whimsical account. You’ll need:

• An active Whimsical account.
• That’s all!

Step 3: Verify the connectionCopied!Link to this section

• Send a prompt like “What Whimsical tools do you have available?” If the MCP is connected, you’ll get a list of tools such as create_diagram, search_files etc.
• You can always check directly on the MCP settings page in Claude, ChatGPT, or Cursor

Step 4: Prompt your MCP clientCopied!Link to this section

Start a new chat and ask it to do things in Whimsical. To get started, you can ask it “What can you do with Whimsical MCP?”. 👌

So, what can it do?Copied!Link to this section

Create process or sequence diagramsCopied!Link to this section

Ask your AI to turn technical processes into visual diagrams in Whimsical. Try prompts like “Create a flowchart of a typical OAuth flow”, “Create a diagram of how Slack decides to send a notification”, or “Generate a sequence diagram showing how API requests are processed”.

You’ll see:

• MCP server creates a new file in your workspace
• Generates a flowchart or sequence diagram based on the provided context
• Provides a preview of the created content directly in the chat where you can see and interact with the output

Search and reference your Whimsical filesCopied!Link to this section

Your AI can search and read Whimsical files so you can reference them in context. Try “Find the system architecture diagram I made last month” or “Summarize the user flow we mapped out in Whimsical”.

You’ll see:

• MCP server searches all files in your workspace
• Finds a matching file (or files)
• Returns links to the matching files, or embeds them directly in the chat
• Generates the summary you requested

Plan and brainstorm visuallyCopied!Link to this section

Use your AI to create mind maps, wireframe outlines, and planning documents directly in Whimsical. Try “Create a mind map of the key features for this project” or “Make a wireframe outline for a new settings page”.

You’ll see:

• MCP server creates a new file in your workspace
• Generates a mind map or wireframe based on the provided context
• Provides an embed and link direct in the chat where you can see and interact with the output

PrivacyCopied!Link to this section

See Whimsical’s privacy policy here: https://whimsical.com/terms/privacy

If you have any trouble at all, or have questions, just reach out to our support team.