LetDraw
Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http letdraw 'https://api.letdraw.com/mcp' --header 'Authorization: <Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>'
{
"mcpServers": {
"letdraw": {
"type": "http",
"url": "https://api.letdraw.com/mcp",
"headers": {
"Authorization": "<Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>"
}
}
}
}
@letdraw/mcpclaude mcp add letdraw -e 'LETDRAW_TOKEN=<your letdraw_token>' -e 'LETDRAW_MCP_URL=<LETDRAW_MCP_URL>' -- npx -y @letdraw/mcp@0.1.2
{
"mcpServers": {
"letdraw": {
"command": "npx",
"args": [
"-y",
"@letdraw/mcp@0.1.2"
],
"env": {
"LETDRAW_TOKEN": "<your letdraw_token>",
"LETDRAW_MCP_URL": "<LETDRAW_MCP_URL>"
}
}
}
}
Variables d'environnement
LETDRAW_TOKENobligatoire secret Your 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
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
LetDraw MCP + REST
Connect AI assistants and your own scripts to LetDraw — read and author diagrams in your account through the Model Context Protocol (MCP) or the public REST API.
LetDraw 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.
Questions fréquentes
Qu'est-ce que LetDraw ?
Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.
Comment installer LetDraw ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http letdraw 'https://api.letdraw.com/mcp' --header 'Authorization: <Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour LetDraw ?
Oui. Il attend LETDRAW_TOKEN, Authorization, à renseigner dans sa configuration.
LetDraw est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient LetDraw ?
Il est publié par letdraw. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.