after-effects-mcp
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., "@after-effects-mcp Create a new composition called 'Intro' at 1920x1080, 30fps, 10 seconds long."
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.
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_framereturns a PNG still so agents can verify workResources —
ae://project,ae://docs/*Prompts — lower-third, kinetic type, debug comp
Companion skill —
skills/after-effects-mcp/SKILL.mdEditorial 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 |
|
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 |
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-bridgeIf 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 ensureMCP 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 |
| MCP stdio server (default) |
| Check live bridge / AE |
| Copy Startup bootstrap into AE script folders |
Typical agent workflow
ae_healthae_create_composition/ae_get_compositionae_create_layer→ae_set_keyframes/ae_set_expression/ae_apply_effectae_capture_frame— look at the stillIterate
Tool catalog (v0.1)
Tool | Purpose |
| Connection + project snapshot |
| Live AE instances |
| Project summary |
| Comp index |
| Comp + layers |
| New comp |
| Layers |
| Layer ops ( |
| Animation |
| Effects |
| Find items/layers by name |
| PNG still (+ image content) |
| Multi-frame visual QA manifest |
| Sentence-aware YouTube edit decision list |
| Pacing, hook, coverage, and cut-quality audit |
| Approval-aware YouTube edit builder |
| Brand-aware reusable AE motion graphic |
| Create the canonical motion-video plan |
| Explain timing, brand, scene, and template problems |
| Verify beat choreography, object motion, scene variation, and settle moments |
| Apply safe deterministic blueprint repairs |
| Build, QA, preview-render, and review a complete motion video |
| Automatic AE render/export preset |
| Preview approval workflow |
| Escape hatch |
Architecture
MCP client → ae-mcp (stdio) → in-process broker → ~/.ae-mcp/instances/<id>/
command.json → result.json
← AE Startup bootstrap.jsxDevelopment
npm run build
npm test
npm run typecheckBefore publishing changes, run the full local release check described in the installation guide.
License
MIT
Available Tools
48 toolsae_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_searchA
Search project items and layers by name substring. Prefer this over listing everything in large projects.
Inputs: query (required), limit, include_layers.
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
Scored across 48 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Remote MCP server for AI.TV creators — delegate account operations to your AI agent over MCP.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol (MCP) server for Adobe After Effects that enables AI assistants and other applications to control After Effects through a standardized protocol.213895MIT
- AlicenseAqualityDmaintenanceAn MCP server that allows AI agents to control Adobe After Effects, enabling project inspection, composition creation, layer addition, file import, ExtendScript execution, and rendering via aerender.11MIT
- AlicenseCqualityDmaintenanceLocal MCP server to control Adobe After Effects from AI clients like Claude and Cursor, supporting project composition, layer editing, animation, masks, and effects.13MIT
- AlicenseNot gradedqualityBmaintenanceA local MCP server that connects AI agents to Adobe After Effects, enabling reliable project inspection, reasoning, and controlled mutations through structured tools and typed patches.1MIT