# Todrawn Scribe

> Todrawn Scribe is a freemium MCP server for design and media. MCP server that lets AI agents turn code, sketches or photos into hand-drawn videos. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, vscode, macOS, Windows, Linux
- **Website:** https://todrawn.com/scribe/mcp
- **Repository:** https://github.com/brbn-jpg/scribe-mcp
- **MCP Registry name:** com.todrawn/scribe
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-18

## About

The server gives an AI agent tools that build Todrawn Scribe projects from code, text, SVG path drawings or local PNG and JPEG photos. The agent returns a link, and the project opens in the Scribe studio in the browser, where you preview it and export an MP4. The README says the project data sits in the URL fragment, so the video tools do not upload content and need no account or API key.

Beyond video, the same server can sign in to your Todrawn account and read or edit your whiteboards, adding shapes, sticky notes, tables, connectors and freehand strokes. Board access is limited to boards you own or have joined, and access can be revoked or expires after 90 days.

It suits developers and writers who want to turn a function, diff or diagram into a walkthrough video from inside Claude Code, Cursor, VS Code or similar clients. Exporting video requires a free Todrawn account, with daily export limits on the free plan.

## Features

- **Code to hand-drawn video:** Renders text or code as a pen-drawn video with syntax colours and adjustable pacing.
- **SVG drawing playback:** Turns SVG path data from the agent into strokes that a pen draws in the order chosen.
- **Photo painting:** Paints local PNG or JPEG photos into up to about 2,800 coloured strokes on your machine.
- **Board editing tools:** Lets an agent list, create, read, add to, connect and update elements on Todrawn whiteboards after sign-in.
- **Browser-side export:** Scribe links open in the studio, where you preview and export the MP4 yourself.

## Good for

- Make a short walkthrough video of a function or diff from your coding assistant
- Turn a sketch or SVG drawing into an animated pen-drawn clip
- Paint a photo as a hand-drawn video for a social post
- Sketch a diagram or flow with boxes and arrows on a Todrawn board

## Install

### Claude Code (Terminal)

```sh
claude mcp add scribe -- npx -y @todrawn/scribe-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "scribe": {
      "command": "npx",
      "args": [
        "-y",
        "@todrawn/scribe-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "scribe": {
      "command": "npx",
      "args": [
        "-y",
        "@todrawn/scribe-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "scribe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@todrawn/scribe-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "scribe": {
      "command": "npx",
      "args": [
        "-y",
        "@todrawn/scribe-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "scribe": {
      "command": "npx",
      "args": [
        "-y",
        "@todrawn/scribe-mcp"
      ]
    }
  }
}
```

## Tools

- `scribe_create_video`: Builds a Scribe studio link from text, with optional look, pacing and segment settings.
- `scribe_create_drawing`: Builds a Scribe studio link from SVG path data.
- `scribe_paint_image`: Paints a local PNG or JPEG into strokes and returns a studio link.
- `scribe_limits`: Lists input limits and plan allowances.
- `todrawn_login`: Signs the agent in to a Todrawn account using a device flow.
- `todrawn_logout`: Revokes the agent's token and deletes it locally.
- `board_list`: Lists owned and shared Todrawn boards.
- `board_create`: Creates an empty board.
- `board_read`: Reads a board as a summary or in full.
- `board_add`: Adds shapes, sticky notes, text, tables and UML classes to a board.
- `board_connect`: Connects board elements with connectors.
- `board_draw`: Draws freehand pen strokes from SVG paths on a board.
- `board_update`: Changes properties of board elements.
- `board_delete`: Deletes board elements and attached connectors.

## FAQ

### Does it need an API key or account?

The README and site say the video tools need no API key or account. An account is only needed to export the MP4 or to use the board tools.

### Which clients does it work with?

Any client that speaks MCP over stdio. The site gives install snippets for Claude Code, Claude Desktop, Cursor, VS Code with GitHub Copilot, OpenAI Codex and Gemini CLI.

### Can the agent download the MP4 itself?

Not yet. The agent hands you a link, and the video is rendered and exported in your browser.

### What do the free and Premium plans allow?

Free allows 5 Scribe exports per UTC day with an end card, and 3 boards. Premium removes the export limit, adds 4K and 60 fps export, and makes the end card optional.

### Is Todrawn Scribe free?

Todrawn Scribe has a free plan, with paid plans for more usage or features.

### How do I add Todrawn Scribe to Claude Code?

Run this command in your terminal: claude mcp add scribe -- npx -y @todrawn/scribe-mcp

### What are the best alternatives to Todrawn Scribe?

The closest alternatives to Todrawn Scribe are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/todrawn-scribe
