Lets an AI client create, edit, and export hand-drawn style diagrams from code or prompts.
Also known as letdraw/letdraw-mcp, letdraw-mcp, @letdraw/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 178
- Latest version
- 1.0.1
- Last commit
- Oct 3, 2026
- License
- MIT
What is LetDraw MCP?
LetDraw lets an AI client create, edit, and export hand-drawn style diagrams from code or prompts.
Summary generated from the project's README
About LetDraw MCP server
LetDraw provides a way for AI assistants and developers to manage hand-drawn style diagrams through the Model Context Protocol or a REST API. Users can connect desktop AI applications like Cursor, VS Code, or Codex using a zero-config stdio bridge via npx @letdraw/mcp. The integration allows for listing workspaces, creating and updating diagrams, and stamping real product icons onto a digital whiteboard.
To use this server, you must provide a personal API token generated from your LetDraw account settings. The system supports building diagrams directly from code formats such as Kubernetes, Terraform, SQL, Compose, and DOT. It also enables exporting your work to Mermaid or D2 formats. Depending on your needs, you can use the typed REST SDK for scripting or the MCP bridge for direct AI client interaction.
What you can do with it
- 1Generate diagrams from codeAsk an AI client to transform infrastructure code into a visual diagram.
- 2Export visual designsConvert your hand-drawn diagrams into structured text formats.
- 3Automate diagram managementUse a script to list all available workspaces and diagrams in your account.
- 4Create diagrams from promptsInstruct an AI to draw a new diagram based on a natural language description.
Written from the project's README. Every use case is checked against a quote from it.
How to install LetDraw MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall LetDraw MCP in Claude Code
$ claude mcp add --env 'LETDRAW_TOKEN=<YOUR_LETDRAW_TOKEN>' letdraw-mcp -- npx -y @letdraw/mcpInstall LetDraw MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"letdraw-mcp": {
"command": "npx",
"args": [
"-y",
"@letdraw/mcp"
],
"env": {
"LETDRAW_TOKEN": "<YOUR_LETDRAW_TOKEN>"
}
}
}
}Install LetDraw MCP in VS Code
.vscode/mcp.json
{
"servers": {
"letdraw-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@letdraw/mcp"
],
"env": {
"LETDRAW_TOKEN": "<YOUR_LETDRAW_TOKEN>"
}
}
}
}Install LetDraw MCP in VS Code CLI
$ code --add-mcp '{"name":"letdraw-mcp","type":"stdio","command":"npx","args":["-y","@letdraw/mcp"],"env":{"LETDRAW_TOKEN":"<YOUR_LETDRAW_TOKEN>"}}'Install LetDraw MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"letdraw-mcp": {
"command": "npx",
"args": [
"-y",
"@letdraw/mcp"
],
"env": {
"LETDRAW_TOKEN": "<YOUR_LETDRAW_TOKEN>"
}
}
}
}Install LetDraw MCP in Codex
$ codex mcp add letdraw-mcp --env 'LETDRAW_TOKEN=<YOUR_LETDRAW_TOKEN>' -- npx -y @letdraw/mcpInstall LetDraw MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.letdraw-mcp] command = "npx" args = ["-y", "@letdraw/mcp"] [mcp_servers.letdraw-mcp.env] LETDRAW_TOKEN = "<YOUR_LETDRAW_TOKEN>"
Install LetDraw MCP in Gemini CLI
$ gemini mcp add -s user -e 'LETDRAW_TOKEN=<YOUR_LETDRAW_TOKEN>' letdraw-mcp npx -- -y @letdraw/mcpInstall LetDraw MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"letdraw-mcp": {
"command": "npx",
"args": [
"-y",
"@letdraw/mcp"
],
"env": {
"LETDRAW_TOKEN": "<YOUR_LETDRAW_TOKEN>"
}
}
}
}Configuration
LETDRAW_TOKENRequiredSecretYour personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.
LETDRAW_MCP_URLOverride the hosted MCP endpoint. Default: https://api.letdraw.com/mcp
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableletdraw/letdraw-mcp is public and reachablegithub.com/letdraw/letdraw-mcp ↗Pass
- Package names this repository as its source@letdraw/mcp names letdraw/letdraw-mcp as sourcenpmjs.com/package/@letdraw/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-03github.com/letdraw/letdraw-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @letdraw/mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubLetDraw is a hand-drawn–style online whiteboard and diagramming app. With this integration an MCP client (desktop AI apps, 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.
What's here
| Path | What it is |
|---|---|
packages/mcp |
@letdraw/mcp — zero-config stdio bridge to the hosted MCP server (npx @letdraw/mcp) |
packages/sdk |
@letdraw/sdk — typed REST client for scripting |
spec/mcp-tools.md |
The MCP tools, resources, and scopes |
spec/openapi.yaml |
OpenAPI 3.1 spec for the REST API |
spec/capabilities.md |
"How to draw well in LetDraw" guide for AI clients |
docs/ |
Getting started + per-client setup (desktop apps, HTTP clients, Cursor, VS Code, Codex) |
examples/ |
Copy-paste recipes |
Endpoints
REST base https://api.letdraw.com/api-v1
MCP URL https://api.letdraw.com/mcp
Both 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.
60-second start (MCP)
The hosted server speaks Streamable-HTTP, so most clients connect directly. For a stdio client, or for the simplest possible setup, use the bridge:
// MCP client config (mcpServers block)
{
"mcpServers": {
"letdraw": {
"command": "npx",
"args": ["-y", "@letdraw/mcp"],
"env": { "LETDRAW_TOKEN": "ld_live_YOUR_TOKEN" }
}
}
}
See docs/clients for desktop apps, HTTP clients, Cursor, VS Code and Codex.
60-second start (REST)
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();
Scopes
Tokens carry scopes; each tool/route requires one:
diagrams:read— list/get workspaces, folders, diagrams, iconsdiagrams:write— create/update/delete/share diagrams, from-codeexport— export to Mermaid / D2ai:generate— generate a diagram from a prompt (uses your own AI key)
License
MIT — see LICENSE. "LetDraw" and the LetDraw logo are trademarks of their owner; see NOTICE.md.
LetDraw MCP questions
How do I add LetDraw MCP to Claude Code?
Run claude mcp add --env 'LETDRAW_TOKEN=<YOUR_LETDRAW_TOKEN>' letdraw-mcp -- npx -y @letdraw/mcp in your terminal. Add --scope user to make it available in every project.
How do I add LetDraw MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with the LetDraw MCP server?
Authentication is handled via a personal API token which you can create in the LetDraw app under Account → Developer.
Can I generate diagrams using prompts?
Yes, you can generate diagrams from a prompt using the ai:generate scope, which utilizes your own AI key.
What formats can I export my diagrams to?
You can export your diagrams to Mermaid or D2 formats.
Can I build diagrams from existing code?
Yes, the server allows you to build diagrams from code such as Compose, Kubernetes, DOT, Terraform, or SQL.