{
  "markdown": "![MCP for After Effects](https://raw.githubusercontent.com/kumoproductions/mcp-aftereffects/main/assets/ogp.png)\n\n# mcp-aftereffects\n\n[![CI](https://github.com/kumoproductions/mcp-aftereffects/actions/workflows/ci.yml/badge.svg)](https://github.com/kumoproductions/mcp-aftereffects/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![Node](https://img.shields.io/badge/node-%3E%3D24-informational)](package.json)\n[![After Effects](https://img.shields.io/badge/After%20Effects-2024%E2%80%932026-informational)](https://www.adobe.com/products/aftereffects.html)\n[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS-informational)](#requirements)\n\nEnglish | [日本語](./README.ja.md)\n\nAn MCP server that enables AI to control Adobe After Effects.\n\nYou can connect MCP-compatible clients such as Claude Code or Claude Desktop to a running instance of After Effects, allowing the AI to handle everything from project inspection and editing to rendering.\n\nThere is no need to provide detailed instructions on how to operate After Effects. Simply explain what you want to achieve in natural language, and the AI will check the project status and perform the necessary operations.\n\n**Windows / macOS · After Effects 2024–2026 · Node.js 24+**\n\n> [!CAUTION]\n> **This tool directly manipulates After Effects projects via AI.**\n>\n> The AI can read project contents and modify compositions, layers, effects, keyframes, and more.\n>\n> Additionally, information the AI reads from the project may be sent to the AI service you are using. This may include composition names, layer names, expressions, keyframes, footage file paths, etc.\n>\n> If using this for projects under NDA or unreleased works, please check the data retention policy of the AI service you are using and the logs of your MCP client beforehand.\n>\n> For first-time use, we recommend trying it with a backup or a test .aep file rather than a critical project.\n\n## Capabilities\n\nWith mcp-aftereffects, you can request the AI to perform After Effects tasks.\n\n- Inspect project contents\n- Investigate compositions and layers\n- Edit layers and properties\n- Add or modify keyframes\n- Edit effects and masks\n- Edit text and shapes\n- Set expressions\n- Save projects\n- Create and restore project backups\n- Render frames to preview changes\n\nFor example, you can give instructions like these:\n\n> \"Import this Illustrator file and create some nice-looking text motion.\"\n\n> \"Apply the revisions mentioned in this PDF.\"\n\n> \"Point out any issues in this AEP.\"\n\nEven for complex tasks, the AI can combine necessary operations while checking the project status.\n\n## Requirements\n\n- Windows or macOS\n- Adobe After Effects 2024 / 2025 / 2026\n- Node.js 24 or higher\n- MCP-compatible client (Claude Code, Claude Desktop, etc.)\n\nNo plugins or panels need to be installed within After Effects.\n\n### After Effects Settings\n\nIn After Effects Preferences, please turn ON the following:\n\n**Preferences → Scripting & Expressions → \"Allow Scripts to Write Files and Access Network\"**\n\nIf this setting is OFF, the AI will not be able to perform operations correctly.\n\n### For macOS\n\nUpon first use, macOS may request permission for the client to control After Effects.\n\nIf it is not permitted, go to:\n\n**System Settings → Privacy & Security → Automation**\n\nand allow your MCP client or terminal to control After Effects.\n\n## Quick Start\n\nNo installation is required on the After Effects side.\n\nFirst, launch After Effects and open the project you wish to operate on.\n\nNext, register mcp-aftereffects with your MCP client.\n\n### Claude Code\n\n```bash\nclaude mcp add aftereffects -- npx -y @kumoproductions/mcp-aftereffects\n```\n\n### Claude Desktop\n\nAdd the following to your MCP configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"aftereffects\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kumoproductions/mcp-aftereffects\"]\n    }\n  }\n}\n```\n\nIf you are using other MCP clients, please follow their respective registration methods for MCP servers.\n\n### Read-Only Mode\n\nIf you want to inspect or audit project content without making any changes, you can use read-only mode.\n\nAdd the following to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"aftereffects\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kumoproductions/mcp-aftereffects\"],\n      \"env\": {\n        \"AE_MCP_READONLY\": \"1\"\n      }\n    }\n  }\n}\n```\n\nYou can still investigate the project and render frames for preview.\n\n## Advanced Settings\n\nUsually, no configuration is necessary.\n\nIn some environments, such as when After Effects is installed in a non-standard location, additional settings may be required.\n\n### Specifying After Effects Location\n\nIf After Effects is not in the standard installation path, you can specify the executable location using `AE_MCP_EXE`.\n\nBy default, it automatically searches for After Effects in the order of 2026 → 2025 → 2024.\n\n### Limiting Operation Scope\n\nUsing `AE_MCP_ALLOW_CATEGORIES`, you can restrict the types of operations permitted for the AI.\n\nFor example, you can limit permissions to only keyframe-related operations depending on your use case.\n\n## Execution of Arbitrary ExtendScript\n\nmcp-aftereffects includes an advanced feature to execute arbitrary ExtendScript for processes that cannot be handled by standard operations.\n\nThis feature is **disabled by default**.\n\n> [!CAUTION]\n> **Enabling arbitrary ExtendScript allows operations outside of After Effects.**\n>\n> **This may permit actions that affect your entire computer**, such as file or process manipulation.\n>\n> This feature is disabled by default. Enable it only if necessary.\n\nTo enable it, set the following in your MCP server environment variables:\n\n```json\n\"env\": {\n  \"AE_MCP_ENABLE_EVAL\": \"1\"\n}\n```\n\nUse this feature only for advanced processing that cannot be achieved through regular operations or when custom ExtendScript is required.\n\n## Official Releases\n\n> [!NOTE]\n> **Official releases are distributed only through npm and GitHub Releases.**\n>\n> Please exercise caution if obtaining packages claiming to be `@kumoproductions/mcp-aftereffects` or files claiming to be this server from any other location.\n\n## Troubleshooting\n\n### Operations Timeout\n\nPlease check the following:\n\n- Is After Effects running?\n- Is a project open?\n- Is \"Allow Scripts to Write Files and Access Network\" turned ON?\n- On macOS, is the Automation permission enabled?\n\n### After Effects Not Found\n\nIf you have installed After Effects in a non-standard location, please set `AE_MCP_EXE`.\n\nIf the issue persists, please report it via an Issue or to @cumuloworks.\n\n## Developer Information\n\nFor information regarding internal MCP tools, communication methods with After Effects, ExtendScript, test environments, and how to add custom operations, please refer to the developer documentation.\n\n- `docs/TOOLS.md`\n- `CONTRIBUTING.md`\n\n## Contributing\n\nBug reports, feature requests, and Pull Requests are welcome.\n\nFor information on setting up the development environment and the internal architecture, please refer to `CONTRIBUTING.md`.\n\n## License\n\nMIT © 2026 kumo.productions, Inc.\n\n## Trademark\n\nAdobe® and Adobe After Effects® are trademarks of Adobe Inc.\n\nThis project is an independent, unofficial tool and is **not affiliated with or endorsed by Adobe**.\n",
  "bytes": 7332,
  "sha": "5db9ec283a50b59abd23db169b1ffc85e46bdc89c0fcbcccad8006d0f577b8ee",
  "repo_slug": "kumoproductions/mcp-aftereffects",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kumoproductions_mcp_aftereffec_7504ade0/readme"
}