PR-MCP-IMT — Premiere Pro for AI agents

PR-MCP-IMT + SKILLS — Premiere Pro for AI agents

Let an AI assistant (Claude Desktop, Cursor, ChatGPT, Google Antigravity or any MCP client) work inside your running Adobe Premiere Pro: read the project and its sequences, cut, trim, move and ripple clips, apply effects, transitions and keyframes, add markers and captions, reframe, check frames and export — from plain language.

Two parts, made to work together:

• The MCP server — about 380 Premiere operations behind nine tools; writes are verified by reading Premiere back; works on a non-English Premiere; no telemetry.
• The skill (skills/pr, also served by the pr_skill tool, so it works in any client) — how to drive Premiere safely, where scripting ends, and how to use Premiere's own AI tools: Generative Extend, the Generative Media Tool (video, sound effects, music), Object Mask, Speech to Text and Paper Edit, captions, Enhance Speech and stem separation, Search, the AI Assistant, Auto Reframe, Scene Edit Detection, Morph Cut — plus recipes that combine them and the gotchas.

By Immersive Media Technologies — the Premiere layer of our Deep Artisan agent system, released for other agent builders.

macOS and Windows · Premiere Pro 2024–2026 — verified live on macOS (26.5.1, Russian UI) and on Windows 11 ARM (26.5.2, English UI, Claude Desktop from the Microsoft Store) · Node.js 20.19+ (none needed with the Claude Desktop extension).

[!CAUTION] This edits real Premiere projects, and Premiere has no scripted undo — work on a copy. Project content (names, transcripts, markers, frames) goes to the AI service you use. Premiere's generative tools spend your Adobe credits; the agent asks before starting one. Raw ExtendScript is off unless you turn it on.

What you can ask for

• "List every clip shorter than 12 frames and every gap in the active sequence."
• "Tighten the pauses in this interview to a third of a second and put a Morph Cut on the jump cuts where the camera is locked off." (skill)
• "Make 9:16 and 1:1 versions of this edit and check the titles stay out of the TikTok UI zones."
• "Blur the face of the man on the left for the whole shot." (skill: you click the subject with Object Mask, the agent does the rest)
• "The music in this interview was recorded on location — get rid of it and score it again under the dialogue." (skill)
• "Mark every beat of this track and lay the selects to it, two beats per shot."

The agent combines the operations itself and checks the sequence between steps; the skill tells it which Premiere AI tool fits the job, what it costs and where it breaks.

Install

You need Premiere Pro running on this computer and the connector — a small CEP extension inside Premiere that the server talks to. The agent installs it for you on first use (pr_install_connector, it asks first; then quit and reopen Premiere), or the installer below does.

{
  "mcpServers": {
    "premiere": {
      "command": "npx",
      "args": ["-y", "@immersive-media-technologies/premiere-mcp-imt"]
    }
  }
}

From source, with a live self-test (the route we use):

git clone https://github.com/Immersive-Media-Technologies/premiere-mcp-imt.git
cd premiere-mcp-imt && ./install.sh        # Windows: .\install.ps1

The installer checks Premiere, Node and FFmpeg, builds, installs the connector (asks first), asks the running Premiere whether the connector answers, and — after asking — writes the entry into Claude Desktop's, Cursor's and Antigravity's configs, backing them up.

If something does not connect

• pr_verify says the connector does not answer: quit Premiere completely after the connector was installed and open it again; close any open Premiere dialog (a modal dialog blocks scripting). premiere-mcp-imt --diagnose-cep checks the files, the debug flags and Premiere's signature log.
• The connector is unsigned: CEP must allow unsigned extensions (PlayerDebugMode = 1 for CSXS 9–14; on Windows a String (REG_SZ) value under HKCU\Software\Adobe\CSXS.<n>). The installers set it.
• spawn npx ENOENT on macOS: GUI apps do not see your shell PATH — put the absolute path of a Node from Homebrew or nodejs.org in place of npx (nvm's Node is invisible to them).
• Loudness, silence (detect_silence), beat and scene-change analysis need FFmpeg (brew install ffmpeg, winget install Gyan.FFmpeg).
• Windows, Claude Desktop from the Microsoft Store: the Store app's registry writes are sandboxed. If Premiere does not load the connector after pr_install_connector, run powershell -ExecutionPolicy Bypass -File scripts\install-cep.ps1 once from a normal PowerShell in a source checkout (or use install.ps1).
• premiere-mcp-imt --doctor checks the local install without reading a project.

How it stays safe

Tools

PR_MCP_FACADE=0 lists every operation as its own tool instead (about 150K tokens of definitions; the nine tools cost about 1.5K).

The skill

skills/pr/SKILL.md is a short router the agent reads first (pr_skill with no arguments); it points to the one reference the task needs (pr_skill {doc}):

Clients with their own skill support can load the folder directly (e.g. copy skills/pr into ~/.claude/skills/).

Why this one

Several Premiere MCP servers exist; they differ in what the model sees, what it knows and what it sends home. As of 2026-10-26:

PR-MCP-IMT premiere-pro-mcp
(upstream) AdobePremiereProMCP Adobe_Premiere_Pro_MCP flue

Tools the model sees by default9, over ~380 operationsthe whole catalog (~440 tools)74 (profile standard) of ~1,0605, over 283 operationsnone — the agent pipes ExtendScript Knowledge of Premiere's AI toolsskill with 8 references + recipes2 skills (editing, development)7 workflow skills1 skill1 skill (scripting) Non-English PremierematchName lookup, verified on RussianEnglish and es-ES measurednot statednot statednot stated TelemetrynonePostHog, off unless a key is setnone foundon by default (opt-out)none mentioned Connector installby the agent, with consent; installers with a live self-testCLI flagbuild from source (Go, Rust, Python)CLI flagpip + setup ClientsClaude Desktop (.mcpb), Cursor, Antigravity, ChatGPT gateway, any MCP clientnpm, .mcpb, Codex / Claude Code pluginsbuild from sourcenpm, plugins, .mcpbCLI + skill LicenseIMT Non-CommercialMITMITMITMIT

What we changed in the upstream code, besides the skill and the packaging: component and property lookup by matchName (on a Russian Premiere every opacity, motion, keyframe and volume operation of upstream failed), split_clip that cuts the clip you name (upstream cut track 0), no telemetry, stdio only, and a compact tool surface.

Releases

Each version is described on the **Releases** page; every change is in CHANGELOG.md.

• v0.1.0 · 2026-10-26 — first public release: the Premiere agent skill, nine-tool surface, pr_skill, connector install by the agent, Claude Desktop extension, installers with a live self-test, ChatGPT gateway.

npm test runs offline — no Premiere needed.

License

IMT Non-Commercial License — © Immersive Media Technologies.

• Non-commercial use only. Selling this software, offering it as or inside a paid product or service, or using it in commercial client work requires a separate written license.
• Attribution is mandatory. Every use, copy, fork or derived product must credit the creator, visibly to its users: PR-MCP-IMT by Immersive Media Technologies — https://github.com/Immersive-Media-Technologies.
• No warranty.

Full terms: LICENSE. Third-party notices (upstream MIT code): THIRD-PARTY-NOTICES.md. Adobe, Premiere Pro and Firefly are trademarks of Adobe Inc.; this project is not affiliated with or endorsed by Adobe.