Skip to main content
Glama

After Effects MCP

A production-minded Model Context Protocol server for Adobe After Effects.

Headless Startup bridge · sync tool calls · hybrid high-level tools + JSX escape hatch · composition frame capture as images · resources & prompts for agents.

Build motion graphics, review cuts, and render YouTube-ready projects from an MCP client while keeping After Effects as the execution environment.

Documentation

Related MCP server: After Effects MCP

Features

  • Headless by default — no “open panel + Auto-run” required

  • Sync-feeling RPC — tools wait for AE (request IDs, timeouts, clear errors)

  • Motion tools — comps, layers (text/shape/solid/null/camera…), keyframes, expressions, effects

  • Vision — ae_capture_frame returns a PNG still so agents can verify work

  • Resources — ae://project, ae://docs/*

  • Prompts — lower-third, kinetic type, debug comp

  • Companion skill — skills/after-effects-mcp/SKILL.md

  • Editorial planning — sentence-aware cut scoring, explainable EDLs, clean/retention/story modes, YouTube structure, chapters, and b-roll/graphic suggestions

  • Quality workflow — multi-frame QA, saved preview reviews, approve/reject decisions, and autonomous or approval-gated builds

  • Motion system — reusable brand-aware hook, lower-third, chapter, statistic, quote, subscribe, and end-screen templates

  • One-shot motion videos — canonical blueprints, visual grammar, coherence validation, deterministic scene builds, multi-frame QA, repair passes, and approval-aware previews

  • Export presets — automatic MP4, MOV, and PNG render presets with explicit output paths

Requirements

  • Adobe After Effects 2022+

  • Node.js 20+

  • AE preference: Edit → Preferences → Scripting & Expressions → Allow Scripts to Write Files and Access Network

Connection model (important)

When

What you do

One-time setup

install-bridge, enable scripting file/network access, open AE once

Day-to-day

Leave After Effects open. Only restart the AI client (Grok / Claude / Cursor)

If tools go quiet

AI client restart is enough — MCP auto-kicks the bridge into running AE. Or run ae-mcp ensure

You should not need to restart After Effects every time you reconnect the AI.

How it works: when the MCP server starts (AI client launch), it runs AfterFX.exe -r ae-mcp-ensure.jsx against the already open AE session, restarts the headless poller, and a watchdog re-kicks if heartbeats die.

Install

git clone https://github.com/HeroicSwan/after-effects-mcp.git ae-mcp
cd ae-mcp
npm install
npm run build
npm run install-bridge

If AE was already open during install, restart AE once so Startup bootstrap loads. After that, only restart the AI client.

npm run health
# or force reconnect without touching AE:
node dist/index.js ensure

MCP client config

Claude / Cursor / generic

{
  "mcpServers": {
    "ae-mcp": {
      "command": "node",
      "args": ["C:/Users/YOU/Projects/ae-mcp/dist/index.js", "serve"]
    }
  }
}

Grok / Codex / Claude Code

Point the MCP server command at node + absolute path to dist/index.js with arg serve.

The After Effects panel can write the Codex entry directly into C:\Users\YOU\.codex\config.toml. Restart Codex after installing it.

ChatGPT

ChatGPT uses a remotely reachable HTTPS MCP endpoint rather than launching this local Windows stdio command directly. Select ChatGPT (remote MCP) in the After Effects panel to create ~/.ae-mcp/chatgpt-setup.json and a setup guide. Set AE_MCP_CHATGPT_MCP_URL before setup if you already have an authenticated HTTPS relay. Never expose the local bridge without authentication.

CLI

Command

Description

ae-mcp serve

MCP stdio server (default)

ae-mcp health

Check live bridge / AE

ae-mcp install-bridge

Copy Startup bootstrap into AE script folders

Typical agent workflow

  1. ae_health

  2. ae_create_composition / ae_get_composition

  3. ae_create_layer → ae_set_keyframes / ae_set_expression / ae_apply_effect

  4. ae_capture_frame — look at the still

  5. Iterate

Tool catalog (v0.1)

Tool

Purpose

ae_health

Connection + project snapshot

ae_list_instances

Live AE instances

ae_get_project_info

Project summary

ae_list_compositions

Comp index

ae_get_composition

Comp + layers

ae_create_composition

New comp

ae_get_layer / ae_create_layer / ae_set_layer_properties

Layers

