After Effects MCP Server
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 Server Create a new composition and add a text layer saying 'Hello World'."
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 Server
β¨ A Model Context Protocol (MCP) server for Adobe After Effects that enables AI assistants and other applications to control After Effects through a standardized protocol.
Forked from Dakkshin/after-effects-mcp, extended with an EN -> VI localization toolset (extract text layers, match against a .docx translation table, apply back while preserving formatting). See LOCALIZE_PLAN.md for the pipeline design and status.
Table of Contents
Related MCP server: after-effects-mcp
π¦ Features
π₯ Core Composition Features
Create compositions with custom settings (size, frame rate, duration, background color)
List all compositions in a project
Get project information such as frame rate, dimensions, and duration
π§± Layer Management
Create text layers with customizable properties (font, size, color, position)
Create shape layers (rectangle, ellipse, polygon, star) with colors and strokes
Create solid/adjustment layers for backgrounds and effects
Create camera layers with configurable zoom and position
Create null objects for animation control
Modify layer properties like position, scale, rotation, opacity, timing
Toggle 2D/3D mode for layers
Set blend modes (normal, multiply, screen, etc.)
Track matte support (alpha, luma, inverted)
Duplicate layers with optional rename
Delete layers from composition
Create/modify masks with feather, expansion, and opacity
π Animation Capabilities
Set keyframes for layer properties (Position, Scale, Rotation, Opacity, etc.)
Apply expressions to layer properties for dynamic animations
Batch set properties across multiple layers at once
βοΈ Setup Instructions
π Prerequisites
Adobe After Effects (2022 or later)
Node.js (v14 or later)
npm or yarn package manager
π₯ Installation
Clone the repository
git clone https://github.com/Dakkshin/after-effects-mcp.git cd after-effects-mcpInstall dependencies
npm install # or yarn installBuild the project
npm run build # or yarn buildInstall the After Effects panel
npm run install-bridge # or yarn install-bridgeThis will copy the necessary scripts to your After Effects installation.
π§ Update MCP Config
Option 1: Using .mcp.json (Recommended for Claude Code)
The repository includes a .mcp.json file for easy configuration. Copy or reference it in your MCP settings:
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["PATH/TO/after-effects-mcp/build/index.js"]
}
}
}Option 2: Manual Configuration
Go to your client (e.g., Claude or Cursor) and update your config file:
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
}
}
}βΆοΈ Running the Server
Start the MCP server
npm start # or yarn startOpen After Effects
Open the MCP Bridge Auto panel
In After Effects, go to Window > mcp-bridge-auto.jsx
The panel will automatically check for commands every few seconds
Make sure the "Auto-run commands" checkbox is enabled
π Usage Guide
Once you have the server running and the MCP Bridge panel open in After Effects, you can control After Effects through the MCP protocol. This allows AI assistants or custom applications to send commands to After Effects.
π Creating Compositions
You can create new compositions with custom settings:
Name
Width and height (in pixels)
Frame rate
Duration
Background color
Example MCP tool usage (for developers):
mcp_aftereffects_create_composition({
name: "My Composition",
width: 1920,
height: 1080,
frameRate: 30,
duration: 10
});βοΈ Working with Layers
You can create and modify different types of layers:
Text layers:
Set text content, font, size, and color
Position text anywhere in the composition
Adjust timing and opacity
Shape layers:
Create rectangles, ellipses, polygons, and stars
Set fill and stroke colors
Customize size and position
Solid layers:
Create background colors
Make adjustment layers for effects
πΉ Animation
You can animate layers with:
Keyframes:
Set property values at specific times
Create motion, scaling, rotation, and opacity changes
Control the timing of animations
Expressions:
Apply JavaScript expressions to properties
Create dynamic, procedural animations
Connect property values to each other
π Available MCP Tools
Command | Description |
| Create a new composition |
| Run a JS script inside AE |
| Get script results |
| Help for available commands |
| Add keyframe to layer property |
| Add/remove expressions from properties |
| Set layer properties (position, scale, rotation, opacity, blendMode, threeDLayer, trackMatteType, enabled, etc.) |
| Apply properties to multiple layers |
| Get layer info (position, 3D status) |
| Create camera layer |
| Create null object for animation |
| Duplicate a layer |
| Delete a layer |
| Create/modify layer masks |
π¨βπ» For Developers
π§© Project Structure
src/index.ts: MCP server implementationsrc/scripts/mcp-bridge-auto.jsx: Main After Effects panel scriptinstall-bridge.js: Script to install the panel in After Effects
π¦ Building the Project
npm run build
# or
yarn buildNote: This project uses esbuild for fast builds, replacing the previous TypeScript compiler approach that could run out of memory on larger codebases.
π€ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Star History
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
16 toolsapply-effectC
Apply an effect to a layer in After Effects
Inputs: compIndex (required), layerIndex (required), effectName, presetPath, +3 more.
apply-effect-templateB
Apply a predefined effect template to a layer in After Effects
Inputs: compIndex (required), layerIndex (required), templateName (required), customSettings.
apply-text-translationsA
Apply matched translations back onto their text layers in After Effects, preserving font/size/box formatting. Reports any box-text layers that overflow after translation.
Inputs: translationsPath.
create-compositionA
Create a new composition in After Effects with specified parameters
Inputs: name (required), width (required), height (required), duration, +3 more.
extract-text-layersA
Extract every text layer (compIndex, layerIndex, current text) from the open After Effects project. Saves the result to a working file for the match-glossary step.
Inputs: compName.
get-helpA
Get help on using the After Effects MCP integration
Inputs: no named parameters.
get-resultsB
Get results from the last script executed in After Effects
Inputs: no named parameters.
match-glossaryA
Match text layers previously extracted with extract-text-layers against a 2-column (English | Vietnamese) table in a .docx file. Writes translations.json (ready for apply-text-translations) and reports any unmatched strings.
Inputs: docxPath (required), extractedTextPath.
mcp_aftereffects_applyEffectC
Apply an effect to a layer in After Effects
Inputs: compIndex (required), layerIndex (required), effectName, effectSettings, +1 more.
mcp_aftereffects_applyEffectTemplateC
Apply a predefined effect template to a layer in After Effects
Inputs: compIndex (required), layerIndex (required), templateName (required), customSettings.
mcp_aftereffects_get_effects_helpB
Get help on using After Effects effects
Inputs: no named parameters.
run-bridge-testA
Run the bridge test effects script to verify communication and apply test effects
Inputs: no named parameters.
run-scriptA
Run a read-only script in After Effects
Inputs: script (required), parameters.
setLayerExpressionB
Set or remove an expression for a specific layer property.
Inputs: compIndex (required), layerIndex (required), propertyName (required), expressionString (required).
setLayerKeyframeB
Set a keyframe for a specific layer property at a given time.
Inputs: compIndex (required), layerIndex (required), propertyName (required), timeInSeconds (required), +1 more.
test-animationD
Test animation functionality in After Effects
Inputs: compIndex (required), operation (required), layerIndex (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 16 tools
Several tools have nearly identical descriptions and purposes: apply-effect and mcp_aftereffects_applyEffect, apply-effect-template and mcp_aftereffects_applyEffectTemplate, plus potentially overlapping help utilities. An agent would struggle to select the intended tool.
Naming conventions are mixed: most tools use kebab-case (apply-text-translations, run-script) but setLayerKeyframe and setLayerExpression use camelCase, and the mcp_aftereffects_ prefixed duplicates add another pattern. This inconsistency and the presence of duplicate names makes the naming feel chaotic.
16 tools is slightly above the ideal range but still acceptable for an After Effects integration spanning scripts, effects, animations, and a translation workflow. The count is padded by duplicates and test utilities, so it earns a 4 rather than a 5.
The translation workflow (extract-text-layers β match-glossary β apply-text-translations) is well covered, and basic AE operations like create-composition, keyframes, expressions, and effects exist. However, there are notable gaps such as no layer/composition deletion or querying, and the presence of test-only tools suggests the surface is not fully fleshed out.
Maintenance
Related MCP Connectors
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
AI video, image and audio generation with 140+ AI models from any MCP agent
Direct AI video, image, music and storyboard production from any MCP client.
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.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe After Effects through the MCP protocol, including composition creation, layer management, and animation.13MIT
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control Adobe After Effects through a standardized MCP protocol, providing tools for composition creation, layer management, and animation.-
- AlicenseBqualityDmaintenanceEnables control of Adobe After Effects via natural language, allowing project manipulation, layer creation, animation, and rendering through MCP.72MIT
- AlicenseCqualityDmaintenanceEnables AI assistants and applications to control Adobe After Effects through the Model Context Protocol for composition, layer management, and animation.13MIT