Tldraw logo

Tldraw

Connects AI agents with a tldraw canvas for reading, interpreting, and modifying visual content.

Install Tldraw

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tldraw": {
      "command": "npx",
      "args": [
        "-y",
        "create-tldraw@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

tldraw MCP server connects AI agents to a tldraw canvas through canvas primitives and the Editor API. It supports agent workflows that read, interpret, and modify canvas content, alongside custom shapes, tools, bindings, and interface components. Reach for it when an agent needs to work with diagrams, whiteboards, annotations, or other visual canvas data. The underlying tldraw SDK runs in React and supports browser-based desktop and touch interfaces.

Use cases

  • Read and interpret diagrams from a shared canvas
  • Modify whiteboards through an AI agent
  • Build canvas-based AI chat interfaces
  • Generate workflow diagrams and visual pipelines
  • Create collaborative agent workspaces

Key features

  • Agent access to canvas content
  • Runtime canvas control with the Editor API
  • Custom shapes, tools, bindings, and UI
  • Diagramming, drawing, and rich text
  • Self-hosted multiplayer collaboration
  • Browser-based image and video support

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

41/41 checks healthy over the last 63d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · create-tldraw@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars51kStargazers on the source repository.
npm downloads28kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Directory activity1 installsConfig copies, upvotes, and views on AllMCPs.

How Tldraw works

What tldraw does

tldraw provides an infinite-canvas engine for React applications, with an agent-oriented starter kit for AI systems that interact with canvas content. Agents can inspect visual material, interpret its meaning, and make changes to the canvas. The SDK includes the building blocks for diagrams and whiteboards, including geometric shapes, rich text, arrows, pressure-sensitive drawing, image and video support, snapping, edge scrolling, and image export.

The canvas can be extended with custom shapes, interaction tools, bindings, UI components, side effects, and event hooks. Its runtime Editor API allows application code or an agent workflow to control the canvas programmatically.

How it works

The canvas is rendered in a browser through the tldraw React component. A basic application installs the tldraw package, imports its stylesheet, and renders <Tldraw /> inside a full-viewport container. Agent workflows use the canvas primitives and runtime editor functionality to inspect or change the document.

Starter kits provide example application structures for agent experiences, canvas-based chat, workflow builders, image-generation pipelines, and visually branching conversations. The multiplayer starter kit uses @tldraw/sync with Cloudflare Durable Objects for self-hosted real-time collaboration.

Setup and configuration

Install the package with npm:

Terminal
npm i tldraw

A minimal React entry point imports Tldraw from tldraw and the package stylesheet, then renders the component in a container positioned to fill the viewport. For a starter project, run:

Terminal
npx create-tldraw@latest

The starter command offers templates including multiplayer, agent, workflow, chat, image pipeline, branching chat, and shader applications. Local development of the repository requires Node.js 20 or later, Corepack, pnpm, and the repository's development command.

Tools and capabilities

  • Read, interpret, and modify canvas content through agent workflows.
  • Control the canvas at runtime with the Editor API.
  • Add custom shapes, tools, bindings, and UI components.
  • Create diagrams with text, arrows, geometric shapes, snapping, and drawing input.
  • Display images, video, and embedded web content supported by the browser.
  • Export images from the canvas.
  • Build self-hosted multiplayer experiences with @tldraw/sync and Cloudflare Durable Objects.
  • Target desktop browsers, touch screens, tablets, and mobile devices.

Limitations and notes

The SDK is free to use during development, while production use requires a tldraw license key. The package is designed for React applications and browser rendering rather than a standalone command-line canvas. Multiplayer deployments require the additional sync stack described by the project. The repository's development workflow uses Node.js 20 or later.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tldraw

tldraw is an MCP server that connects AI agents to a tldraw canvas through canvas primitives and the Editor API. Its agent workflow supports reading, interpreting, and modifying canvas content, while the SDK provides shapes, tools, bindings, UI components, and runtime canvas control for React applications.

Install tldraw with `npm i tldraw`, then render the `Tldraw` React component and import `tldraw/tldraw.css`. For a starter project, run `npx create-tldraw@latest` and choose an available application template.

Yes, tldraw's agent workflow supports modifying canvas content. The SDK also exposes canvas primitives and the Editor API for runtime control.

Yes, tldraw supports self-hosted real-time collaboration through `@tldraw/sync` and Cloudflare Durable Objects. The project includes a multiplayer starter kit using that stack.

Yes, production use requires a tldraw license key. The SDK can be used freely during development.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTldraw AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tldraw?style=directory)](https://allmcps.com/mcp/tldraw)
HTML Embed
<a href="https://allmcps.com/mcp/tldraw"><img src="https://allmcps.com/api/badge/tldraw?style=directory" alt="Tldraw on AllMCPs" /></a>