# OpenToonz MCP

> OpenToonz MCP is an open-source MCP server for design and media. Animate in OpenToonz from an AI assistant using editable vector levels and keyframes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, CLI
- **Website:** https://konkomaji.com
- **Repository:** https://github.com/konkomaji/opentoonz-mcp
- **MCP Registry name:** io.github.konkomaji/opentoonz-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

What sets this server apart is that nothing it makes is baked: drawings are native OpenToonz vector levels, moves are keyframes and glows are real fx nodes, so you can open the scene afterwards and change anything. The README's showcase is a 96-frame night scene with ten layers, a 16-part character rig, depth planes and a camera move, built in 41 tool calls with no video model.

There are three ways to draw: shapes and SVG paths, pen strokes with pressure on a shared ink layer, and your own art placed or traced. The assistant and you can draw on the same ink layer, where read_drawing returns your strokes too and new strokes are added on top. Walk and run cycles, physics and rigs handle motion, and a validation step checks frame count, blank frames and flashing before render.

It runs locally over stdio from a PyPI package, works through the scene files with OpenToonz 1.8 or live in an open window via the otbridge plugin, and the README says 196 tests, 57 of them driving the real application. It targets Windows and Linux.

## Features

- **59 tools:** Cover scenes, layers, drawing, ink strokes, paint, timing, keyframes, physics, rigs, walk and run, camera, fx looks and render.
- **Editable output:** Drawings stay vector levels, moves stay keyframes and effects stay fx nodes.
- **Shared ink layer:** You and the assistant draw on the same layer, and the assistant can read your strokes.
- **Character rigs:** Builds a rigged character and generates walk cycles.
- **Scene validation:** Checks frame count, blank frames and flashing before rendering.
- **Live or file mode:** Works on scene files or live in the open window through a plugin.

## Good for

- Block out a short animated scene from a text description
- Draw pen strokes alongside an assistant on one level
- Rig a character and generate a walk cycle
- Apply a bloom and diffusion look to a scene
- Render and sanity-check a finished shot

## Install

### Claude Code (Terminal)

```sh
claude mcp add opentoonz-mcp -- uvx opentoonz-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "opentoonz-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
```

## Tools

- `create_scene`: Create a new scene.
- `add_note`: Add a note to the scene.
- `add_layer`: Add a layer.
- `draw`: Draw shapes or SVG paths on a level.
- `stroke`: Place a pen stroke on an ink layer.
- `read_drawing`: Return every stroke on a drawing.
- `paint`: Fill areas in live mode.
- `build_character`: Build a rigged character.
- `walk_cycle`: Generate a walk cycle.
- `set_pivot`: Set a layer pivot.
- `set_keyframe`: Set a keyframe.
- `camera_move`: Move the camera.
- `apply_look`: Apply an fx look such as anime_satsuei.
- `validate_scene`: Check the scene before render.
- `render`: Render the scene.

## FAQ

### Which OpenToonz version does it need?

The README says file-based working works with any OpenToonz 1.8; live mode uses the otbridge plugin.

### What platforms are supported?

Windows and Linux; rendering is tested on Windows and confirmed on Linux by a user.

### How is it installed?

As the PyPI package opentoonz-mcp, run over stdio.

### Is anything generated by a video model?

No. The README says the showcase shot used no video model and no hand-painted frames.

### Is OpenToonz MCP free?

Yes. OpenToonz MCP is open source, so you can use and self-host it for free.

### How do I add OpenToonz MCP to Claude Code?

Run this command in your terminal: claude mcp add opentoonz-mcp -- uvx opentoonz-mcp

### What are the best alternatives to OpenToonz MCP?

The closest alternatives to OpenToonz MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/opentoonz-mcp
