Builds diagrams from Kubernetes manifests, allowing visualization of cluster resources.
Exports diagrams to Mermaid syntax for use in Markdown or other Mermaid-compatible tools.
Builds diagrams from Terraform code, enabling visualization of infrastructure resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LetDraw MCP create a diagram from this docker-compose file"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LetDraw is a hand-drawn–style online whiteboard and diagramming app. With this integration an MCP client (Claude, Cursor, VS Code, Codex, …) or any HTTP client can list workspaces, create and update diagrams, build a diagram from code (compose / Kubernetes / DOT / Terraform / SQL / …), stamp real product icons, export to Mermaid or D2, and share read-only links.
This repository ships the client-side integration: a zero-config MCP bridge, a typed REST SDK, the API spec, and setup docs. The LetDraw app and server are not part of this repo.
Path | What it is |
| |
| |
The MCP tools, resources, and scopes | |
OpenAPI 3.1 spec for the REST API | |
"How to draw well in LetDraw" guide for AI clients | |
Getting started + per-client setup (Claude, Cursor, VS Code, Codex) | |
Copy-paste recipes |
Related MCP server: Draw.io MCP Server
REST base https://api.letdraw.com/api-v1
MCP URL https://api.letdraw.com/mcpBoth authenticate with a personal API token (Authorization: Bearer ld_live_…), not a login session. Create one in the LetDraw app under
Account → Developer. The exact URLs and a ready-to-paste client config are
shown there too.
The hosted server speaks Streamable-HTTP, so most clients connect directly. For a stdio client, or for the simplest possible setup, use the bridge:
// Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"letdraw": {
"command": "npx",
"args": ["-y", "@letdraw/mcp"],
"env": { "LETDRAW_TOKEN": "ld_live_YOUR_TOKEN" }
}
}
}See docs/clients for Cursor, VS Code, Claude Code and Codex.
curl https://api.letdraw.com/api-v1/workspaces \
-H "Authorization: Bearer ld_live_YOUR_TOKEN"Or with the SDK:
import { LetdrawClient } from '@letdraw/sdk';
const ld = new LetdrawClient({ token: process.env.LETDRAW_TOKEN! });
const { workspaces } = await ld.listWorkspaces();Tokens carry scopes; each tool/route requires one:
diagrams:read — list/get workspaces, folders, diagrams, icons
diagrams:write — create/update/delete/share diagrams, from-code
export — export to Mermaid / D2
ai:generate — generate a diagram from a prompt (uses your own AI key)
MIT — see LICENSE. "LetDraw" and the LetDraw logo are trademarks of their owner; see NOTICE.md.
This server cannot be deployed
Create and manage Mermaid.js flowcharts and diagrams with AI agents via MCP.
Create workflow, sequence, architecture, and mind map diagrams via AI assistants.
Generate org charts, MCD/ERD data models, and C4 architecture diagrams — pilot OrgGen AI via MCP.
Create and edit collaborative architecture diagrams with any AI assistant using the Trident 2D DSL.
