Skip to main content
Glama

🎬 After Effects MCP Server

Node.js Build License Platform

✨ 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

  1. Clone the repository

    git clone https://github.com/Dakkshin/after-effects-mcp.git
    cd after-effects-mcp
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Build the project

    npm run build
    # or
    yarn build
  4. Install the After Effects panel

    npm run install-bridge
    # or
    yarn install-bridge

    This will copy the necessary scripts to your After Effects installation.

πŸ”§ Update MCP Config

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

  1. Start the MCP server

    npm start
    # or
    yarn start
  2. Open After Effects

  3. 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-composition

Create a new composition

run-script

Run a JS script inside AE

get-results

Get script results

get-help

Help for available commands

setLayerKeyframe

Add keyframe to layer property

setLayerExpression

Add/remove expressions from properties

setLayerProperties

Set layer properties (position, scale, rotation, opacity, blendMode, threeDLayer, trackMatteType, enabled, etc.)

batchSetLayerProperties

Apply properties to multiple layers

getLayerInfo

Get layer info (position, 3D status)

createCamera

Create camera layer

createNullObject

Create null object for animation

duplicateLayer

Duplicate a layer

deleteLayer

Delete a layer

setLayerMask

Create/modify layer masks

πŸ‘¨β€πŸ’» For Developers

🧩 Project Structure

  • src/index.ts: MCP server implementation

  • src/scripts/mcp-bridge-auto.jsx: Main After Effects panel script

  • install-bridge.js: Script to install the panel in After Effects

πŸ“¦ Building the Project

npm run build
# or
yarn build

Note: 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

Star History Chart

License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

16 tools
apply-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

    C2.6/5.0

    Scored across 16 tools

    Disambiguation1/5

    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 Consistency2/5

    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.

    Tool Count4/5

    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.

    Completeness3/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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers