Premiere-MCP-IMT
Summary: An AI agent can inspect, edit, and export from a running Adobe Premiere Pro project through ~440 operations across nine tools, and can look at exported frames to verify its work.
Connect & verify: check the MCP↔Premiere connector, open project, and active sequence; install the connector on request.
Inspect: read the active sequence's tracks and clips with
node_id, timing, enabled state, and speed.Run operations: discover ~440 operations (45 categories) via
pr_catalog, execute one withpr_do, or chain several withpr_batch.Edit the timeline: cut, trim, move, ripple, split, target tracks, set the playhead and selection, add markers and captions.
Effects & keyframes: apply effects, transitions, and keyframes; lookup works in every Premiere UI language via matchName and UI dictionaries.
Audio & text: speech-to-text, transcripts, paper edit, pause/filler/caption planners, Enhance Speech, stem separation, ducking, silence/beat/loudness analysis (FFmpeg).
See results: export any frame of the sequence as a PNG (
pr_export_frame) to visually check edits, plus full exports and delivery.Vision-only tasks (macOS): draw Object Masks by sight (click a person, lasso a face, add/subtract, track) and place speed keyframes by dragging them on the timeline.
AI/generative workflows: guidance and recipes for Generative Extend, Generative Media Tool, Auto Reframe, Scene Edit Detection, Morph Cut, Search, and the AI Assistant via
pr_skill.Safety: writes verified by readback, undo where available, sequence checkpoints and snapshot diffs, plan→preview→apply, read-only mode, no telemetry; raw ExtendScript only when explicitly enabled.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Premiere-MCP-IMT find every clip shorter than 12 frames and every gap in the active sequence"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

Premiere-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.
Every Adobe UI language · vision: masks and keyframes by sight · a large skills library · built for generative features. Premiere-MCP-IMT works with every UI language Adobe ships, and the agent sees the frame: it looks at exported frames, draws Object Masks on the people or parts it sees — a click for a whole person, a lasso for a face; add, subtract, track (macOS) — sets speed keyframes (Time Remapping) by dragging them into place on the timeline, and checks keyframed motion frame by frame. Premiere's scripting has no API for masks or speed keyframes; none of the other Premiere MCP servers we compared creates Object Masks, and Adobe's own AI Assistant in Premiere (beta) documents neither. It comes with a large skills library and is built for Adobe's generative features — Generative Extend, Generative Media, Object Mask, Enhance Speech, transcripts and captions, Auto Reframe, Search, the AI Assistant.
Two parts, made to work together:
The MCP server — about 440 Premiere operations behind nine tools; writes are verified by reading Premiere back; works on every Premiere UI language (verified live); Object Masks by sight on macOS (the
masksoperations drive Premiere's own mask tool — there is no API for it); no telemetry.The skill (
skills/pr, also served by thepr_skilltool, 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.
Built for localized Premiere, not just English. Most Premiere MCP servers and agent skills assume the English UI — on a German, Chinese or Russian install their effect, transition and parameter names stop matching. Premiere-MCP-IMT finds components by matchName and translates English effect, transition and parameter names through Premiere's own UI dictionaries, so the same agent and the same skill work on all ten UI languages Premiere ships — verified live.
By Immersive Media Technologies.
macOS and Windows · Premiere Pro 2024–2026 — verified live on macOS (26.5) and on Windows 11 ARM (26.5.2, Claude Desktop from the Microsoft Store) · Node.js 20.19+ (none needed with the Claude Desktop extension).
This edits real Premiere projects, and scripted undo covers only some edits — 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." (macOS: the agent outlines the face with Object Mask itself, tracks it and checks it on other frames; on Windows you click the subject)
"Mask everyone in this shot, faces first, and keep the mask on them to the end of the clip."
"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.
Related MCP server: cut.skill
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.
Client | How |
| download |
| Add to Cursor — one click: Cursor opens and writes the config (or put the snippet below into |
| Settings → Customizations → Installed MCP Servers → View raw config → add the snippet below. |
| on the Premiere machine: |
Any MCP client | the snippet below in its |
{
"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.ps1The 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_verifysays 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-cepchecks the files, the debug flags and Premiere's signature log.The connector is unsigned: CEP must allow unsigned extensions (
PlayerDebugMode=1for CSXS 9–14; on Windows a String (REG_SZ) value underHKCU\Software\Adobe\CSXS.<n>). The installers set it.spawn npx ENOENTon macOS: GUI apps do not see your shellPATH— put the absolute path of a Node from Homebrew or nodejs.org in place ofnpx(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, runpowershell -ExecutionPolicy Bypass -File scripts\install-cep.ps1once from a normal PowerShell in a source checkout (or useinstall.ps1).premiere-mcp-imt --doctorchecks the local install without reading a project.
How it stays safe
Verified writes | edits read Premiere back and report |
Undo where Premiere records it, checkpoints elsewhere | Edits that Premiere records in its history (effects added or removed, cuts, inserts) report |
Plan → preview → apply |
|
Read-only mode |
|
No raw scripting by default |
|
No telemetry | the server sends nothing anywhere. |
Real clicks only where there is no API | the |
How the agent sees
Adobe gives outside agents no picture: its scripting returns a project's structure, not its pixels, and panels have no live access to the Program Monitor (requested since November 2025). Its own connector for AI assistants «operates at Adobe Express level, not Photoshop or Premiere» (MindStudio), and editors who drive Premiere through AI report «no effects or anything more advanced» (Adobe forum).
Premiere-MCP-IMT gives the agent two kinds of sight. The model's: pr_export_frame returns any frame of the
sequence as an image, and the model decides from the picture what to mask, where a speed change
belongs, whether a keyframed move lands. The server's: Premiere's scripting has no API for
masks or speed keyframes — they exist only in its UI. So the server looks at Premiere itself: it
captures the window, finds the Program Monitor, the Effect Controls rows and the timeline by their
shapes (icons and layout, not labels, so it works on every UI language), acts with real mouse
events, and captures again to confirm every step.
Object Masks by sight (macOS): one click of the Object Mask tool on the Program Monitor takes a whole person; a closed lasso takes only the part it outlines (a face, a sign). ⊕ / ⊖ add to or subtract from the mask — the server selects the mask by its row first, because Premiere drops the selection after tracking or a playhead move. Then tracking, Feather, Expansion and the other mask settings; after each edit the server measures the mask's red overlay against the plain exported frame, and the model checks the result frame by frame.
Speed keyframes by sight (Time Remapping, macOS): the server adds a speed keyframe at the playhead in Effect Controls, zooms the timeline until the clip is wide enough to place a frame, finds the keyframe's handle on the clip and Shift-drags it until the measured position matches the target frame — then the model checks the motion on exported frames.
Tools
Tool | Purpose |
| connector, open project and active sequence — the first call |
| tracks and clips with their |
| discover the ~440 operations (45 categories) and run one or several |
| a frame of the sequence as PNG — the agent's eye |
| save |
| check / install the connector inside Premiere |
| the agent skill: the router and its references |
| raw ExtendScript — only when enabled |
PR_MCP_FACADE=0 lists every operation as its own tool instead (more than 600K tokens of
definitions — beyond most context windows; the nine tools cost about 1.5K).
Variable | Default | Meaning |
| off |
|
| off |
|
| on |
|
| — | explicit profile, e.g. |
| OS temp | the connector's file mailbox |
| — | enables the optional UXP bridge (with the UXP plugin in Premiere) and its |
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}):
| the tools, the order of work (state → checkpoint → operate → verify by values, then by frame), addressing (node ids, source vs sequence time, selection-driven operations, localized Premiere) and a table of what scripts cannot do in Premiere with the reference for each. |
| Generative Extend, the Generative Media Tool (video with first/last/reference frames, sound effects with a voice guide, soundscape, music), Firefly Boards → sequence, partner models, credits per second. |
| Object Mask, why a new mask "does nothing", Clip vs Frame keyframes, Sharpness / Expansion, where mask data lives and how it goes missing. |
| Speech to Text, text-based editing of pauses and fillers, Paper Edit, single-word captions, and the server's word-timeline planners (fillers, pauses, retakes, bleeps, captions). |
| Enhance Speech, stem separation (beta), ducking by UI and by keyframes, Remix, FFmpeg analysis. |
| Auto Reframe, Scene Edit Detection, Morph Cut (and why it exports as a dissolve), Color Match, Warp Stabilizer. |
| the Search panel (Media Intelligence, similar frames, sound search) and the AI Assistant beta next to an agent. |
| syncing an AI-generated layer with the plate before compositing: time drift (speed keyframes from measured coincidence points), geometry (Motion per piece), colour (Levels), the people mask and seam — measured on exported frames by |
| eleven recipes that combine tools: a generated shot between two clips, interview cleanup, a tracked face blur, storyboard to sequence, removing location music, social versions, silence and beat cutting. |
| availability by region and licence, credits, beta vs release, handoff to colour and sound, export, scripting limits that look like bugs. |
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-11-04 (the vision row re-checked 2026-11-06):
Premiere-MCP-IMT | premiere-pro-mcp (upstream) | ||||
Tools the model sees by default | 9, over ~440 operations | the whole catalog (~440 tools) | 74 (profile | 5, over 283 operations | none — the agent pipes ExtendScript |
Knowledge of Premiere's AI tools | skill with 8 references + recipes | 2 skills (editing, development) | 7 workflow skills | 1 skill | 1 skill (scripting) |
Non-English Premiere | every UI language (all ten), verified live | English and es-ES measured | not stated | not stated | not stated |
Vision: acting on what the agent sees | frames returned as images; Object Masks drawn on what it sees (click = whole person, lasso = a part), ⊕/⊖, tracking, overlay check; speed keyframes placed on the timeline by sight (macOS); keyframes checked frame by frame | frames returned as images; Object Mask audits (read-only); no speed keyframes (no scripting setter) | frames as images; no masks; a time-remap keyframe tool listed in its unaudited full catalog | still export; no masks; constant speed only | no (scripting only) |
Telemetry | none | PostHog, off unless a key is set | none found | on by default (opt-out) | none mentioned |
Connector install | by the agent, with consent; installers with a live self-test | CLI flag | build from source (Go, Rust, Python) | CLI flag |
|
Clients | Claude Desktop (.mcpb), Cursor, Antigravity, ChatGPT gateway, any MCP client | npm, .mcpb, Codex / Claude Code plugins | build from source | npm, plugins, .mcpb | CLI + skill |
License | Apache-2.0 | MIT | MIT | MIT | MIT |
Adobe's own AI Assistant in Premiere (public beta since June 2026) organizes projects and assembles rough cuts; its documentation mentions neither Object Masks nor speed keyframes (checked 2026-11-06).
What we changed in the upstream code, besides the skill and the packaging: component and property
lookup by matchName and English names translated through Premiere's own UI dictionaries (on a
localized 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.
v1.3.1 · 2026-11-06 — descriptions name speed keyframes placed by sight next to Object Masks; a «How the agent sees» section.
v1.3.0 · 2026-11-06 — layer conform: syncing an AI-generated clip with the original plate — cut-only time (pieces slipped by whole frames,
conform.py1.2.0 withrefine-cuts), Transform per piece, Levels on the lower clip, the people mask with its edge inside the silhouette; effect-property tools acceptproperty_indexalone; Object Mask edit and Time Remap UI fixes.v1.2.0 · 2026-11-05 — vision: Object Masks by sight on macOS — the agent clicks a whole person or outlines a part (a face) on an exported frame, adds and subtracts, tracks and checks the red overlay; Premiere has no API for masks.
v1.1.1 · 2026-10-28 — Premiere's home screen:
pr_verifysays when no project is open, and an edit tried without a project no longer pauses the edits after it.v1.1.0 · 2026-10-28 — built on premiere-pro-mcp 1.26.0: every edit read back from Premiere, about 60 more operations, the UI-language layer carried into the new code; reinstall the connector with
pr_install_connector.v1.0.2 · 2026-10-28 — descriptions everywhere: every Adobe UI language, a large skills library, built for Adobe's generative features.
v1.0.1 · 2026-10-28 — product name Premiere-MCP-IMT (was PR-MCP-IMT); the MCP Registry entry also lists the npm package; the package is on npm from 1.0.0.
v1.0.0 · 2026-10-28 — every Premiere UI language (English names translated through Premiere's own dictionaries; verified live), honest results for unknown effects, colour correction and LUTs, Apache-2.0.
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
Apache License 2.0 — © Immersive Media Technologies.
Free to use, modify and distribute, commercial use included.
Attribution is required. Every redistribution of this software or of a work derived from it must carry the notice from
NOTICE:Premiere-MCP-IMT by Immersive Media Technologies — https://github.com/Immersive-Media-Technologies.No warranty.
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.
Available Tools
9 toolspr_batchB
Run several operations in order. Each op: {operation, args}. Stops at the first error when stopOnError (default true). Returns one result per op.
Inputs: ops (required), stopOnError.
pr_catalogA
List Premiere Pro operations available through pr_do. Without category: categories with counts and operation names. With category: every operation of that category with its parameters. Call it before using an operation you have not used in this session. Clips are addressed by node_id from pr_get_sequence.
Inputs: category.
pr_doA
Run one Premiere Pro operation by name (see pr_catalog), e.g. {"operation":"add_marker","args":{"time_seconds":1.5,"name":"Intro"}}. Returns the operation result JSON. Writes are verified by readback where Premiere allows it. A result with undoSteps / undoStackIndex can be reverted with the undo operation {expected_undo_stack_index}; property and marker writes record no undo step — checkpoint the sequence before them. Prefer this over writing ExtendScript.
Inputs: operation (required), args.
pr_export_frameA
Export one frame of the active sequence as PNG at output_path (Premiere QE still export, full resolution). time_seconds defaults to the playhead. Use it to LOOK at the result of an edit.
Inputs: output_path (required), time_seconds.
pr_get_sequenceA
Structure of the active sequence: video/audio tracks with clips (node_id, name, start/end/in/out seconds, enabled, speed). node_id is what every clip operation takes.
Inputs: no named parameters.
pr_install_connectorA
The Premiere side of the bridge (CEP extension MCPBridgeCEP). action=status (default, read-only) says whether it is installed and enabled; action=install copies it into the user's CEP extensions folder and enables unsigned CEP extensions (PlayerDebugMode) — ask the user first. After an install the user must quit and reopen Premiere Pro, then call pr_verify. Use when pr_verify reports that the connector does not answer.
Inputs: action.
pr_save_projectA
Save the open project (Cmd+S). Do it before exports and before batches of destructive edits.
Inputs: no named parameters.
pr_skillA
The Premiere agent skill. No doc: the router — order of work, what scripts cannot do in Premiere, which reference to read; read it at the start of any Premiere task beyond a single read or edit. doc: one reference — Premiere's AI tools (Generative Extend, Generative Media Tool, Object Mask, transcripts and Paper Edit, captions, Enhance Speech/Audio, Search, AI Assistant, Auto Reframe, Scene Edit Detection, Morph Cut), multi-tool recipes, gotchas.
Inputs: doc.
pr_verifyA
Read-only check: MCP ↔ Premiere connector ↔ open project ↔ active sequence. Call first in a session. Connector does not answer while Premiere is open → pr_install_connector (status, then install with the user's consent).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct role: pr_do (single op), pr_batch (multiple ops), pr_catalog (operation discovery), pr_skill (workflow guidance), plus sequence/export/save and connector tools. The only mild overlap is between pr_catalog and pr_skill, both being 'read docs' tools, and between pr_verify and pr_install_connector, but their descriptions delineate the boundary well (catalog = operations, skill = order of work and gotchas).
All names share a consistent pr_ prefix and snake_case, which is predictable. A few names are noun- or verb-only (pr_skill, pr_batch, pr_catalog, pr_do) rather than full verb_noun, but the pattern remains readable and uniform across the set.
9 tools is well within the ideal range, and the meta-tool design (catalog + do + batch) lets a small surface cover a very large operation space. Every tool earns its place: discovery, execution, batching, inspection, export, persistence, and connection setup.
The lifecycle is largely covered: verify connection, install connector, inspect sequence, execute/undo operations via pr_do, batch, save, and visually check via frame export. Minor gaps exist at the top level (no dedicated undo, sequence/video export, or media import tools), but these remain reachable through the pr_do operation catalog so agents aren't blocked.
Maintenance
Related MCP Connectors
Autonomous AI video editor over MCP: 37 tools, 189+ actions, 280+ caption templates, MP4 export.
AI video editor your agent can drive: plan scenes, edit a multi-track timeline, and render MP4s.
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
Orccut: a real timeline video editor for AI agents - journaled edits, FFmpeg/MLT rendering
Related MCP Servers
- AlicenseBqualityAmaintenanceEnables AI assistants to fully control Adobe Premiere Pro through 269 tools across 28 modules for video editing tasks like importing media, editing timelines, applying effects, and exporting.4515,272 npm553MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to control video editing software (剪映/CapCut and Adobe Premiere Pro) through a unified interface, supporting operations like material import, clip splitting, subtitle addition, effects, transitions, audio mixing, and export.10MIT
- AlicenseAqualityBmaintenanceLets AI agents drive a running Adobe After Effects (~270 undo-safe operations). Works with every UI language Adobe ships and sees the frame: draws Object Matte on what it sees (lassos, ⊕/⊖ points, a preview of gaps and people) and syncs AI-generated layers with the plate frame by frame. A large skills library, built for AI and generative features: Roto Brush, Object Matte, Content-Aware Fill.413766 npm3Apache 2.0
- AlicenseBqualityBmaintenanceLets AI agents drive a running Adobe Photoshop: 135 tools behind a 10-tool facade, a UXP bridge that keeps working while Photoshop shows a dialog. Works with every UI language Adobe ships and checks its work by sight. A large skills library, built for Adobe's generative features: Generative Fill, Expand, Upscale, Firefly and partner models.41351,000 npm6Apache 2.0