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 1920x1080 at 30fps for 5 seconds"
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
Custom repository: This repository preserves the upstream implementation and adds a portable MCP configuration plus a complete Korean guide for Adobe After Effects 2026 and Codex. See README_KO.md for installation, verification, troubleshooting, updates, and removal.
✨ 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.
Table of Contents
Related MCP server: AE MCP Server
📦 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 (2021 through 2026)
Node.js (v18 or later; v22 recommended)
npm or yarn package manager
📥 Installation
Clone the repository
git clone https://github.com/yohaey/aftereffect_mcp_custom.git cd aftereffect_mcp_customInstall 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:\\absolute\\path\\to\\aftereffect_mcp_custom\\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
13 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.
create-compositionA
Create a new composition in After Effects with specified parameters
Inputs: name (required), width (required), height (required), duration, +3 more.
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.
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 13 tools
There are clear duplicates: apply-effect and mcp_aftereffects_applyEffect have identical descriptions, as do apply-effect-template and mcp_aftereffects_applyEffectTemplate. Also, get-help and mcp_aftereffects_get_effects_help overlap. This causes ambiguity and misselection risk.
Naming conventions are mixed: some use snake_case with hyphens (apply-effect), some camelCase (setLayerExpression), and some have a long prefix 'mcp_aftereffects_'. No consistent pattern, making it hard to guess tool names.
13 tools is a reasonable number for an After Effects server, but the presence of duplicate tools (at least 3 redundant pairs) inflates the count unnecessarily. The effective unique tool count is lower.
Covers basic operations like composition creation, effect application, keyframes, expressions, and script execution. However, missing fundamental layer operations (e.g., create shape, text, solid) and lacks clear CRUD for layers. Duplicates suggest incomplete design.
Maintenance
Related MCP Connectors
MCP server for Wan AI video generation
MCP server for Google Veo AI video generation
MCP server for Hailuo (MiniMax) AI video generation
MCP server for Luma Dream Machine AI video generation
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.213182 npm882MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to control Adobe After Effects through a file-based communication bridge. It supports various operations including project and composition management, layer and keyframe manipulation, rendering, and batch processing.9227 npm21MIT
- 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