fnf-after-effects-mcp
v0.1.3
Published
Local MCP server for Adobe After Effects with native operations and offline creative skills.
Readme
Higgsfield After Effects MCP
Local MCP server for inspecting and editing Adobe After Effects projects. It includes native composition, layer, property, keyframe, effect and camera operations, plus offline creative skills. The server runs on the same computer as After Effects; no cloud account or After Effects panel is required.
Requirements
- Node.js 24 or later on macOS or Windows.
- Adobe After Effects installed and licensed on the MCP host.
- On macOS, permission for the MCP client to control After Effects through Automation.
- In After Effects, enable Allow Scripts to Write Files and Access Network if scripting reports file access denied.
Installation
npm install --global fnf-after-effects-mcp
fnf-after-effects doctor
fnf-after-effects install-codexinstall-codex registers the installed server as higgsfield-use-after-effects. Refresh the MCP connection after registration. For another desktop MCP client, run fnf-after-effects config and add the printed entry to that client's configuration. The stdio server executable is fnf-after-effects-mcp. Set AE_MCP_EXE in the server environment for a nonstandard After Effects installation.
doctor checks the installation and bundled skills, but does not connect to After Effects. Open a project and call ae_project_info through the MCP client to verify the live connection.
Tools
ae_project_infoinspects the active project.ae_cataloglists available native operations and their argument schemas;ae_doexecutes an operation.ae_get_skillreads bundled workflows and references;ae_get_skill_assetresolves bundled files on the local MCP host.- Other tools inspect compositions and support the native operation workflow. Use
ae_catalogfor the exact operations available in the installed version.
Troubleshooting and limits
Inspect the project before editing and render representative frames to verify visual results. A timed-out operation may still have run; inspect After Effects before retrying. batch.run groups operations for undo but does not automatically roll back completed steps after an error.
Set AE_MCP_READONLY=1 to restrict project changes or AE_MCP_ALLOW_CATEGORIES to limit operation categories. Arbitrary eval is disabled unless AE_MCP_ENABLE_EVAL=1. Keep the local file mailbox in a private writable directory.
This package is based on the MIT-licensed mcp-aftereffects runtime. The installed package includes LICENSE and UPSTREAM.md with attribution and licensing details for the adaptations and skills.
