Skip to content
MCP server

OpenToonz MCP

Animate in OpenToonz from an AI assistant using editable vector levels and keyframes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, Linux, CLI
Runs
Locally
Version
1.2.0
Listing updated
2 days ago

About OpenToonz MCP

OpenToonz MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add opentoonz-mcp -- uvx opentoonz-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "opentoonz-mcp": {
      "command": "uvx",
      "args": [
        "opentoonz-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • OPENTOONZ_HOMEFolder containing OpenToonz.exe and tcomposer.exe (auto-detected when unset)
  • OPENTOONZ_STUFFOpenToonz stuff folder, TOONZROOT (auto-detected from the registry when unset)
  • OTMCP_WORKWhere the server keeps state, undo snapshots, renders and learned lessons

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free and open source

Prices change. Check konkomaji.com before you buy.

OpenToonz MCP 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 to OpenToonz MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media