Repository navigation
Releases
v2.2.0
Changes in 2.2.0
- Add Illustrator support alongside After Effects, contributed by Noah Lewis (@nlewis-knowah): separate tools, ports, tokens, host code and documentation.
- Preserve Illustrator path geometry on invalid requests and retain recoverable outputs if export replacement fails.
- List source footage, native timing, interpretation overrides and eligibility through
ae_query media, with an adapter contract for tools such as sam-ui. - Read and set effect popup labels, map mask keys through layer time, reorder masks, and address newly created shape groups.
- Improve footage reads, font resolution, layer audio control and expression diagnostics.
- Validate render settings before removing overwrite targets, clean up render queue items, and correctly write and report numbered image sequences.
Validated with 199 unit tests, 78 live After Effects integration cases and 31 live Illustrator checks, plus targeted geometry, TIFF sequence and overwrite-preservation checks.
Works with sam-ui 0.3.0
sam-ui 0.3.0 is out and uses this release for a rotoscoping round trip: open After Effects footage in place in the sam-ui desktop app, track objects with SAM 2 or SAM 3, and send them back as a new comp with animated masks. It needs AE MCP Vision 2.2.0 or later. How an adapter like it talks to the bridge is in docs/INTEGRATIONS.md.
Which file do I download?
| You are on | Download |
|---|---|
| macOS | AE-MCP-Vision-2.2.0-macOS.dmg |
| Windows | AE-MCP-Vision-2.2.0-Windows.exe |
Requires After Effects 2022 (22.0) or later, or Illustrator 2023 (27.0) or later. Quit both Adobe apps before installing. Illustrator validation used 30.3.0 on macOS; earlier supported versions were not exercised in this release check.
The .zxp is attached for people who already manage extensions by hand. It is
unsigned and needs PlayerDebugMode set manually — see
INSTALL.md.
First run
The installers are not code-signed, so your OS objects the first time:
- macOS 15 and later: try to open the installer once, then go to
System Settings > Privacy & Security, click Open Anyway, confirm, and
enter an administrator password. Right-click > Open no longer works. - macOS 14 and earlier: right-click the installer > Open, then Open.
- Windows: at "Windows protected your PC", click More info, then
Run anyway.
Then
- Open After Effects or Illustrator. Each app starts its own MCP server.
- Open Window > Extensions > AE MCP Vision or Illustrator MCP Vision, pick your client, and copy the config.
Works with Claude Code, Claude Desktop, Codex, the ChatGPT desktop app, and any
MCP client that speaks Streamable HTTP or launches stdio servers —
setup for each.
Verifying a download
shasum -a 256 -c checksums.txt
v2.1.0
Which file do I download?
| You are on | Download |
|---|---|
| macOS | AE-MCP-Vision-2.1.0-macOS.dmg |
| Windows | AE-MCP-Vision-2.1.0-Windows.exe |
Requires After Effects 2022 (22.0) or later. Quit After Effects before
installing.
The .zxp is attached for people who already manage extensions by hand. It is
unsigned and needs PlayerDebugMode set manually — see
INSTALL.md.
First run
The installers are not code-signed, so your OS objects the first time:
- macOS 15 and later: try to open the installer once, then go to
System Settings > Privacy & Security, click Open Anyway, confirm, and
enter an administrator password. Right-click > Open no longer works. - macOS 14 and earlier: right-click the installer > Open, then Open.
- Windows: at "Windows protected your PC", click More info, then
Run anyway.
Then
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision, pick your client, copy the config.
Works with Claude Code, Claude Desktop, Codex, the ChatGPT desktop app, and any
MCP client that speaks Streamable HTTP or launches stdio servers —
setup for each.
Verifying a download
shasum -a 256 -c checksums.txt
v2.0.4
Which file do I download?
| You are on | Download |
|---|---|
| macOS | AE-MCP-Vision-2.0.4-macOS.dmg |
| Windows | AE-MCP-Vision-2.0.4-Windows.exe |
Requires After Effects 2022 (22.0) or later. Quit After Effects before
installing.
The .zxp is attached for people who already manage extensions by hand. It is
unsigned and needs PlayerDebugMode set manually — see
INSTALL.md.
First run
The installers are not code-signed, so your OS objects the first time:
- macOS 15 and later: try to open the installer once, then go to
System Settings > Privacy & Security, click Open Anyway, confirm, and
enter an administrator password. Right-click > Open no longer works. - macOS 14 and earlier: right-click the installer > Open, then Open.
- Windows: at "Windows protected your PC", click More info, then
Run anyway.
Then
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision, pick your client, copy the config.
Works with Claude Code, Claude Desktop, Codex, the ChatGPT desktop app, and any
MCP client that speaks Streamable HTTP or launches stdio servers —
setup for each.
Verifying a download
shasum -a 256 -c checksums.txt
v2.0.3
Which file do I download?
| You are on | Download |
|---|---|
| macOS | AE-MCP-Vision-2.0.3-macOS.dmg |
| Windows | AE-MCP-Vision-2.0.3-Windows.exe |
Requires After Effects 2022 (22.0) or later. Quit After Effects before
installing.
The .zxp is attached for people who already manage extensions by hand. It is
unsigned and needs PlayerDebugMode set manually — see
INSTALL.md.
First run
The installers are not code-signed, so your OS objects the first time:
- macOS 15 and later: try to open the installer once, then go to
System Settings > Privacy & Security, click Open Anyway, confirm, and
enter an administrator password. Right-click > Open no longer works. - macOS 14 and earlier: right-click the installer > Open, then Open.
- Windows: at "Windows protected your PC", click More info, then
Run anyway.
Then
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision, pick your client, copy the config.
Works with Claude Code, Claude Desktop, Codex, the ChatGPT desktop app, and any
MCP client that speaks Streamable HTTP or launches stdio servers —
setup for each.
Verifying a download
shasum -a 256 -c checksums.txt
v2.0.2
Which file do I download?
| You are on | Download |
|---|---|
| macOS | AE-MCP-Vision-2.0.2-macOS.dmg |
| Windows | AE-MCP-Vision-2.0.2-Windows.exe |
Requires After Effects 2022 (22.0) or later. Quit After Effects before
installing.
The .zxp is attached for people who already manage extensions by hand. It is
unsigned and needs PlayerDebugMode set manually — see
INSTALL.md.
First run
The installers are not code-signed, so your OS objects the first time:
- macOS 15 and later: try to open the installer once, then go to
System Settings > Privacy & Security, click Open Anyway, confirm, and
enter an administrator password. Right-click > Open no longer works. - macOS 14 and earlier: right-click the installer > Open, then Open.
- Windows: at "Windows protected your PC", click More info, then
Run anyway.
Then
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision, pick your client, copy the config.
Works with Claude Code, Claude Desktop, Codex, the ChatGPT desktop app, and any
MCP client that speaks Streamable HTTP or launches stdio servers —
setup for each.
Verifying a download
shasum -a 256 -c checksums.txt
v2.0.1
Which file do I download?
| You are on | Download | Then |
|---|---|---|
| macOS (recommended) | ae-mcp-vision-2.0.1.zxp |
Drag onto ZXPInstaller — no security prompts |
| Windows | AE-MCP-Vision-2.0.1-Windows.exe |
Run it, click through SmartScreen |
| macOS, if you prefer a native installer | AE-MCP-Vision-2.0.1-macOS.dmg |
Four Gatekeeper steps and an admin password — see below |
Quit After Effects before installing. It loads extensions at startup, so installing
underneath a running copy leaves a half-loaded state that looks broken.
Everything installs into your own user folder. On macOS 15 and later you will still
be asked for an administrator password to launch the unsigned installer — the .zxp via
ZXPInstaller avoids that and is the smoothest route on a
modern Mac.
Requirements
- After Effects 22.0 or later. Earlier versions cannot work: this addresses layers by
Layer.id, which Adobe added in 22.0, and stable ids are the basis of every tool here. - macOS 10.14+ or Windows 10/11.
First run
The installers are not code-signed, so your operating system will object the first time:
-
macOS 15 (Sequoia) and later — this now costs four steps and an admin password.
Apple removed the old right-click > Open bypass. You must: (1) try to open it once, so
macOS records the block; (2) go to System Settings > Privacy & Security > Security
and click Open Anyway; (3) click Open Anyway again in the confirmation; (4) enter
an administrator username and password.If that is more than you want to deal with, use the
.zxpinstead — ZXPInstaller is
itself a notarized app, so the.zxpis data it reads rather than code Gatekeeper
evaluates, and none of the above applies. -
macOS 14 and earlier: right-click the app > Open, then Open in the dialog.
-
Windows: SmartScreen shows "Windows protected your PC". Click More info then
Run anyway. No admin password is required.
This is expected for unsigned software and is not a warning about this specific download.
If that bothers you, build from source instead — see the README.
After installing
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision.
- Pick your client tab, press Copy config, paste it in.
Supported out of the box: Claude Code, Claude Desktop, Codex CLI / Desktop.
Your access token is stored in ~/.ae-mcp-vision/token and persists across restarts, so
a config you paste once keeps working.
Verifying a download
Checksums are attached to this release. On macOS or Linux:
shasum -a 256 -c checksums.txt
v2.0.0
Which file do I download?
| You are on | Download | Then |
|---|---|---|
| macOS (recommended) | ae-mcp-vision-2.0.0.zxp |
Drag onto ZXPInstaller — no security prompts |
| Windows | AE-MCP-Vision-2.0.0-Windows.exe |
Run it, click through SmartScreen |
| macOS, if you prefer a native installer | AE-MCP-Vision-2.0.0-macOS.dmg |
Four Gatekeeper steps and an admin password — see below |
Quit After Effects before installing. It loads extensions at startup, so installing
underneath a running copy leaves a half-loaded state that looks broken.
Everything installs into your own user folder. On macOS 15 and later you will still
be asked for an administrator password to launch the unsigned installer — the .zxp via
ZXPInstaller avoids that and is the smoothest route on a
modern Mac.
Requirements
- After Effects 22.0 or later. Earlier versions cannot work: this addresses layers by
Layer.id, which Adobe added in 22.0, and stable ids are the basis of every tool here. - macOS 10.14+ or Windows 10/11.
First run
The installers are not code-signed, so your operating system will object the first time:
-
macOS 15 (Sequoia) and later — this now costs four steps and an admin password.
Apple removed the old right-click > Open bypass. You must: (1) try to open it once, so
macOS records the block; (2) go to System Settings > Privacy & Security > Security
and click Open Anyway; (3) click Open Anyway again in the confirmation; (4) enter
an administrator username and password.If that is more than you want to deal with, use the
.zxpinstead — ZXPInstaller is
itself a notarized app, so the.zxpis data it reads rather than code Gatekeeper
evaluates, and none of the above applies. -
macOS 14 and earlier: right-click the app > Open, then Open in the dialog.
-
Windows: SmartScreen shows "Windows protected your PC". Click More info then
Run anyway. No admin password is required.
This is expected for unsigned software and is not a warning about this specific download.
If that bothers you, build from source instead — see the README.
After installing
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision.
- Pick your client tab, press Copy config, paste it in.
Supported out of the box: Claude Code, Claude Desktop, Codex CLI / Desktop.
Your access token is stored in ~/.ae-mcp-vision/token and persists across restarts, so
a config you paste once keeps working.
Verifying a download
Checksums are attached to this release. On macOS or Linux:
shasum -a 256 -c checksums.txt
v2.0.0-rc2
Which file do I download?
| You are on | Download | Then |
|---|---|---|
| macOS | AE-MCP-Vision-2.0.0-rc2-macOS.dmg |
Open it, double-click Install AE MCP Vision |
| Windows | AE-MCP-Vision-2.0.0-rc2-Windows.exe |
Run it |
| Already use ZXPInstaller | ae-mcp-vision-2.0.0-rc2.zxp |
Drag onto ZXPInstaller |
Quit After Effects before installing. It loads extensions at startup, so installing
underneath a running copy leaves a half-loaded state that looks broken.
No admin rights required. Everything installs into your own user folder.
Requirements
- After Effects 22.0 or later. Earlier versions cannot work: this addresses layers by
Layer.id, which Adobe added in 22.0, and stable ids are the basis of every tool here. - macOS 10.14+ or Windows 10/11.
First run
The installers are not code-signed, so your operating system will object the first time:
- macOS: right-click the installer app and choose Open, then Open again. After
that it runs normally. (Double-clicking shows a dead-end "cannot be verified" dialog.) - Windows: SmartScreen shows "Windows protected your PC" — click More info, then
Run anyway.
This is expected for unsigned software and is not a warning about this specific download.
If that bothers you, build from source instead — see the README.
After installing
- Open After Effects. The MCP server starts on its own.
- Open Window > Extensions > AE MCP Vision.
- Pick your client tab, press Copy config, paste it in.
Supported out of the box: Claude Code, Claude Desktop, Codex CLI / Desktop.
Your access token is stored in ~/.ae-mcp-vision/token and persists across restarts, so
a config you paste once keeps working.
Verifying a download
Checksums are attached to this release. On macOS or Linux:
shasum -a 256 -c checksums.txt