Skip to main content
Glama

Roon1e MCP for AE

An MCP server that lets Claude drive Adobe After Effects. It installs a dockable panel in After Effects that runs Claude's requests. Each change is one named Undo step, and a Pause Claude switch blocks all changes.

  • One Python file, standard library only. Nothing to pip install.

  • No API key and no call limit. Everything runs locally through files in Documents/ae-mcp-bridge.

  • Works with Claude Code and Claude Desktop, or any MCP client that uses stdio.

Quick start: let Claude set it up

  1. Open Claude Code: the claude terminal app, or the Code tab in the Claude desktop app.

  2. Paste this repo's link and say: "Set this up for me using SETUP-WITH-CLAUDE.md."

  3. Do the two steps Claude asks you to do inside After Effects.

SETUP-WITH-CLAUDE.md holds the full steps Claude follows, plus a troubleshooting table.

Related MCP server: AE Motion MCP

Manual setup

You need After Effects and Python 3.8 or newer. On Windows, use py -3 wherever this says python.

  1. Download the repo: Code > Download ZIP, or git clone. Then run:

    python roon1e_mcp.py install

    This copies the panel into each After Effects version it finds. It also copies the script to Documents/ae-mcp-bridge/roon1e_mcp.py, and prints the exact paths for step 4.

  2. In After Effects, open Edit > Preferences > Scripting & Expressions (macOS: After Effects > Settings). Tick Allow Scripts to Write Files and Access Network.

  3. Restart After Effects and open Window > Roon1e MCP for AE.jsx. To dock the panel, drag its tab into a panel group.

  4. Connect Claude, using the paths that install printed.

    Claude Code

    claude mcp add --scope user roon1e -- "<python path>" "<server path>" serve

    Claude Desktop: open Settings > Developer > Edit Config, then add:

    {
      "mcpServers": {
        "roon1e": { "command": "<python path>", "args": ["<server path>", "serve"] }
      }
    }
  5. Check it with python "<server path>" status. It should print LIVE.

Tools

Tool

What it does

ae_status

Shows whether the panel is open and listening, plus the open project and active comp.

ae_run_jsx

Runs ExtendScript as one named Undo step. The code assigns result to return data. label names the step in the panel feed and the Undo menu.

ae_command

Runs a built-in command: createComposition, createTextLayer, createShapeLayer, createSolidLayer, createCamera, duplicateLayer, deleteLayer, setLayerMask, setLayerProperties, batchSetLayerProperties, setCompositionProperties, setLayerKeyframe, setLayerExpression, applyEffect, applyEffectTemplate, getProjectInfo, listCompositions, getLayerInfo or ping.

The panel

  • Status card: green means ready, amber means working, grey means paused. The Pause Claude / Let Claude work switch is remembered between sessions. While the panel is paused, nothing can change the project.

  • Tiles: Changes, Last active and Hiccups (failed requests).

  • Recent activity: each change in plain words, newest first.

  • Options: response speed, Fix connection, Open folder, and Show technical details.

Command line

python roon1e_mcp.py status | ping | install [--dest DIR] | uninstall | serve
python roon1e_mcp.py run <file.jsx|-> [timeout_s] [--label "Added a glow"] [--direct]
python roon1e_mcp.py cmd <command> [json-args]

--direct skips the panel and runs the script through AfterFX.exe -r. It works on Windows only.

How it works

  1. The client writes ae_command.json with {command, args, timestamp, status: "pending"}.

  2. The panel picks up the command, sets the status to running, and runs it.

  3. The panel writes the result to ae_mcp_result.json and sets the status to completed or error.

The panel also rewrites heartbeat.json about once a second. All three files live in Documents/ae-mcp-bridge.

Security: ae_run_jsx runs any ExtendScript that the MCP client sends, with After Effects' file and network access. Connect it only to Claude sessions you trust. Use Pause Claude when you don't want any changes.

Uninstall

  1. Run python "<server path>" uninstall.

  2. Remove the roon1e server: run claude mcp remove roon1e --scope user, or delete its entry from the Claude Desktop config.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets Claude drive Adobe After Effects on Windows — creating comps, layers, effects and expressions, rendering frames or full renders, and listing or tweaking parameters of any installed native or third-party plugin. It also runs arbitrary ExtendScript and menu commands, so plugin-only workflows can be orchestrated from natural language.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables Claude or any MCP client to build, animate, preview, and render motion graphics in a live Adobe After Effects project, including comps, layers, keyframes, effects, cameras, masks, and renders.
      46
      15
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables Claude to drive Adobe After Effects: creating comps and layers, setting real keyframes with temporal and spatial easing, inspecting and sampling animation curves, and rendering PNG stills or MP4 output so the AI can review its own work.
      25
      MIT