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

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"]
   

... [View full README on GitHub](https://github.com/Dakkshin/after-effects-mcp#readme)