LetDraw

io.github.letdrawv1.0.1Updated Oct 3, 2026

Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.

VerifiedStreamable HTTPWeb executableDeveloper Tools Media & Design Productivity & Workflow

Overview

AI-generated overview

Lets an assistant list, create, edit, share and export hand-drawn LetDraw diagrams, including building diagrams from code or a prompt.

What it does: Connects an AI client to a LetDraw account through the hosted MCP server or a local stdio bridge. It can list workspaces, folders, diagrams and icons, create and update diagrams, build diagrams from code such as Compose, Kubernetes, DOT, Terraform or SQL, stamp product icons, export to Mermaid or D2, and create read-only share links. A typed REST SDK and OpenAPI spec are also shipped for scripting.
When to use it: Useful when you want an assistant to author or maintain diagrams in a LetDraw account, turn infrastructure or schema code into diagrams, or export existing diagrams to Mermaid or D2. Also suitable for scripts that need the same REST API.
Requirements: A LetDraw account and a personal API token created under Account > Developer, supplied as LETDRAW_TOKEN for the stdio bridge or as an Authorization Bearer header for the hosted endpoint. The stdio bridge runs via npx, so Node.js is needed; the hosted endpoint needs network access. Token scopes control which operations are allowed.

Before you install

The token is a live credential: anyone holding it can act on the account within its scopes, so keep it out of shared configs and logs. Write and delete operations on diagrams, sharing, and prompt-based generation are possible; generation uses your own AI key. Read-only share links expose diagram content to anyone with the link.

Installation

In SourceWeft

Open LetDraw in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "letdraw": {
      "type": "http",
      "url": "https://api.letdraw.com/mcp"
    }
  }
}

README

[LetDraw]

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.

[License: MIT] [Node 18+] [MCP: stdio + HTTP]

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

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:

jsonc

// MCP client config (mcpServers block){  "mcpServers": {    "letdraw": {      "command": "npx",      "args": ["-y", "@letdraw/mcp"],      "env": { "LETDRAW_TOKEN": "ld_live_YOUR_TOKEN" }    }  }}

// 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)

Or with the SDK:

import { LetdrawClient } from '@letdraw/sdk';const ld = new LetdrawClient({ token: process.env.LETDRAW_TOKEN! });const { workspaces } = await ld.listWorkspaces();

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, 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)

License

MIT — see LICENSE. "LetDraw" and the LetDraw logo are trademarks of their owner; see NOTICE.md.

Source: README.md at commit b21c95c

Tools

Tool metadata has not been indexed yet.

Version history

v1.0.1LatestOct 3, 2026