
OpenToonz MCP
Animate in OpenToonz from an AI assistant using editable vector levels and keyframes
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"opentoonz-mcp": {
"command": "uvx",
"args": [
"opentoonz-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"opentoonz-mcp": {
"command": "uvx",
"args": [
"opentoonz-mcp"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media