ae_duplicate_layer / ae_delete_layer

Layer ops (confirm for delete)

ae_set_keyframes / ae_set_expression

Animation

ae_apply_effect / ae_set_effect_property / ae_list_effects / ae_remove_effect

Effects

ae_search

Find items/layers by name

ae_capture_frame

PNG still (+ image content)

ae_capture_frames

Multi-frame visual QA manifest

ae_create_editorial_plan

Sentence-aware YouTube edit decision list

ae_audit_editorial_plan

Pacing, hook, coverage, and cut-quality audit

ae_build_youtube_edit

Approval-aware YouTube edit builder

ae_create_motion_template

Brand-aware reusable AE motion graphic

ae_create_motion_blueprint

Create the canonical motion-video plan

ae_validate_motion_blueprint

Explain timing, brand, scene, and template problems

ae_audit_motion_coverage

Verify beat choreography, object motion, scene variation, and settle moments

ae_repair_motion_blueprint

Apply safe deterministic blueprint repairs

ae_build_motion_video

Build, QA, preview-render, and review a complete motion video

ae_render_composition

Automatic AE render/export preset

ae_create_review / ae_decide_review

Preview approval workflow

ae_run_jsx

Escape hatch

Architecture

MCP client → ae-mcp (stdio) → in-process broker → ~/.ae-mcp/instances/<id>/
                                                     command.json → result.json
                                              ← AE Startup bootstrap.jsx

Development

npm run build
npm test
npm run typecheck

Before publishing changes, run the full local release check described in the installation guide.

License

MIT

Available Tools

48 tools
ae_analyze_cutsA

Analyze a video with ffmpeg silencedetect and return KEEP segments (content) vs silence to remove. Use this BEFORE cutting — never guess random cut points. Requires ffmpeg on PATH. Prefer ae_transcribe_video + ae_transcript_to_cuts when you need to remove stutters/fillers (speech-aware).

Inputs: path (required), min_keep, noise_db, min_silence, +1 more.

ae_apply_effectB

Apply an effect by display name or matchName (e.g. "Gaussian Blur" or "ADBE Gaussian Blur 2").

Inputs: effect (required), comp_name, comp_index, layer_name, +1 more.

ae_audit_editorial_planA

Run a pre-build quality audit on a YouTube editorial plan. Reports hook, pacing, coverage, chapter, and unsafe short-cut issues without mutating After Effects.

Inputs: plan (required).

ae_audit_motion_coverageA

Check whether a motion blueprint requests real object choreography, impact beats, scene variation, and readable settle moments instead of a fade-led card sequence.

Inputs: blueprint (required).

ae_build_motion_videoB

One-shot motion-graphics workflow: validate and repair a blueprint, build deterministic named scenes in After Effects, capture QA frames, render a preview or final output, and create an approval review.

Inputs: brief, energy, render, scenes, +10 more.

ae_build_smart_editA

Import footage (optional if already in project) and build a sequential edit comp from KEEP segments (from ae_analyze_cuts). Cuts on silence/dead air — not random. Does not add subtitle bars.

Inputs: segments (required), path, comp_name, frameRate, +1 more.

ae_build_youtube_editB

Analyze a transcript and optionally build a YouTube edit in After Effects. In approval mode it returns a full editorial plan until approved=true; in autonomous mode it builds immediately. Use clean, retention, or story mode.

Inputs: mode, path, approved, comp_name, +5 more.

ae_capture_frameA

Render a still PNG of a composition at a given time (seconds) and return it as an image when possible. Use after visual changes so you can verify the result. Defaults to current CTI time.

Inputs: time, max_size, comp_name, comp_index.

ae_capture_framesA

Capture multiple composition frames for visual QA and return a frame manifest.

Inputs: times (required), comp_name, comp_index.

ae_create_compositionA

Create a new composition. Defaults: 1920x1080, 30fps, 5 seconds. bgColor is RGB 0–1 floats, e.g. [0,0,0].

Inputs: name (required), width, height, bgColor, +3 more.

ae_create_editorial_planA

Create an explainable YouTube edit plan from a timed transcript. Scores natural cut points, identifies a hook, suggests chapters and visuals, and returns a reviewable plan before any AE mutation.

Inputs: mode, transcript, transcript_path.

ae_create_layerA

