Skip to content

Releases

v2.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Oct 17:55

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

  1. Open After Effects or Illustrator. Each app starts its own MCP server.
  2. 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

Choose a tag to compare

@github-actions github-actions released this 24 Sep 19:57
49ef0f6

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

  1. Open After Effects. The MCP server starts on its own.
  2. 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

Choose a tag to compare

@github-actions github-actions released this 24 Sep 18:45
63b069e

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

  1. Open After Effects. The MCP server starts on its own.
  2. 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

Choose a tag to compare

@github-actions github-actions released this 24 Sep 15:11
eb62c4b

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

  1. Open After Effects. The MCP server starts on its own.
  2. 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

Choose a tag to compare

@github-actions github-actions released this 23 Sep 21:04
1370942

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

  1. Open After Effects. The MCP server starts on its own.
  2. 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

Choose a tag to compare

@github-actions github-actions released this 22 Sep 15:06
be71678

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 .zxp instead — ZXPInstaller is
    itself a notarized app, so the .zxp is 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

  1. Open After Effects. The MCP server starts on its own.
  2. Open Window > Extensions > AE MCP Vision.
  3. 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

Choose a tag to compare

@github-actions github-actions released this 19 Sep 18:45
b41673d

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 .zxp instead — ZXPInstaller is
    itself a notarized app, so the .zxp is 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

  1. Open After Effects. The MCP server starts on its own.
  2. Open Window > Extensions > AE MCP Vision.
  3. 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

v2.0.0-rc2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Sep 20:57

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

  1. Open After Effects. The MCP server starts on its own.
  2. Open Window > Extensions > AE MCP Vision.
  3. 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