AfterEffects MCP Server

🎬 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.

<a href="https://glama.ai/mcp/servers/@Dakkshin/after-effects-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@Dakkshin/after-effects-mcp/badge" alt="mcp-after-effects MCP server" /> </a>

Table of Contents

• Features
  • Core Composition Features
  • Layer Management
  • Animation Capabilities
• Setup Instructions
  • Prerequisites
  • Installation
  • Update MCP Config
  • Running the Server
• Usage Guide
  • Creating Compositions
  • Working with Layers
  • Animation
• Available MCP Tools
• For Developers
  • Project Structure
  • Building the Project
  • Contributing
• License

📦 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

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

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 La