Create a layer in a composition. type: text|solid|shape|null|camera|light|adjustment. For text pass text/fontSize/fillColor. Colors are RGB 0–1. Position is [x,y] or [x,y,z].

Inputs: type (required), font, name, text, +14 more.

ae_create_motion_blueprintB

Create a canonical, explainable motion-graphics video blueprint without mutating After Effects. The blueprint is the shared source of truth for scenes, brand, timing, templates, QA, and rendering.

Inputs: brief (required), energy, scenes, duration, +6 more.

ae_create_motion_templateC

Create a reusable, brand-aware motion graphic directly in an After Effects composition.

Inputs: template_id (required), end, text, start, +5 more.

ae_create_reviewB

Create a saved review item with preview frames and optional render metadata. Approval mode should use this before final delivery.

Inputs: comp (required), frames (required), render, plan_path.

ae_create_subtitleA

Add a subtitle/caption text layer. DEFAULT: white text + black stroke for readability — NEVER adds a black bar/plate behind text unless background_bar=true (only when the user explicitly asks). Prefer this over solids for captions.

Inputs: text (required), inPoint (required), outPoint (required), y, +9 more.

ae_decide_reviewB

Approve or reject a saved preview review item with notes.

Inputs: decision (required), review_id (required), notes.

ae_delete_layerA

Delete a layer. DESTRUCTIVE — requires confirm=true.

Inputs: confirm (required), comp_name, comp_index, layer_name, +1 more.

ae_duplicate_layerB

Duplicate a layer; optionally rename the copy.

Inputs: new_name, comp_name, comp_index, layer_name, +1 more.

ae_get_compositionB

Get composition settings and layer index. Use response_format=detailed for layer list.

Inputs: comp_name, comp_index, response_format.

ae_get_layerA

Get layer details (transforms, timing, effects). Prefer layer_name; use layer_index if names collide.

Inputs: comp_name, comp_index, layer_name, layer_index, +1 more.

ae_get_project_infoA

Get the open AE project summary: name, path, bits, and composition index. Prefer this over dumping the full project tree.

Inputs: response_format.

ae_get_workflow_preferencesA

Read the AE MCP workflow mode, edit mode, and brand defaults. Approval mode is the safe default; autonomous mode lets high-level workflows proceed without an extra approval gate.

Inputs: no named parameters.

ae_healthA

Check After Effects bridge status only. Never runs scripts in AE (no 'Executing script…' popup). If disconnected, restart AE once or call ae_reconnect once.

Inputs: no named parameters.

ae_import_3d_from_blenderA

Import a finished Blender exchange job into After Effects as a transparent PNG sequence (real 3D render). Runs verify first. Creates a dedicated comp and layer. After import you MUST ae_capture_frame to prove the layer is visible.

Inputs: jobId (required), threeD, comp_name, frameRate, +3 more.

ae_import_footageB

Import a video/image/audio file into the AE project from an absolute path.

Inputs: path (required).

ae_list_blender_jobsA

List Blender→AE exchange jobs under ~/.ae-mcp/blender-exchange/

Inputs: no named parameters.

ae_list_compositionsA

List compositions in the open project (name, size, fps, duration, layer count).

Inputs: no named parameters.

ae_list_effectsA

List effects on a layer (name, matchName, index).

Inputs: comp_name, comp_index, layer_name, layer_index.

ae_list_instancesA

List live After Effects instances reporting heartbeats to the file bridge.

Inputs: no named parameters.

ae_list_motion_templatesA

List the reusable motion-graphics templates the agent can use when planning a YouTube video.

Inputs: aspect_ratio.

ae_list_reviewsA

List pending, approved, and rejected AE MCP review items.

Inputs: no named parameters.

ae_prepare_blender_3d_jobA

MANDATORY first step when user asks for REAL 3D models in AE. Creates an exchange folder and returns (1) paths + (2) Blender Python to run via blender MCP execute_blender_code. AE cannot load .blend meshes natively — Blender must render a transparent PNG sequence (and optional GLB/OBJ). After Blender finishes, call ae_import_3d_from_blender.

Inputs: fps, frames, job_name, resolution, +1 more.

ae_reconnectA

USER-INITIATED ONLY. Runs AfterFX -r once (shows a brief 'Executing script…' dialog). Prefer restarting AE instead for a silent Startup load. 30s cooldown.

Inputs: no named parameters.

ae_remove_effectB

Remove an effect from a layer by effect_name or effect_index.

