whimsical.com
whimsical.com logo

Whimsical

Integrates with Whimsical's API to generate diagrams from Mermaid markup, returning both diagram URLs and base64 encoded...

Created byApr 23, 2025

Whimsical MCP Server

[![smithery badge](https://smithery.ai/badge/BrockReece/whimsical-mcp-server)](https://smithery.ai/server/BrockReece/whimsical-mcp-server)
A Model Context Protocol (MCP) server that enables the creation of Whimsical diagrams programmatically. This server integrates with Whimsical's API to generate diagrams from Mermaid markup.

Demo

Here's an example of a complex system architecture diagram created using this MCP server and Claude - it shows the Model Context Protocol (MCP) architecture itself:
![MCP Architecture](./docs/mcp_demo.png)

Features

  • Create Whimsical diagrams using Mermaid markup generated by the MCP Client (Claude, Windsurf, etc.)
  • Returns both the Whimsical diagram URL and a base64 encoded image to allow the Client to iterate on it's original markup

Installation

Installing via Smithery

To install Whimsical MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/BrockReece/whimsical-mcp-server):

Manual Installation

Integration with MCP Client

Update the MCP Client's config to point to this repository's dist folder eg:

License

This project is licensed under the MIT License.