# tldraw [Health: Active]

**Category:** 📐 Architecture & Design  
**Repository:** https://github.com/tldraw/tldraw  
**GitHub Stars:** 51528  
**npm Downloads (last month):** 46660  
**Views:** 12  
**Installs:** 1  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tldraw

## Description
Draw and visually collaborate with your agents on tldraw's canvas.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "tldraw": {
    "command": "npx",
    "args": ["-y","create-tldraw@latest"]
  }
}
```

## Documentation

## 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:

```bash
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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/tldraw/readme_