Inputs: comp_name, comp_index, layer_name, effect_name, +2 more.

ae_render_compositionB

Render a composition with an automatic export preset. The render must still be visually reviewed before delivery.

Inputs: format, comp_name, comp_index, output_path, +1 more.

ae_repair_motion_blueprintB

Apply deterministic safe repairs to scene timing, template ids, and graphic text limits, then return the before/after coherence audit.

Inputs: blueprint (required).

ae_run_jsxA

Escape hatch: run a Function-body of ExtendScript. Receives args parameter. Always undo-grouped. Use mode=unsafe for arbitrary code. Prefer high-level tools when possible. Return a JSON-serializable value.

Inputs: code (required), args, mode, description.

ae_set_effect_propertyC

Set a property on an effect instance. Identify effect by effect_name or effect_index (1-based).

Inputs: value (required), property (required), comp_name, comp_index, +4 more.

ae_set_expressionA

Set or clear an expression on a layer property. Pass expression string, or empty string/null to clear. Example: wiggle(2, 30).

Inputs: property (required), expression (required), comp_name, comp_index, +2 more.

ae_set_keyframesB

Set keyframes on a layer property. property uses path aliases: Transform/Position, Transform/Scale, Transform/Rotation, Transform/Opacity (or matchNames). keyframes: [{time: seconds, value: number|array}].

Inputs: property (required), keyframes (required), comp_name, comp_index, +2 more.

ae_set_layer_propertiesC

Set transform/timing/name/parent on a layer. position [x,y], scale [x,y] percent, rotation degrees, opacity 0-100.

Inputs: name, scale, enabled, inPoint, +11 more.

ae_set_workflow_preferencesC

Set autonomous or approval workflow behavior and project brand defaults used by high-level editing workflows.

Inputs: edit_mode, font_family, safe_margin, accent_color, +5 more.

ae_transcribe_videoA

Transcribe a video/audio file with timestamps (segments + word-level when available). Saves JSON under ~/.ae-mcp/transcripts/. Requires Python + faster-whisper (or openai-whisper) and ffmpeg. Use result with ae_transcript_to_cuts for filler/stutter removal edits.

Inputs: path (required), model, language.

ae_transcript_to_cutsA

From a timed transcript, remove fillers (um/uh/like/you know/…) and stutters (repeated words), then build KEEP timeline segments with pad_before/pad_after so cuts have a little breathing room. Pass segments to ae_build_smart_edit. Also returns cleaned text + SRT for subtitles (use ae_create_subtitle — no black bars).

Inputs: merge_gap, pad_after, pad_before, transcript, +5 more.

ae_validate_motion_blueprintB

Run explainable coherence checks on a motion blueprint without mutating After Effects.

Inputs: blueprint (required).

ae_verify_blender_jobA

VERIFY GATE before AE import. Checks frame count, that frames actually differ (animation rendered), and mesh exports. MUST pass before ae_import_3d_from_blender. Do not claim 3D is done if this fails.

Inputs: jobId (required), min_frames.

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 48 tools

    Disambiguation4/5

    Most tools target a clear resource-action pair, and the high-level workflow tools are distinguished by their descriptions (silence-based cuts vs. transcript-based cuts, blueprint validation vs. audit vs. repair). A few pairs like ae_capture_frame/ae_capture_frames and ae_build_smart_edit/ae_build_youtube_edit could be momentarily confused, but their stated purposes are ultimately distinct.

    Naming Consistency4/5

    The tool names consistently use the ae_ prefix, snake_case, and mostly follow a verb_noun pattern such as list_compositions, create_layer, render_composition, and decide_review. Minor deviations like ae_health, ae_reconnect, ae_search, and ae_run_jsx break the strict pattern but do not create significant confusion.

    Tool Count2/5

    With 48 tools, this server is well past the 25+ threshold for a heavy tool count. The breadth is understandable given the mix of low-level AE operations, editorial planning, review workflows, and Blender integration, but the aggregate surface creates real agent selection overhead and would benefit from modular splitting.

    Completeness4/5

    The server covers the main After Effects lifecycle well: compositions, layers, effects, keyframes, expressions, rendering, reviews, and high-level motion/editorial workflows. Minor gaps exist, such as no direct tool for updating text layer content, renaming/deleting compositions, or reordering effects, but the ae_run_jsx escape hatch mitigates these.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers