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 Effects | After Effects 2021 (CC 2021) or newer |
| Node.js | v18 or newer |
| MCP client | Claude Desktop, Cursor, Windsurf, or any MCP app |
| OS | Windows 10/11 or macOS 12+ (macOS: beta, panel mode) |
| License | Active 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:Replace
claude_desktop_config.json
{
"mcpServers": {
"after-effects": {
"command": "npx",
"args": ["-y", "@synthetic-ai/ae-mcp"],
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
}
}
}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:If a new comp appears in After Effects, you're all set.
Create a new composition called "Test" — 1920x1080, 30fps, 5 seconds
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.