SyntheticSynthetic/Docs
ProductsChangelog
Dashboard →

Getting started

Installation

Get the After Effects MCP running on your machine in under 5 minutes.

The fastest way: use the Synthetic Installer. It installs the tools, connects your AI apps and keeps everything up to date. See the installer guide

Requirements

After EffectsAfter Effects 2021 (CC 2021) or newer
Node.jsv18 or newer
MCP clientClaude Desktop, Cursor, Windsurf, or any MCP app
OSWindows 10/11 or macOS 12+ (macOS: beta, panel mode)
LicenseActive Synthetic subscription
Don't have a license yet? Get one at synthetic.com.ar/pricing — monthly and annual plans available.

Step-by-step setup

1

No installation needed — add it to your config

No global install required. Just add the MCP directly to your Claude Desktop config (see Step 3). npx handles everything automatically on first run.
2

Find your license key

Sign in at synthetic.com.ar/auth/login and go to Dashboard → Licenses. Your key is a UUID that looks like:
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
3

Add the MCP to your client config

Open your Claude Desktop (or Cursor) MCP configuration file and add:
claude_desktop_config.json
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "@synthetic-ai/ae-mcp"],
      "env": {
        "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
      }
    }
  }
}
Replace XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX with your actual license key.
4

Restart your MCP client

Close and reopen Claude Desktop (or your MCP client). The After Effects MCP should appear as connected in the tools panel.
5

Open After Effects and test

Open After Effects, then go to Claude and type:
Create a new composition called "Test" — 1920x1080, 30fps, 5 seconds
If a new comp appears in After Effects, you're all set.

Config file locations

Claude Desktop

Windows
%APPDATA%\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json

Cursor

Windows / macOS
.cursor/mcp.json  (in your project root)
In Panel mode, After Effects must be open and running before Claude tries to use any tool. In Standalone mode the MCP launches After Effects (or aerender) on each call.