AE Motion MCP
AE Motion MCP lets Claude inspect, build, animate, review, and render After Effects projects through many AE-aware tools.
Inspect projects, comps, layers, properties, keyframes, effects, fonts, text, and motion quality.
Open/save/create projects and comps; import footage and manage project items.
Add, edit, delete, duplicate, reorder, parent, precompose, and replace layer sources.
Edit timelines: split, trim, shift, sequence layers, insert/delete time, and manage markers.
Work with masks and track mattes.
Design/layout: align layers, set anchors, add shapes, apply layer styles, and convert text to shapes.
Animate: set properties/keyframes/expressions, apply effects/presets, stagger keys, add shape modifiers, use ready-made motion, reveals, transitions, and motion review.
Build 3D scenes with cameras, lights, meshes, camera moves, rigs, and shake.
Audio: beat markers, audio-reactive animation, sound cues, SFX placement, and music ducking.
Preview frames and render with status/cancel, verification, delivery, audio-only, and draft options.
Batch multi-step tool calls, load tool groups on demand, check for updates, and optionally run JSX when enabled.
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 Motion MCP Create a 5-second lower third with an eased slide-in and show me frame 0."
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 Motion MCP
Ask Claude to make animations in After Effects, and it makes them in your project.
https://github.com/user-attachments/assets/4734d955-5c97-4644-a387-f05d4dc0e2f6
https://github.com/user-attachments/assets/c05af0f1-3f7e-4a31-84ef-cbc0fb87006d
Full video: watch on YouTube
How it works
Claude can't use After Effects by itself. This project gives it a way in, with two parts:
A small program on your computer that Claude talks to.
A panel inside After Effects that does what the program asks.
You type "make a 5 second title that slides in". Claude tells the program, the program tells the panel, and the panel makes the comp, layers and keyframes in your open project. They are normal After Effects layers: you can edit them, and undo anything.
Related MCP server: AfterEffectsMCP
What you need
After Effects 2022 or newer, on a Mac or Windows PC
Claude Code or Claude Desktop
Install with Claude (easiest)
Paste this into Claude Code, or the Code tab of the Claude desktop app:
Install the After Effects MCP server from https://github.com/dha-aa/ae-motion. Follow its INSTALL.md.Claude installs everything. If your computer is missing something it needs (Node.js or git), Claude asks you first, then installs it. Claude asks your permission before each command it runs on your computer: that is normal, allow them. (Claude follows INSTALL.md, the step-by-step version written for AI agents.)
Do the two steps below in After Effects, then tell Claude you're done. Claude checks that everything works.
Install by hand
Open a terminal and run:
git clone https://github.com/dha-aa/ae-motion.git cd ae-motion node scripts/update.tsDo the two steps below in After Effects.
Check it: run
node scripts/check.ts --aein the same folder. It tells you if anything is missing.
The two steps in After Effects
Both ways of installing end with these. Only you can do them.
Allow scripts. Open After Effects > Settings > Scripting & Expressions (on Windows: Edit > Preferences > Scripting & Expressions; older Mac versions say Preferences instead of Settings) and turn on Allow Scripts to Write Files and Access Network.
Open the panel. Restart After Effects, then open Window > Extensions > AE Motion MCP. Keep it open while you work (dock it, and it opens by itself next time).
Then restart Claude Desktop, or start a new Claude Code session. Now ask in any chat, with your project open in After Effects: "Create a 1920x1080 comp, 5 seconds, with a title that slides in, and show me a frame."
What Claude can do in After Effects
78 tools, grouped by what they're for, plus a helper that loads them on demand in apps that start with fewer. You never call them yourself: ask in plain words, and Claude picks the right ones.
Area | Ask for things like | Tools |
Look around | "What's in this project?" |
|
Project and comps | "Make a 1080x1920 comp for Reels" |
|
Layers | "Add a title and a logo, parent the logo to it" |
|
Timeline and editing | "Cut 3s to 5s out and close the gap" |
|
Masks and mattes | "Reveal the text through a wipe" |
|
Layout and design | "Center the title and give it a soft shadow" |
|
Animation and effects | "Ease the logo in, then add a glow" |
|
Ready-made motion | "Pop the cards in with a spring" |
|
3D and camera | "Orbit the camera around the product" |
|
Audio | "Cut the clips to the beat, duck the music under the voice" |
|
Preview and render | "Show me frame 2s, then render an MP4" |
|
Power tools | "Check for updates" |
|
How each one works: docs/tools.md.
Contributing
Bug reports, ideas and code are all welcome.
Found a bug? Open an issue with your After Effects version, Mac or Windows, what you asked Claude, and what
node scripts/check.ts --aeprints.Want to change the code? Start with CONTRIBUTING.md: it gets you set up in three commands, and the tests run without After Effects.
Working with an AI agent? Point it at AGENTS.md: it says what to read first.
If ae-motion saves you time, a star on GitHub helps other editors find it.
Need more?
Problems, updating, uninstalling and all the settings: docs/setup.md.
License
Available Tools
46 toolsadd_layerAdd LayerB
Add a layer. item_id: footage/precomp source. center: camera/light. position with 3 values turns 3D on. box_size: box text; text_style as set_text. anchor moves the anchor onto the content (as set_anchor) before position, so position places e.g. the text's center. shape: a shape layer's first shape (as add_shape). mesh: a 3D primitive, centred on position, color is its base color (After Effects 26.3+; moves the comp to the renderer that draws meshes, reported as renderer_changed; list_properties has its size, bevel and slices). fit_to (shape): a rect that keeps fitting that layer's content + padding (a highlight behind text). fit: scale to cover or fit inside the comp frame. Timing: in/out are comp times; source_in is the source time shown at in (no start maths); stretch in percent (200 = half speed).
Inputs: kind (required), comp_id (required), options.
add_propertyAdd PropertyB
Add a property or group that set_property cannot reach until it exists. Text animator: group_path ['ADBE Text Properties','ADBE Text Animators'], match_name 'ADBE Text Animator'; then add properties under returned path + 'ADBE Text Animator Properties' (e.g. ADBE Text Opacity, ADBE Text Position 3D, ADBE Text Fill Color) and a selector under returned path + 'ADBE Text Selectors' (ADBE Text Selector). Returns the new property path.
Inputs: layer_id (required), match_name (required), group_path.
add_shape_modifierAdd Shape ModifierA
Add trim_paths, repeater or round_corners to a shape group (group_index, default 1). params maps property names or match names to values. Returns the modifier's path and property names for set_keyframes.
Inputs: layer_id (required), modifier (required), params, group_index.
animateAnimateADestructive
Animate layers with a named move, keyed from their current values. In/out: fade, pop (scale from 0), grow (from 80%), slide (direction of travel, default up), drop, spin; style snappy (default), smooth, spring (default pop/spin), bounce (default drop), linear; exits accelerate; springs are expressions on the keys; time defaults to the in point (out: out point - duration). Through a hold, so the frame never freezes: push (slow scale-up by amount %, default 4) and drift (slow float by distance px, default 2% of the comp height, toward direction); they start where the layer's animation lands (keeping its landing ease) and run to its out point; style smooth (default) or linear. Layer i starts i * stagger later.
Inputs: move (required), layer_ids (required), time, order, +7 more.
apply_effectApply EffectB
Add an effect by match name (see find_effects) and set parameters by name, match name or 1-based index. If any parameter fails the effect is removed.
Inputs: layer_id (required), match_name (required), name, params.
apply_presetApply PresetBDestructive
Apply an .ffx animation preset to a layer. Path must be inside the allowed folders.
Inputs: ffx_path (required), layer_id (required).
batchBatchADestructive
Run up to 50 tool calls in order in one call (prefer it for multi-step builds). "$N.path" in args is that value from step N's result (from 1), e.g. "$1.id", "$2.layers.0.id"; name a step (as: "title") to use "$title.id" instead. "$$" is a literal $ ("$$99"). defaults: {tool: args} merged under every step of that tool (shared style, comp_id). All steps are checked before any runs; a step that fails in After Effects stops the batch with the results so far and a batch_id for resume. Each step is its own undo step. Not preview_frame, run_jsx or open_project.
Inputs: steps (required), resume, results, defaults.
check_for_updatesCheck For UpdatesARead-onlyIdempotent
Check whether a newer ae-motion-mcp release exists (GitHub version tags). Returns current and latest versions, update_available and, if so, how to update. Uses a result cached for a day unless force is true. Disabled when AE_MCP_UPDATE_CHECK=0.
Inputs: force.
copy_animationCopy AnimationADestructive
Copy a property's keys (with easing and tangents) or static value, plus any expression, to other layers, replacing their keys. to_path targets another property of the same type. offset_seconds shifts the keys; the i-th target also gets i * stagger_seconds.
Inputs: path (required), to_layer_ids (required), from_layer_id (required), to_path, +2 more.
create_compCreate CompC
Create a composition and open it in the viewer.
Inputs: fps (required), name (required), width (required), height (required), +2 more.
delete_itemDelete ItemADestructiveIdempotent
Delete a project item (comp, footage or folder) by id. Refuses items that are used in comps, and non-empty folders, unless force is true (force also deletes the layers that use the item).
Inputs: item_id (required), force.
delete_layerDelete LayerCDestructiveIdempotent
Delete a layer.
Inputs: layer_id (required).
duplicate_layerDuplicate LayerA
Duplicate a layer (the copy sits above the original). count makes several copies; offset_seconds shifts copy N later in time by N * offset_seconds.
Inputs: layer_id (required), name, count, offset_seconds.
edit_effectEdit EffectADestructive
Remove, enable or disable an effect on a layer by its 1-based index (see get_layer for the list), or set: change params as in apply_effect (all checked first).
Inputs: action (required), layer_id (required), effect_index (required), params.
edit_keyframesEdit KeyframesADestructive
Edit single keys on one property, in order, leaving the others. Address a key by t (within half a frame) or index (1-based). set creates a key at t (v or the current value) or updates one; spatial_in/out are motion-path tangents relative to the key. move keeps every setting. Returns the edited keys (get_keyframes lists all).
Inputs: path (required), edits (required), layer_id (required).
find_effectsFind EffectsARead-onlyIdempotent
Search installed effects by display name, match name or category. Page: limit (50) / offset; matched and next_offset when there are more.
Inputs: query (required), limit, offset.
find_fontsFind FontsARead-onlyIdempotent
Search the installed fonts by family, style or PostScript name (e.g. "montserrat", "bold italic"); returns PostScript names for set_text font. Needs After Effects 24.0+.
Inputs: limit, query.
get_compGet CompARead-onlyIdempotent
Get composition settings and its layers, top first (id, name, kind, non-default in/out/start, parent, blend mode, flags). Big comps: filter by name (substring), kind or at (seconds: layers visible then), page with limit (default 150) / offset; kinds counts all layers.
Inputs: comp_id (required), at, kind, name, +2 more.
get_keyframesGet KeyframesARead-onlyIdempotent
Read the keyframes of one property: time, value, in/out interpolation and temporal ease, plus any active expression; unanimated, its value. Returns every key that fits; next_offset when there are more (offset continues; limit caps a page). Use list_properties to find the path.
Inputs: path (required), layer_id (required), limit, offset.
get_layerGet LayerARead-onlyIdempotent
Get a layer (or several: layer_ids): transform values, text, effects, expressions, marker count, masks, track matte, bounds (content: its layer-space box; comp: its place in the comp, null for 3D). Values at time (default 0).
Inputs: time, layer_id, layer_ids.
get_projectGet ProjectARead-onlyIdempotent
List project items with each comp's layers (id, name, kind, timing; left out when the page has over 300 layers: layers_listed false, use get_comp), the active comp id, AE version and project path. Filter by name (substring) or type; page with limit (200) / offset. If a newer ae-motion-mcp is known, an update field says how to update: tell the user.
Inputs: name, type, limit, offset.
get_textGet TextARead-onlyIdempotent
Read a text layer's content and styling (font, size, colors, stroke, leading, tracking, scale, caps, indents, justification, box size), at time (default: now). The layer fields are the first character's; ranges lists parts styled differently (fields that differ from them).
Inputs: layer_id (required), time.
import_footageImport FootageA
Import a file, or several (paths), into the project. as: sequence (path is its first frame), comp / comp_cropped (a layered PSD or Illustrator file as a comp of its layers). fps, loop and alpha set the footage's interpretation (set_item changes them later). folder files the imports. All files are checked before any is imported.
Inputs: as, fps, loop, name, +4 more.
link_layersLink LayersADestructive
Parent layer_ids to parent_id (null unlinks), or to a new_null created at their average position (3D if any of them is), stacked above them. jump true keeps each child's own transform values (it can visibly move). Self-links, cycles, locked layers or mixed comps are refused before anything changes.
Inputs: layer_ids (required), jump, new_null, parent_id.
list_propertiesList PropertiesARead-onlyIdempotent
Walk a layer's property tree and return names, match names, value types, values, keyframe counts and expressions. Use it to find property paths before set_property / set_keyframes.
Inputs: layer_id (required), all, time, depth, +1 more.
load_toolsLoad ToolsARead-onlyIdempotent
Show a tool group that is not listed yet, to see its tools' arguments: project (comps, import, open/save, delete items); layers (add/set/duplicate/delete/reorder/link layers, precompose, replace source); timeline (split, shift, sequence, trim, insert/delete time, markers); masks (masks, track mattes); animate (properties, keyframes, expressions, effects, presets, text, stagger, shape modifiers); motion (animate (named moves with springs), text_reveal, transition, review_motion); scene3d (3D layers, cameras, lights, camera moves/rigs/shake, 3D views); design (align, anchors, add shapes, layer styles, text to shapes); output (preview_frame, renders); audio (beat markers, audio-reactive expressions, sound-effect cues and placement); scripting (run_jsx (also needs AE_MCP_ALLOW_JSX=1)). A batch step naming one of their tools shows its group by itself.
Inputs: groups (required).
open_projectOpen ProjectADestructive
Open an After Effects project (.aep or .aepx, inside the allowed folders), or new: true for an empty one, replacing the open one. If the open project has unsaved changes it refuses, unless discard_unsaved is true (those changes are then lost; use save_project first to keep them). Returns the new project like get_project. Cannot be undone.
Inputs: new, path, discard_unsaved.
precomposePrecomposeADestructive
Precompose layers from the same comp into a new comp. move_attributes (default true) moves their transforms, effects and masks into the new comp; false ("leave all attributes", one footage, solid or precomp layer only) keeps them on the layer in the current comp.
Inputs: name (required), layer_ids (required), move_attributes.
preview_framePreview FrameARead-onlyIdempotent
Render comp frames and return them as one image (several times are tiled left to right, top to bottom). Images cost tokens by size: keep the default size, and pass several times in one call rather than calling once per time. In an edit, scene / scenes name the precomp each frame shows.
Inputs: time (required), comp_id (required), size.
render_cancelRender CancelCIdempotent
Cancel a running render job.
Inputs: job_id (required).
render_startRender StartADestructive
Save the project (saved once before) and start a background aerender job; poll render_status with the job_id. om_template / rs_template: output-module / render-settings template names (the output module picks the file extension). software: Mercury Software Only (fixes GPU failures). With ffmpeg the result is checked (black/frozen/silent spans, loudness; verify false skips); deliver: H.264 MP4 at loudness (-14 LUFS); audio_only: the mix. Renders the whole comp (not the work area); start / end (s) a part, draft: true a fast low-quality look at the motion.
Inputs: comp_id (required), output_path (required), end, draft, +9 more.
render_statusRender StatusBRead-onlyIdempotent
Get state (running|done|failed|canceled), percent, frames, eta_s, poll_after_s (wait that long), phase, check (issues in the file), errors + hint, log tail, file written.
Inputs: job_id (required).
reorder_layerReorder LayerADestructive
Change a layer's stacking order. Pass exactly one of: to, index (1 = top), before_layer_id, after_layer_id. Before means above in the stack.
Inputs: layer_id (required), to, index, after_layer_id, +1 more.
replace_sourceReplace SourceADestructiveIdempotent
Swap the footage, comp or solid a layer shows for another project item (like Alt/Option-dragging onto it), keeping the layer's timing, keyframes, masks and effects. fix_expressions (default true) updates expressions that referred to the old source. Works on footage, precomp, solid and null layers.
Inputs: item_id (required), layer_id (required), fix_expressions.
review_motionReview MotionARead-onlyIdempotent
Critique a comp's animation without rendering (cheap, no image): linear easing, holds over max_hold (changes too small to see don't count as motion: fix holds with animate push / drift), a first move later than 0.3 s, layers moving in unison, entrances with no animation, moves cut off by out points, jumps, text under min_text px (default 3% of the comp's short side), share of moves on beat markers; layers hidden behind opaque ones (3D: by depth), off screen, a background that stops filling the frame, text partly covered, text crossing the 5% title-safe margin (vertical comps: the top 10% and bottom 20% social apps cover) (scene false skips). Run after each scene and fix every warning.
Inputs: comp_id (required), all, max, scene, +2 more.
save_projectSave ProjectADestructive
Save the project. With path it does Save As (.aep or .aepx, inside the allowed folders; pass overwrite to replace an existing file). Without path it saves in place, which needs a project that has been saved once. render_start needs a saved project. clean: true first removes footage no comp uses (removed_footage counts it). snapshot: true also keeps a numbered copy in snapshots/ next to the project (note labels it); open_project on that copy goes back to it exactly.
Inputs: note, path, clean, snapshot, +1 more.
set_compSet CompBDestructiveIdempotent
Change comp settings; only the fields you pass change. work_area must fit inside the comp. motion_blur and frame_blending are the comp switches the layer switches need to render; shutter_angle default 180.
Inputs: comp_id (required), fps, name, width, +10 more.
set_expressionSet ExpressionADestructiveIdempotent
Set an expression on a property (empty string clears it), on one layer or the same property of many (layer_ids: send a shared expression once). Returns whether After Effects accepted the syntax.
Inputs: path (required), expression (required), layer_id, layer_ids.
set_itemSet ItemADestructiveIdempotent
Change a project item (comp, footage or folder): name, comment, label (0-16), folder (null: top level); footage interpretation (fps, loop, alpha); file swaps the footage's file for every layer that uses it (sequence: file is a sequence's first frame).
Inputs: item_id (required), fps, file, loop, +6 more.
set_keyframesSet KeyframesADestructiveIdempotent
Replace all keys on a property (merge: keep keys at other times; replaced: old keys removed). Path properties (ADBE Mask Shape, ADBE Vector Shape) take a shape spec as v; keep the vertex count the same across keys for clean morphs. interp spring/bounce springs the segment to the next key (works on any property). Fails if another expression is active. Returns the keys as set.
Inputs: keys (required), path (required), layer_id (required), merge.
set_layerSet LayerADestructiveIdempotent
Edit a layer; only the fields you pass change. stretch: percent (200 = half speed, negative reverses). parent_id null unparents. blend_mode: e.g. ADD, SCREEN. motion_blur / frame_blending need the switch in set_comp too. separate_dimensions: x_position / y_position / z_position. auto_orient path: along the motion path. collapse: continuously rasterize. guide: not rendered. sampling bicubic: sharper scaled images. solid_color / solid_size change the solid item (every layer using it). audio_fade: seconds of equal-power fade from the in point / to the out point (volume keys; works under duck_music).
Inputs: layer_id (required), in, out, shy, +26 more.
set_propertySet PropertyADestructiveIdempotent
Set a static value, or a value at time (creates/updates a keyframe). Animated properties need time. Use set_text for text. layer_ids sets the same property on many layers in one call (all checked first).
Inputs: path (required), value (required), time, layer_id, +1 more.
set_textSet TextADestructiveIdempotent
Set text and styling on a whole text layer; only the fields you pass change, read back in the result (skipped: what After Effects refused). font: PostScript name (find_fonts). leading turns auto leading off; stroke_color turns the stroke on; horizontal/vertical_scale in percent. box_size resizes box text (point text cannot become box text: add_layer options.box_size). time sets a keyframe. ranges style part of the text after the whole-layer fields (AE 24.3+): match (every occurrence of a string) or start/end (character indexes from 0, end exclusive, default the end). New text clears earlier part styling (ranges_cleared): pass ranges in the same call.
Inputs: layer_id (required), fill, font, size, +29 more.
staggerStaggerADestructive
Offset existing keyframes of one property across layers: layer i is shifted by i * offset_seconds. Every key setting (easing, motion-path tangents) is kept. Moves keys, not layers (whole layers: shift_layers / sequence_layers).
Inputs: path (required), layer_ids (required), offset_seconds (required), order.
text_revealText RevealBDestructive
Reveal (phase out: hide) a text layer unit by unit (text animator + expression selector). Each unit takes duration and starts stagger after the previous. mask clips rise/drop at a line so letters slide out from behind it. Returns the end time.
Inputs: layer_id (required), by, ease, mask, +7 more.
transitionTransitionC
Add a shape transition on top that covers the frame at time (cut scenes there) and clears by time + duration/2: wipe, bars (staggered stripes) or iris (disc grows, then opens from its centre).
Inputs: time (required), comp_id (required), bars, type, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Most tools target a clearly distinct resource+action (set_property vs set_keyframes vs edit_keyframes vs copy_animation are explicitly delimited, and get_text/get_layer/list_properties are separated by granularity). A few pairs need reading the description to separate (get_comp vs get_project vs get_layer, apply_effect vs edit_effect vs apply_preset), but the descriptions disambiguate them and set_property even points to set_text for text.
Consistent snake_case with a mostly verb_noun shape (get_layer, set_keyframes, delete_item, render_start, find_fonts). A handful are bare verbs or verb-object without a resource noun (precompose, stagger, animate, transition, batch), which is readable but a minor deviation from the dominant pattern.
46 exposed tools is well above the comfortable range for a single server surface, even for a large domain like After Effects automation. The load_tools progressive-disclosure groups mitigate this somewhat by deferring timeline, masks, scene3d, audio and scripting tools, but the top-level set is still heavy and increases selection cost.
Core lifecycle is covered end to end: projects (open/save/import), comps, layers, properties, keyframes, expressions, effects, text, previews and renders with polling/cancel. Gaps are minor and mostly deferred rather than missing (splitting, masks, cameras/lights, markers, audio live in load_tools groups), and there is no top-level undo control.
Maintenance
Related MCP Connectors
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
Compose, edit and render video with your AI agent. Turn footage into finished edits with content-aware reframing, word-timed captions and motion graphics. Hosted MCP with OAuth sign-in; cloud processing uses credits.
Creator MCP is the hosted LottieFiles animation engine for AI agents. Your agent builds real motion with layers, shapes and keyframes, then exports MP4, WebM, Lottie or dotLottie. Use it for logo reveals, product promos, social clips and UI animations. You can import SVGs, images and existing Lottie files, and open any scene in Lottie Creator to fine-tune it frame by frame. Setup is one URL and a LottieFiles sign-in.
An MCP connector for Adobe After Effects. Real, editable layers and keyframes, not scripts.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control Adobe After Effects through a standardized MCP protocol, providing tools for composition creation, layer management, and animation.-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients like Claude Code, Claude Desktop, and VS Code to build and edit inside a running Adobe After Effects, covering comps, layers, keyframes, effects, text animators, markers, and renders. It supports batched tool calls with single-step undo, frame previews for self-verification, reusable style tokens, and four one-call studio rigs.MIT
- AlicenseNot gradedqualityCmaintenanceLets Claude Code or any MCP client drive an open Adobe After Effects instance to inspect projects and comps, build and animate layers with ExtendScript, preview frames as images, import footage, and render comps with live progress reporting. All changes land as single undoable steps, and communication stays local through a token-protected bridge.182 npmMIT
- AlicenseAqualityBmaintenanceConnects Claude to a running Adobe After Effects so it can build eased keyframes, motion presets, kinetic typography, PSD-to-animation scenes, transitions and speed ramps, then review, polish and render deliverables. It also exposes a knowledge base of motion-design notes plus 262 operations across the full After Effects surface, with each edit applied as a single undo step.1812MIT