Skip to main content
Glama
AE Motion MCP
by dha-aa

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:

  1. A small program on your computer that Claude talks to.

  2. 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)

  1. 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.)

  2. Do the two steps below in After Effects, then tell Claude you're done. Claude checks that everything works.

Install by hand

  1. Install Node.js and git.

  2. Open a terminal and run:

    git clone https://github.com/dha-aa/ae-motion.git
    cd ae-motion
    node scripts/update.ts
  3. Do the two steps below in After Effects.

  4. Check it: run node scripts/check.ts --ae in 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.

  1. 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.

  2. 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?"

get_project get_comp get_layer list_properties get_keyframes find_effects

Project and comps

"Make a 1080x1920 comp for Reels"

open_project save_project create_comp set_comp import_footage set_item delete_item

Layers

"Add a title and a logo, parent the logo to it"

add_layer set_layer link_layers replace_source delete_layer duplicate_layer reorder_layer precompose

Timeline and editing

"Cut 3s to 5s out and close the gap"

split_layer delete_range insert_time shift_layers sequence_layers align_to_markers trim_comp set_playhead add_marker update_marker list_markers delete_marker

Masks and mattes

"Reveal the text through a wipe"

add_mask set_track_matte

Layout and design

"Center the title and give it a soft shadow"

align_layers set_anchor add_shape add_layer_style text_to_shapes

Animation and effects

"Ease the logo in, then add a glow"

set_property set_keyframes edit_keyframes copy_animation set_expression add_property apply_effect edit_effect apply_preset set_text get_text find_fonts stagger add_shape_modifier

Ready-made motion

"Pop the cards in with a spring"

animate text_reveal transition review_motion

3D and camera

"Orbit the camera around the product"

get_camera set_camera camera_move camera_shake camera_rig set_3d set_light set_3d_view

Audio

"Cut the clips to the beat, duck the music under the voice"

beat_markers audio_react find_sound_cues add_sfx duck_music

Preview and render

"Show me frame 2s, then render an MP4"

preview_frame render_start render_status render_cancel

Power tools

"Check for updates"

batch check_for_updates run_jsx (off unless you turn it on)

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 --ae prints.

  • 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

MIT

Available Tools

46 tools
add_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.

animateAnimateA
Destructive

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 PresetB
Destructive

Apply an .ffx animation preset to a layer. Path must be inside the allowed folders.

Inputs: ffx_path (required), layer_id (required).

batchBatchA
Destructive

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 UpdatesA
Read-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 AnimationA
Destructive

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 ItemA
DestructiveIdempotent

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 LayerC
DestructiveIdempotent

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 EffectA
Destructive

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 KeyframesA
Destructive

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 EffectsA
Read-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 FontsA
Read-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 CompA
Read-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 KeyframesA
Read-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 LayerA
Read-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 ProjectA
Read-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 TextA
Read-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.

list_propertiesList PropertiesA
Read-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 ToolsA
Read-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 ProjectA
Destructive

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.

precomposePrecomposeA
Destructive

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 FrameA
Read-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 CancelC
Idempotent

Cancel a running render job.

Inputs: job_id (required).

render_startRender StartA
Destructive

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 StatusB
Read-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 LayerA
Destructive

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 SourceA
DestructiveIdempotent

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 MotionA
Read-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 ProjectA
Destructive

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 CompB
DestructiveIdempotent

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 ExpressionA
DestructiveIdempotent

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 ItemA
DestructiveIdempotent

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 KeyframesA
DestructiveIdempotent

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 LayerA
DestructiveIdempotent

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 PropertyA
DestructiveIdempotent

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 TextA
DestructiveIdempotent

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.

staggerStaggerA
Destructive

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 RevealB
Destructive

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

    B3.2/5.0

    Scored across 46 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to control Adobe After Effects through a standardized MCP protocol, providing tools for composition creation, layer management, and animation.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets 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 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Connects 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.
      18
      12
      MIT