Skip to content
Back to search

after-effects-mcp

MCP Server for Adobe After Effects. Enables remote control (compositions, text, shapes, solids, properties) via the Model Context Protocol using ExtendScript.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dakkshin--after-effects-mcp/badge.svg)](/listings/dakkshin--after-effects-mcp)

HTML

<a href="/listings/dakkshin--after-effects-mcp"><img src="/api/listings/dakkshin--after-effects-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

πŸ›  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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 247 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎬 After Effects MCP Server
  2. ![Node.js](https://img.shields.io/badge/node-%3E=14.x-brightgreen.svg)
  3. ![Build](https://img.shields.io/badge/build-passing-success)
  4. ![License](https://img.shields.io/github/license/Dakkshin/after-effects-mcp)
  5. ![Platform](https://img.shields.io/badge/platform-after%20effects-blue)
  6. ✨ 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.
  7. <a href="https://glama.ai/mcp/servers/@Dakkshin/after-effects-mcp">
  8. <img width="380" height="200" src="https://glama.ai/mcp/servers/@Dakkshin/after-effects-mcp/badge" alt="mcp-after-effects MCP server" />
  9. </a>
  10. ## Table of Contents
  11. - [Features](#features)
  12. - [Core Composition Features](#core-composition-features)
  13. - [Layer Management](#layer-management)
  14. - [Animation Capabilities](#animation-capabilities)
  15. - [Setup Instructions](#setup-instructions)
  16. - [Prerequisites](#prerequisites)
  17. - [Installation](#installation)
  18. - [Update MCP Config](#Update-MCP-Config)
  19. - [Running the Server](#running-the-server)
  20. - [Usage Guide](#usage-guide)
  21. - [Creating Compositions](#creating-compositions)
  22. - [Working with Layers](#working-with-layers)
  23. - [Animation](#animation)
  24. - [Available MCP Tools](#available-mcp-tools)
  25. - [For Developers](#for-developers)
  26. - [Project Structure](#project-structure)
  27. - [Building the Project](#building-the-project)
  28. - [Contributing](#contributing)
  29. - [License](#license)
  30. ## πŸ“¦ Features
  31. ### πŸŽ₯ Core Composition Features
  32. - **Create compositions** with custom settings (size, frame rate, duration, background color)
  33. - **List all compositions** in a project
  34. - **Get project information** such as frame rate, dimensions, and duration
  35. ### 🧱 Layer Management
  36. - **Create text layers** with customizable properties (font, size, color, position)
  37. - **Create shape layers** (rectangle, ellipse, polygon, star) with colors and strokes
  38. - **Create solid/adjustment layers** for backgrounds and effects
  39. - **Create camera layers** with configurable zoom and position
  40. - **Create null objects** for animation control
  41. - **Modify layer properties** like position, scale, rotation, opacity, timing
  42. - **Toggle 2D/3D mode** for layers
  43. - **Set blend modes** (normal, multiply, screen, etc.)
  44. - **Track matte** support (alpha, luma, inverted)
  45. - **Duplicate layers** with optional rename
  46. - **Delete layers** from composition
  47. - **Create/modify masks** with feather, expansion, and opacity
  48. ### πŸŒ€ Animation Capabilities
  49. - **Set keyframes** for layer properties (Position, Scale, Rotation, Opacity, etc.)
  50. - **Apply expressions** to layer properties for dynamic animations
  51. - **Batch set properties** across multiple layers at once
  52. ## βš™οΈ Setup Instructions
  53. ### πŸ›  Prerequisites
  54. - Adobe After Effects (2022 or later)
  55. - Node.js (v14 or later)
  56. - npm or yarn package manager
  57. ### πŸ“₯ Installation
  58. 1. **Clone the repository**
  59. ```bash
  60. git clone https://github.com/Dakkshin/after-effects-mcp.git
  61. cd after-effects-mcp
  62. ```
  63. 2. **Install dependencies**
  64. ```bash
  65. npm install
  66. # or
  67. yarn install
  68. ```
  69. 3. **Build the project**
  70. ```bash
  71. npm run build
  72. # or
  73. yarn build
  74. ```
  75. 4. **Install the After Effects panel**
  76. ```bash
  77. npm run install-bridge
  78. # or
  79. yarn install-bridge
  80. ```
  81. This will copy the necessary scripts to your After Effects installation.
  82. ### πŸ”§ Update MCP Config
  83. #### Option 1: Using .mcp.json (Recommended for Claude Code)
  84. The repository includes a `.mcp.json` file for easy configuration. Copy or reference it in your MCP settings:
  85. ```json
  86. {
  87. "mcpServers": {
  88. "AfterEffectsMCP": {
  89. "command": "node",
  90. "args": ["PATH/TO/after-effects-mcp/build/index.js"]
  91. }
  92. }
  93. }
  94. ```
  95. #### Option 2: Manual Configuration
  96. Go to your client (e.g., Claude or Cursor) and update your config file:
  97. ```json
  98. {
  99. "mcpServers": {
  100. "AfterEffectsMCP": {
  101. "command": "node",
  102. "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
  103. }
  104. }
  105. }
  106. ```
  107. ### ▢️ Running the Server
  108. 1. **Start the MCP server**
  109. ```bash
  110. npm start
  111. # or
  112. yarn start
  113. ```
  114. 2. **Open After Effects**
  115. 3. **Open the MCP Bridge Auto panel**
  116. - In After Effects, go to Window > mcp-bridge-auto.jsx
  117. - The panel will automatically check for commands every few seconds
  118. - Make sure the "Auto-run commands" checkbox is enabled
  119. ## πŸš€ Usage Guide
  120. 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.
  121. ### πŸ“˜ Creating Compositions
  122. You can create new compositions with custom settings:
  123. - Name
  124. - Width and height (in pixels)
  125. - Frame rate
  126. - Duration
  127. - Background color
  128. Example MCP tool usage (for developers):
  129. ```javascript
  130. mcp_aftereffects_create_composition({
  131. name: "My Composition",
  132. width: 1920,
  133. height: 1080,
  134. frameRate: 30,
  135. duration: 10
  136. });
  137. ```
  138. ### ✍️ Working with Layers
  139. You can create and modify different types of layers:
  140. **Text layers:**
  141. - Set text content, font, size, and color
  142. - Position text anywhere in the composition
  143. - Adjust timing and opacity
  144. **Shape layers:**
  145. - Create rectangles, ellipses, polygons, and stars
  146. - Set fill and stroke colors
  147. - Customize size and position
  148. **Solid layers:**
  149. - Create background colors
  150. - Make adjustment layers for effects
  151. ### πŸ•Ή Animation
  152. You can animate layers with:
  153. **Keyframes:**
  154. - Set property values at specific times
  155. - Create motion, scaling, rotation, and opacity changes
  156. - Control the timing of animations
  157. **Expressions:**
  158. - Apply JavaScript expressions to properties
  159. - Create dynamic, procedural animations
  160. - Connect property values to each other
  161. ## πŸ›  Available MCP Tools
  162. | Command | Description |
  163. |-----------------------------|----------------------------------------|
  164. | `create-composition` | Create a new composition |
  165. | `run-script` | Run a JS script inside AE |
  166. | `get-results` | Get script results |
  167. | `get-help` | Help for available commands |
  168. | `setLayerKeyframe` | Add keyframe to layer property |
  169. | `setLayerExpression` | Add/remove expressions from properties|
  170. | `setLayerProperties` | Set layer properties (position, scale, rotation, opacity, blendMode, threeDLayer, trackMatteType, enabled, etc.) |
  171. | `batchSetLayerProperties` | Apply properties to multiple layers |
  172. | `getLayerInfo` | Get layer info (position, 3D status) |
  173. | `createCamera` | Create camera layer |
  174. | `createNullObject` | Create null object for animation |
  175. | `duplicateLayer` | Duplicate a layer |
  176. | `deleteLayer` | Delete a layer |
  177. | `setLayerMask` | Create/modify layer masks |
  178. ## πŸ‘¨β€πŸ’» For Developers
  179. ### 🧩 Project Structure
  180. - `src/index.ts`: MCP server implementation
  181. - `src/scripts/mcp-bridge-auto.jsx`: Main After Effects panel script
  182. - `install-bridge.js`: Script to install the panel in After Effects
  183. ### πŸ“¦ Building the Project
  184. ```bash
  185. npm run build
  186. # or
  187. yarn build
  188. ```
  189. **Note:** This project uses esbuild for fast builds, replacing the previous TypeScript compiler approach that could run out of memory on larger codebases.
  190. ### 🀝 Contributing
  191. Contributions are welcome! Please feel free to submit a Pull Request.
  192. ## Star History
  193. [![Star History Chart](https://api.star-history.com/svg?repos=Dakkshin/after-effects-mcp&type=date&legend=top-left)](https://www.star-history.com/#Dakkshin/after-effects-mcp&type=date&legend=top-left)
  194. ## License
  195. This project is licensed under the MIT License - see the LICENSE file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.