ae-mcp-tuift
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ae-mcp-tuift
English | Português (BR)
An MCP server that lets an AI agent drive Adobe After Effects: inspect a project, edit layers and keyframes, look at the result, review the motion, render. It is the TUIFT Media fork of kumoproductions/mcp-aftereffects v0.3.1 (see NOTICE.md) plus house tools for motion work: contact sheets, motion review, scene plan check, chunked background render, spring/entrance/stagger moves, a lessons journal.
Windows / macOS · After Effects 2024–2026 · Node.js 24+ (the house render and dialog helpers are Windows-first).
The agent can read and modify compositions, layers, effects, keyframes and expressions. What it reads (names, expressions, footage paths) may be sent to the AI service you use. Try it on a backup or a test.aep first, and check your AI service's data policy before using it on projects under NDA.
Requirements
After Effects 2024, 2025 or 2026, already open with a project. The server does not start After Effects (it can start extra instances, see
instance.start).After Effects preference Scripting & Expressions → "Allow Scripts to Write Files and Access Network" turned ON. The server cannot check it; with it OFF, calls time out.
Node.js 24 or newer.
Optional outside programs, only for the tools that need them. A missing one is a readable tool error, never a crash:
ffmpeg + ffprobe on
PATH(orTUIFT_FFMPEG/TUIFT_FFPROBE):ae_render_video,ae_place_sfx,ae_avaliar_render, andae_seewith a reference video.Python 3 +
torch+beat_this(TUIFT_PYTHON):ae_beats.Playwright + Chromium, Chrome or Edge (
TUIFT_PLAYWRIGHT_ROOT):ae_capturar_movimento_web.
Related MCP server: AE Bridge MCP
Run it
Get after-effects-mcp-<version>.tgz from a release (or build it, below), extract it anywhere (spaces in the path are fine) and point your MCP client at dist/index.js. There is no install step: production node_modules are inside.
tar -xzf after-effects-mcp-0.4.0.tgz
claude mcp add after-effects -- node "/path/to/after-effects-mcp/dist/index.js"Any stdio MCP client works the same way:
{
"mcpServers": {
"after-effects": {
"command": "node",
"args": ["/path/to/after-effects-mcp/dist/index.js"],
"env": { "AE_MCP_TOOLS": "core" }
}
}
}From a checkout: npm ci && npm run build, then use dist/index.js of the checkout. npm run bundle rebuilds the archive (it prints its size and SHA-256).
Tool profiles (AE_MCP_TOOLS)
Some agent programs resend the whole tool list on every request. AE_MCP_TOOLS picks how much of it you pay for. The operations behind ae_do are not part of the list: ae_catalog returns them on demand, so they cost nothing until used.
Profile | Tools | Tool list size | What it registers |
| 25 | 39,898 characters, about 10,000 to 11,400 tokens | Everything below, plus |
| 21 | 33,443 characters, about 8,400 to 9,600 tokens | Only tools that need After Effects alone, or nothing: project/comp/layer info, save, JSON export/import, |
Sizes are the JSON of the tools/list answer, tokens at 3.5 to 4 characters each; node scripts/measure-tools.mjs --per-tool measures them on your build. docs/TOOLS.md lists every tool and its profile.
Safety switches
AE_MCP_READONLY=1: inspection only. Tools that change the project are not registered andae_doaccepts only read-only operations.AE_MCP_ALLOW_CATEGORIES=keyframe,layer: only those operation categories run.AE_MCP_ENABLE_EVAL=1: addseval.run(arbitrary ExtendScript, with file and process access). Off by default; turn it on only when you need it.Every
ae_docall is one undo group. Runae_checkpointbefore structural changes: a batch is not transactional.npm testnever touches a running After Effects; the live suites needAE_MCP_E2E=1(see CONTRIBUTING.md).
Environment variables
Variable | Meaning |
|
|
| Full path of |
| Safety switches above. |
| Default instance when several After Effects run ( |
| Moves the IPC mailbox (default |
| Your own house-style JSON instead of |
| Your own lessons file instead of |
| Optional JSON with your review rules and decided cases for |
| Folder holding your clones of the docsforadobe After Effects scripting and expression guides. Without it |
| Full paths of the outside programs when they are not on |
| Folder containing |
| Where checkpoints, contact sheets and render jobs go (default |
| Comma-separated process names (without |
| Render inside the server process instead of a detached worker; free-RAM floor (GB) under which the newest |
What is in the box
Upstream tools:
ae_project_info,ae_comp_info,ae_layer_info,ae_version_info,ae_render_frame,ae_save_project,ae_project_export_json,ae_project_import_json,ae_catalog,ae_do(229 operations, 230 witheval.run, across layers, keyframes, effects, masks, shapes, text, comps, project, rendering, instances),ae_context.House tools:
ae_see(contact sheet you can look at),ae_review_motion(human or robotic motion),ae_plano_check(check the scene plan before building),ae_expressions_check,ae_sound_cuesandae_place_sfx,ae_beats,ae_checkpoint,ae_render_videoandae_render_status(chunked background render),ae_avaliar_render,ae_lessons, the two web-capture tools,ae_docs.House operations in
ae_do:tuift.mola,tuift.entrada,tuift.saida,tuift.stagger,tuift.vivo,tuift.camera_viva,tuift.curva,tuift.cena,tuift.morph, plusproject.collectandfootage.relink. Their numbers come fromkit/estilo-da-casa.json.Lessons:
kit/licoes.jsonlholds 58 After Effects gotchas. When a tool call fails, the lessons whose pattern matches the error are appended to it.
Details of the transport, the ExtendScript rules and how to add an operation are in CONTRIBUTING.md. The Portuguese guide to the house tools is README.pt-BR.md.
Troubleshooting
Calls time out: is After Effects running with a project open, and is "Allow Scripts to Write Files and Access Network" ON? On macOS also allow your client under System Settings → Privacy & Security → Automation.
NO_INSTANCE: no After Effects could take the call. Instances started with-mneed the resident agent; with several live and none named, setAE_MCP_INSTANCE.DIALOG_OPEN: After Effects is showing a modal dialog (often hidden).instance.dialogslists them andinstance.dismiss_dialog { id }cancels one."X was not found on this computer": an outside program is missing; the message names the variable to set.
After Effects in a non-standard place: set
AE_MCP_EXE.
Credits and licence
MIT. Copyright (c) 2026 kumo.productions, Inc. (the upstream server) and (c) 2026 TUIFT Media (the additions). Built on kumoproductions/mcp-aftereffects. Third-party licences of the bundled dependencies are in THIRD_PARTY_LICENSES.txt inside the bundle.
Adobe and After Effects are trademarks of Adobe Inc. This project is independent and not affiliated with or endorsed by Adobe.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI video editor your agent can drive: plan scenes, edit a multi-track timeline, and render MP4s.
Build and run visual creative-production workflows from your AI agent.
Video production studio for AI agents: AI media, motion graphics as code, timeline and export.
Generate and edit images, video, voice, lip-sync and 3D models from your AI agent.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to control Adobe After Effects for project inspection, composition creation, and layer manipulation via a hardened bridge panel.-
- AlicenseAqualityAmaintenanceEnables AI agents to inspect and control a live Adobe After Effects session, including reading active composition and layer data and evaluating arbitrary ExtendScript.4MIT
- AlicenseAqualityCmaintenanceEnables AI agents to connect to Adobe After Effects locally, inspecting projects, comps, and layers, discovering and executing a catalog of operations, rendering frames, and saving projects, with on-demand skill-based guidance.121MIT
- AlicenseAqualityBmaintenanceLets AI agents drive a running Adobe After Effects (~270 undo-safe operations). Works with every UI language Adobe ships and sees the frame: draws Object Matte on what it sees (lassos, ⊕/⊖ points, a preview of gaps and people) and syncs AI-generated layers with the plate frame by frame. A large skills library, built for AI and generative features: Roto Brush, Object Matte, Content-Aware Fill.413766 npm3Apache 2.0