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 10-second 1920x1080 composition with a text layer saying 'Hello'"
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.

Brought to you by Brandkick - We grow brands like they're our own.
After Effects MCP Server
A Model Context Protocol server for Adobe After Effects. Enables AI assistants to control After Effects through a WebSocket-based CEP panel.
Requirements
Adobe After Effects 2021+ (versions 18.x - 26.x)
Node.js 18+
pnpm
Related MCP server: After Effects MCP Server
Installation
git clone https://github.com/Brandkick/after-effects-mcp.git
cd after-effects-mcp
pnpm install
just setupConfiguration
Add to Claude Code config (~/.claude.json):
{
"mcpServers": {
"aftereffects": {
"command": "node",
"args": ["/path/to/after-effects-mcp/build/index.js"]
}
}
}Usage
Claude Code starts the MCP server automatically
Open After Effects
Open the panel: Window > Extensions > MCP Bridge
Setup: JPEG Output Template
For exportCompFrame to work, create a JPEG output template in After Effects:
Create any composition
File > Export > Add to Render Queue
Click "Output Module" settings
Set Format to "JPEG Sequence"
Set Quality to 50-70% (faster previews, smaller files)
Optionally resize: check "Resize" and set to 50% or a fixed size like 960x540
Click the template dropdown (top of dialog)
Select "Save As New Template..."
Name it exactly:
JPEG SequenceClick OK
This only needs to be done once per After Effects installation.
MCP Tools
Tool | Description |
| Execute any command (see Commands below) |
| List all available commands |
| Create a new composition |
| Set a single keyframe |
| Set multiple keyframes (batch) |
| Apply expressions to properties |
| Animate effect properties (batch) |
| Import files into project |
| Queue composition for render |
| Export single frame as PNG for visual verification |
Commands
All commands can be called via run-script. Use getHelp to see full documentation.
Project
getProjectInfo,newProject,saveProject,saveProjectAs,closeProjectcreateFolder,moveProjectItem,deleteProjectItemimportFootage,importPlaceholder,replaceFootage
Composition
listCompositions,getActiveComposition,createCompositionsetCompSettings- Modify duration, work area, frame rate, motion blur
Layers
createTextLayer,createShapeLayer,createSolidLayer,addLayerToCompgetLayerInfo,setLayerProperties- Name, transform, timingsetLayerFlags- Visibility, solo, shy, locked, motion blur, 3DdeleteLayer,duplicateLayer,reorderLayer,precomposeLayersetParentLayer,setTrackMattesetTextProperties- Font, size, color, justification
Animation
setLayerKeyframe,setLayerKeyframes(batch)setLayerExpressiongetKeyframes,deleteKeyframe,deleteKeyframes(batch)setKeyframeEasing,setKeyframesEasing(batch)copyKeyframes
Effects
applyEffect,applyEffectTemplatelistEffects,listAvailableEffects,getEffectPropertiessetEffectKeyframe,setEffectKeyframes(batch)
Time & Markers
setLayerTime- In/out point, start time, stretchenableTimeRemapping,setTimeRemapaddMarker,getMarkers,removeMarker
Camera & 3D
createCamera,createLightsetCameraProperties,setLightPropertiesset3DLayer,setMaterialOptions
Masks & Shapes
addMask,setMaskPath,setMaskProperties,deleteMaskaddShapePath,setShapePathVertices,addShapeModifier
Render
addToRenderQueue,renderQueue,queueInAMEgetRenderQueueStatus,clearRenderQueueexportCompFrame- Visual verification
Utility
getSelection,setSelectionbeginUndoGroup,endUndoGroup,getUndoGroupStatusgetPropertyInfo,listFonts
MCP Resources
Resource | Description |
| List all compositions |
| Visual verification workflow guide |
Development
just setup # Build and install CEP panel with debug mode
just build # Build only
just start # Start MCP server (for testing)
just clean # Remove build directoryArchitecture
Claude Code <--stdio--> MCP Server <--WebSocket:8765--> CEP Panel <--CSInterface--> ExtendScriptSee ARCHITECTURE.md for design principles.
Project Structure
after-effects-mcp/
├── src/
│ ├── index.ts # MCP server, tool definitions
│ ├── websocket-server.ts # WebSocket server
│ ├── logger.ts # Logging utility
│ ├── shared/
│ │ ├── commands.ts # Command registry (single source of truth)
│ │ └── config.ts # Configuration and timeouts
│ └── cep/ # CEP extension
│ ├── CSXS/manifest.xml
│ ├── index.html
│ ├── js/main.js # WebSocket client
│ └── jsx/modules/ # ExtendScript (modular)
│ ├── 00-polyfills.jsx
│ ├── 01-helpers.jsx
│ ├── 10-project.jsx
│ ├── 11-layer.jsx
│ ├── 12-keyframe.jsx
│ ├── 13-time.jsx
│ ├── 14-render.jsx
│ ├── 15-camera.jsx
│ ├── 16-mask.jsx
│ ├── 17-shape.jsx
│ ├── 18-selection.jsx
│ ├── 19-discovery.jsx
│ └── 99-dispatcher.jsx
├── scripts/
│ ├── install-cep.js
│ ├── build-jsx.ts # Concatenates JSX modules
│ └── generate-cep-config.ts
├── tests/
├── justfile
└── package.jsonLicense
MIT
Available Tools
10 toolsaddToRenderQueueB
Add a composition to the render queue
Inputs: compName, compIndex, outputPath, outputTemplate, +1 more.
createCompositionB
Create a new After Effects composition
Inputs: name (required), width, height, duration, +1 more.
exportCompFrameA
Export a single frame from a composition as PNG for visual verification. Use this after creating or modifying compositions to verify the result looks correct. Then use the Read tool on the returned path to view the image.
Inputs: time, quality, compName, compIndex, +1 more.
getHelpB
Get help on using the After Effects MCP integration
Inputs: no named parameters.
importFootageC
Import footage into the After Effects project
Inputs: filePath (required), compName, sequence, addToComp.
run-scriptB
Run a script command in After Effects. Use getHelp to see all available commands.
Inputs: script (required), parameters.
setEffectKeyframesA
Set multiple keyframes on effect properties in a single call. More efficient for animating effects.
Inputs: keyframes (required), compName, compIndex, layerName, +3 more.
setLayerExpressionB
Set an expression on a layer property
Inputs: compIndex (required), layerIndex (required), propertyName (required), expressionString (required).
setLayerKeyframeA
Set a keyframe on a layer property. For multiple keyframes, use setLayerKeyframes instead.
Inputs: compIndex (required), layerIndex (required), propertyName (required), timeInSeconds (required), +1 more.
setLayerKeyframesA
Set multiple keyframes in a single call. More efficient than repeated setLayerKeyframe calls.
Inputs: keyframes (required), compName, compIndex, layerName, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a distinct purpose: keyframe tools are differentiated by single/multiple and layer/effect scope, and the rest target different operations (composition, import, render, export, help, script execution). No two tools are easily confused.
Most tools follow a camelCase verbNoun pattern (createComposition, setLayerKeyframes, importFootage). The only exception is run-script, which uses lowercase with a hyphen, creating a minor inconsistency.
With 10 tools, the set is well-scoped for After Effects automation—covering composition creation, footage import, animation, rendering, and frame export. Each tool earns its place without redundancy.
The toolset covers core workflows but misses common operations like adding layers, setting static layer properties, or managing project files. The run-script tool can mitigate these gaps, but it is a workaround rather than a dedicated interface.
Maintenance
Related MCP Connectors
Video production studio for AI agents: AI media, motion graphics as code, timeline and export.
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
Build and run visual creative-production workflows from your AI agent.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe After Effects for composition, layer, effect, preset, marker, and audio automation through a bridge panel.30182 npm24MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to control Adobe After Effects through the MCP protocol, including composition creation, layer management, and animation.13182 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to control Adobe After Effects for project inspection, composition creation, and layer manipulation via a hardened bridge panel.-
- AlicenseCqualityDmaintenanceEnables AI assistants and applications to control Adobe After Effects through the Model Context Protocol for composition, layer management, and animation.13182 npmMIT