AE MCP Bridge
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AE MCP Bridge Create a 1080x1080 animated activity card and show me a storyboard."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AE MCP Bridge
Let Claude (or Codex) work inside Adobe After Effects: build compositions, shapes, text, effects and animation, look at the result as frames or a storyboard, and fix it, while you keep a normal, fully editable AE project.
Version 0.3.0 · zero dependencies · Windows and macOS · Claude Code, Claude Desktop, Cowork, Codex
Inspired by "After Effects MCP by Ruslan Tsapenko" (v0.1.0) from Ruslan Tsapenko (tsapenko.com), with tools and ideas ported from TheLlamainator/after-effects-mcp (MIT).
Manual (PDF) · Tool reference (PDF) · Changelog
Example
You: "Create a 1080x1080 activity card with the step count and two labels. Animate its entrance in Apple style and show me a storyboard."
Assistant: builds the composition and the layers, opens the rounded card through its Rectangle Size with an overshoot, brings the texts in with text animators 4 frames apart, turns motion blur on, and checks the motion:

One image, nine frames with time labels: the assistant sees the whole animation at once and catches what a single frame hides, such as text showing outside a card that is still opening, uneven timing or a missing overshoot.
Related MCP server: After Effects MCP Server
What it can do
Build: compositions, text / shape / solid / adjustment / null layers, transforms, parenting, track mattes, motion blur, effects with settings,
.ffxpresets, markers, audio levels.Animate: keyframes with real easing (Easy Ease, ease in/out, custom influence, hold), expressions, text animators with a soft per-letter wave, copying animators and effects between layers with a stagger.
See: a frame as an image, a storyboard of the animation in one image, side-by-side comparison with a reference, MP4 previews, what you selected in AE, the full property tree with keyframes.
Script: run any ExtendScript (
ae_run_jsx) or your own.jsxfiles; the specialized tools are conveniences on top, not a replacement.Stay safe: every call is one Ctrl+Z, the project is backed up before the first change, scripts are logged, arbitrary code can be switched off.
Teach good motion: built-in motion-design guidelines (asymmetric easing, bounce, text animators, stagger, track mattes, motion blur, review loop) available as a tool and as MCP prompts, plus an optional Claude skill (
skills/after-effects-motion) with the working loop and recipes.
34 tools in total, see the reference.
Quick start
With an AI agent: in Claude Code (or Codex) say "Install AE MCP Bridge from https://github.com/justajazz/ae-mcp-bridge into C:\MCP\ae-mcp, following docs/INSTALL-AGENT.md". It runs and checks everything and asks you only for one AE preference and restarting apps. See INSTALL-AGENT.md.
By hand (Windows):
Install Node.js LTS and put this repository in a local folder, e.g.
C:\MCP\ae-mcp.In After Effects enable Preferences > Scripting & Expressions > Allow Scripts to Write Files and Access Network. Nothing has to be installed or started inside After Effects (an optional status panel exists, see the manual).
Connect your client, e.g. Claude Code:
claude mcp add --scope project after-effects -- node "C:\MCP\ae-mcp\src\mcp-server.mjs"Claude Desktop / Cowork and Codex: see the manual.
Check without any client:
node C:\MCP\ae-mcp\scripts\check-install.mjsends withRESULT: connected.Ask your assistant: "Check the connection to After Effects. Don't change anything."
How it works
The server is plain Node.js with no packages. For every command it starts a small runner script in the open After
Effects (AfterFX.exe -s), which executes the ExtendScript template and writes the result; user data travels
separately from code. Nothing polls inside After Effects, and while a modal dialog is open the command waits for you
to close it instead of breaking the bridge. Requests are synchronous with unique ids, long commands can be
collected later without being run twice. Details: manual.
Development
npm testruns the protocol, serializer, media and documentation tests against a mock runner, no After Effects needed. Every tool was also verified against a real After Effects 2026.
Credits and license
Inspiration: Ruslan Tsapenko and his "After Effects MCP by Ruslan Tsapenko" v0.1.0 (YouTube, tsapenko.com).
Ported tools and ideas: TheLlamainator/after-effects-mcp, based on Dakkshin/after-effects-mcp, MIT License © 2025 Dakkshin.
Made by Claude Code & Yuriy Martyniuk (assistant, consultant and producer).
License: MIT.
Available Tools
34 toolsae_add_markersA
Add one or many markers to a layer, or to the composition when layer is omitted. One undo step.
Inputs: markers (required), comp, layer.
ae_add_text_animatorA
Add a text animator reveal (the motion-design way, instead of animating Transform): offsets such as position [0, 40], opacity 0, blur 16 are applied through a Range Selector that is animated away. shape 'rampUp' (default for characters/words) slides a soft window over the text so letters overlap in a wave; 'square' (default for lines) animates Start 0 -> 100 with strong ease. mode 'out' mirrors the reveal (last units leave first). Several layers can be staggered. One undo step.
Inputs: comp, ease, mode, name, +9 more.
ae_analyze_audioA
Analyze a WAV file: peak envelope and transient peaks (beats, hits). Pass path, or comp + layer to use the layer's source file (times are then converted to composition time). With addMarkers: true, places a marker at every peak (on that layer, or on the composition when only path is given; one undo step). Only uncompressed PCM/float WAV.
Inputs: comp, path, layer, minGap, +5 more.
ae_apply_effectA
Apply an effect to a layer by display name or matchName and optionally set its properties. Returns the effect's properties so they can be adjusted next. One undo step.
Inputs: layer (required), effect (required), comp, name, +1 more.
ae_apply_presetA
Apply an animation preset (.ffx) to a layer. Find presets with ae_list_presets. One undo step.
Inputs: path (required), layer (required), comp.
ae_capture_frameA
Render one frame of a composition to PNG and return it as an image for visual inspection. Transparent areas are filled with the composition background color by default. Changes nothing.
Inputs: comp, path, time, background, +1 more.
ae_capture_framesA
Render several frames of a composition into ONE contact-sheet image (grid with time labels) to judge an animation: timing, easing, overlaps, elements appearing outside their containers. Give explicit times, or start/end with count (default 9 evenly spaced) or step. Changes nothing.
Inputs: end, comp, step, count, +5 more.
ae_center_layersA
Center layers in the composition. By default the anchor point is moved to the visual center of the layer content first (sourceRectAtTime), so text and shapes end up truly centered. One undo step.
Inputs: all, axis, comp, anchor, +1 more.
ae_copy_animationA
Copy a property or a whole property group with its keyframes, easing and expressions from one layer to other layers (like Ctrl+C / Ctrl+V), optionally staggered. Works for text animators ('Text/Animators/Animator 1'), effects ('Effects/Gaussian Blur'), masks and single properties ('Transform/Position'). Target n (1-based in the given order) is shifted by offset + n * stagger frames. One undo step.
Inputs: from (required), property (required), to, comp, +3 more.
ae_create_compA
Create a composition (and open it in the viewer unless open: false). One undo step.
Inputs: name, open, width, height, +5 more.
ae_create_layerA
Create a text, shape, solid, adjustment or null layer. Text is center-justified by default; use ae_center_layers to center any layer visually. One undo step.
Inputs: type (required), comp, fill, font, +14 more.
ae_get_audio_infoA
Audio info of a layer: source file path, audio levels and their keyframes, existing markers. Changes nothing.
Inputs: layer (required), comp.
ae_get_layer_timingB
Layer timing in seconds and frames: start, in/out points, duration, source in/out, stretch. Changes nothing.
Inputs: layer (required), comp.
ae_get_resultA
Fetch the result of a command that was still running when its tool call timed out. Never re-sends the command.
Inputs: commandId (required), waitMs.
ae_get_selectionA
What the user selected in After Effects: project items, layers of the active comp, and selected properties with their paths, values, keyframes (time, value, interpolation, ease) and property trees for selected groups (e.g. a text animator). Use it when the user says 'this', 'the selected layer', 'look at what I selected'. Changes nothing.
Inputs: depth.
ae_guidelinesA
Read the full motion-design and workflow guidelines for this bridge (easing, bounce, text animators, stagger, track mattes, motion blur, review loop, ExtendScript pitfalls). Call it once before designing or animating. Does not contact After Effects.
Inputs: no named parameters.
ae_healthA
Check the After Effects bridge: server and runner versions, whether After Effects is running or shows a dialog, AE version, open project, active composition. Changes nothing.
Inputs: no named parameters.
ae_inspectA
Deep property tree of a layer or of one of its groups, with values, keyframes and easing, expressions. By default only modified properties are listed (modifiedOnly: false lists everything). Changes nothing.
Inputs: layer (required), comp, keys, depth, +4 more.
ae_list_available_effectsB
Search effects installed in After Effects by display name, matchName or category. Changes nothing.
Inputs: max, query, includeObsolete.
ae_list_layer_effectsA
List the effects on a layer with their property tree and current values. Changes nothing.
Inputs: layer (required), comp, depth, values.
ae_list_presetsA
Find animation presets (.ffx) in the standard Adobe preset folders or given folders. Words in query must all match the preset path, e.g. 'blur in'. Changes nothing.
Inputs: max, query, roots.
ae_list_projectA
List the open project: compositions with their layers (index, name, type, in/out points) and all other items (folders, footage, solids) with their folder and usedIn count (0 = unused). Changes nothing.
Inputs: items.
ae_open_projectA
Open an .aep project in After Effects (closing the current one). If the current project has unsaved changes you must choose save: true or discard: true. Use this instead of opening/closing projects in ae_run_jsx, which breaks AE's undo history.
Inputs: path (required), save, discard.
ae_remove_effectsA
Remove effects from a layer by name, matchName or index (or an array of them), or all. One undo step.
Inputs: layer (required), all, comp, effect.
ae_render_previewA
Render a composition (or a time range) through the Render Queue to an H.264 MP4 or a PNG sequence for the user to watch. Other queued items are paused during the render and restored. Blocks After Effects while rendering; long renders return a commandId for ae_get_result.
Inputs: comp, half, path, start, +3 more.
ae_run_jsxA
Run arbitrary ExtendScript (ES3 JavaScript) inside After Effects. The value of the last expression is returned (AE objects come back as short summaries). Pass data through args (available as the args variable) instead of pasting it into the code. Helpers: mcp.findComp(nameOrId?), mcp.findLayer(comp, nameOrIndex), mcp.activeComp(), mcp.layerType(layer), mcp.projectInfo(); lib.prop(layer, 'Transform/Position'), lib.setValue(prop, value, time?), lib.color('#ff8800'), lib.tree(propertyGroup, depth, withValues). The whole call is one undo step. If it runs longer than the timeout, a commandId is returned: fetch the result with ae_get_result, do not re-send the code.
Inputs: code (required), args, timeoutMs.
ae_run_jsx_fileB
Run an ExtendScript .jsx/.js file from disk (a library of reusable scripts) with optional args, like ae_run_jsx. One undo step.
Inputs: path (required), args, timeoutMs.
ae_save_projectA
Save the open project. With no path saves to its current file; with an absolute .aep path saves there (Save As).
Inputs: path.
ae_set_audio_levelsA
Set Audio Levels (dB) of a layer: static, at a time, or as a list of keyframes. One undo step.
Inputs: layer (required), comp, keys, left, +3 more.
ae_set_compA
Change composition settings: name, size, duration, frame rate, background color, motion blur switch and shutter angle, work area, current time; open: true opens it in the viewer. One undo step.
Inputs: comp, name, open, time, +9 more.
ae_set_expressionA
Set an expression on a layer or effect property, or remove it with an empty string. Reports expressionError if AE rejects it. One undo step.
Inputs: layer (required), property (required), expression (required), comp.
ae_set_keyframesA
Add keyframes to a layer or effect property and set their interpolation. ease: linear | hold | bezier | easy (Easy Ease) | easyIn | easyOut; influence 0.1..100 (default 33.3); easeIn/easeOut: { speed, influence } for custom temporal ease; spatial props also accept spatialAutoBezier, spatialContinuous, roving, inTangent, outTangent. One undo step.
Inputs: keys (required), layer (required), property (required), comp, +3 more.
ae_set_layerB
Change layer settings and transform: name, enabled, 3D, label, parent, timing, anchorPoint, position, scale, rotation, opacity, and text (text, font, fontSize, fillColor, strokeColor, strokeWidth, justification, tracking, leading). Pass time to write keyframes instead of static values. One undo step.
Inputs: layer (required), comp, font, name, +25 more.
ae_set_propertyA
Set any property of a layer or of its effects by path. With time, sets a keyframe; without time the property must have no keyframes. One undo step.
Inputs: layer (required), value (required), property (required), comp, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 34 tools
Most tools target clearly distinct resources or operations (project, comp, layer, property, effect, preset, audio), and descriptions differentiate them well. Some overlap exists among ae_set_layer, ae_set_property, and ae_set_keyframes (all can create keyframes), and between ae_inspect and ae_list_layer_effects, which could cause occasional misselection.
All tools use a consistent ae_ prefix with snake_case and predominantly verb_noun structure (e.g., ae_create_comp, ae_set_property). A few names are noun phrases (ae_health, ae_guidelines) or single verbs (ae_inspect), but the pattern is highly predictable.
With 34 tools, the surface is large for an MCP server, even for a complex application like After Effects. While many tools are distinct and useful, some could be consolidated (e.g., property/keyframe/expression setters, frame capture variants), making the count feel heavy.
The surface covers a wide range: project management, comps, layers, properties, keyframes, expressions, effects, presets, text animators, markers, audio, rendering, and inspection. Minor gaps exist (no explicit delete for layers/comps/markers/keyframes, no import), but ae_run_jsx provides a workable escape hatch for missing operations.
Maintenance
Related MCP Connectors
One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
Create AI images, clips, voice-overs, music and editable storyboard films from your AI assistant.
Screenplay and storyboard in your AI assistant: import scripts, edit scenes, build shots.
Create AI animations and export transparent sprite sheets, alpha video, frames, and game assets.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe After Effects for composition, layer, effect, preset, marker, and audio automation through a bridge panel.3025MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to control Adobe After Effects for project inspection, composition creation, and layer manipulation via a hardened bridge panel.-
- AlicenseAqualityBmaintenanceEnables AI assistants to operate Adobe After Effects with the dexterity of an editor: reading projects, creating and rigging layers, setting real velocity curves, animating text, building native SVG-based shapes, applying effects, expressions, masks, and viewing render snapshots to verify results.1718 npm1MIT
- AlicenseCqualityBmaintenanceEnables AI assistants to control Adobe After Effects through a file-based CEP bridge, supporting project and composition creation, layer and keyframe management, expressions, batch operations, and rendering.92MIT