Repository navigation
Releases
v1.2.11
Fixes
import_mediaputs the file inbinNamewhen that bin exists, and fails when it does not. The previous call imported to the project root and still echoed the bin name.move_clip_to_trackremoves the extra audio clip Premiere creates for the parked copy. The original linked audio stays.ripple_deleteremoves the clip and its linked audio, closes the gap by the deleted duration, and reportsripple: trueonly after the later clips have moved.add_adjustment_layerplaces an adjustment layer already in the project. It no longer imports a transparent PNG.verify_premiere_connectionreportsreadOnlyfrom the project file. A stalled ExtendScript call is no longer hidden by a fresh panel heartbeat.- The CEP manifest names Premiere as the dispatch host. The macOS installer enables PlayerDebugMode for CSXS 9 through 15. Windows doctor fails when that value is a DWORD, or when the CEP log says this panel's signature was rejected.
detect_silencelooks outsidePATHfor ffmpeg and, when it is missing, returns the install command for this machine.export_framekeeps Premiere 26's timecode error. A later raw-seconds attempt no longer replaces it with "Illegal Parameter type".
npm install -g adobe-premiere-pro-mcp@1.2.11
premiere-pro-mcp --install-cepQuit Premiere, reopen it, reload Window > Extensions > MCP Bridge, then restart the MCP client.
v1.2.10
Fixes
apply_lutstores a.cubeor.3dlon Lumetri's Input LUT and selects it. The previous call wrote the path onto the numeric menu, swallowed the error, and still returned success. A missing file, or a path Premiere does not keep, is now a failure. The second Input LUT menu is left alone, because writing it clears the first.apply_effectuses the same path whenInput LUTis a file path.
Telemetry
- Clients send at most one launch per install per UTC day and at most one failed tool call per UTC day. Successful tool calls are not sent.
npm install -g adobe-premiere-pro-mcp@1.2.10
premiere-pro-mcp --install-cepReload Window > Extensions > MCP Bridge, then restart the MCP client.
v1.2.9
Fixes
export_sequencefinds Adobe Media Encoder inside the Creative Cloud folder (/Applications/Adobe Media Encoder 2026/Adobe Media Encoder 2026.app). The 1.2.8 check only matched an.appdirectly under/Applications, so a normal macOS install always returnedMEDIA_ENCODER_NOT_INSTALLED.get_encoder_presetsalso looks in~/Documents/Adobe/Adobe Media Encoder/<version>/Presets, which is where Media Encoder saves user presets.
npm install -g adobe-premiere-pro-mcp@1.2.9
premiere-pro-mcp --install-cepReload Window > Extensions > MCP Bridge, then restart the MCP client.
v1.2.8
Fixes
move_clip_to_trackparks past the last clip on the destination, restores source in/out and timeline duration, slides into the occupancy-checked span, then lifts the source. The 1.2.6 fallback wroteoverwriteClipat the destination using the project item's own duration, so a trimmed still could take out a neighbour the guard never saw.- The CEP update banner copies
npm install -g adobe-premiere-pro-mcp@latest && premiere-pro-mcp --install-cepinstead of spawning npm from Premiere. --install-cepcopies over the live extension instead ofrm -rf.
npm install -g adobe-premiere-pro-mcp@1.2.8
premiere-pro-mcp --install-cepReload Window > Extensions > MCP Bridge, then restart the MCP client.
v1.2.7
Fixes
- Premiere 26 QE cannot enumerate sequences (
getSequenceAtthrows;openInTimelineis missing).__qeSequenceFornow activates the requested sequence viaopenSequence/activeSequenceso QE tools address that timeline, not whatever is on screen. set_sequence_field_typewrites numeric field type0/1/2instead of the string"No Fields".set_metadatano longer coercesvalueto a number when a metadatakeyis present.- Expanded tools that need a clip or project item now require
clipId/projectItemIdin the schema. add_transitionmatchesadd_transition_to_clip(applied_verified/accepted_unverified). Transition verification no longer exports FCP XML, which opened Translation Results dialogs.apply_audio_effectrejects video-only clips withclip_has_no_audio.import_fcp_xmlwarns that Premiere may still show Translation Results windows.
Removed
remove_effect, remove_effect_by_name, and remove_all_effects. Premiere 26 has no effect-removal API. Catalog is 283 tools.
Install
npm install -g adobe-premiere-pro-mcp@1.2.7
premiere-pro-mcp --install-cepReload the MCP Bridge CEP panel in Premiere after updating.
See CHANGELOG.md for details.
v1.2.6
Fixes
- Prelude defines
__ticksToSeconds/__secondsToTicks(PremiereTimeobjects and tick strings).list_sequences,get_active_sequence,set_playhead_position,create_sequence, work area, MOGRT import, and subclip tools no longer throwReferenceErroron a Connected panel. replace_cliphonorspreserveEffects(default true): restore trim, enabled, Motion, and re-apply other effects.move_clip_to_trackrestores source in/out, skips the source clip in occupancy checks, and refuses an occupied destination unlessoverwriteis true.trim_clipduration writesclip.endand only then syncs sourceoutPointif the duration actually applied.create_sequence_from_clipsparses JSON-encoded id arrays (["000f4241"]) and comma-separated hex ids.apply_effectmatches localized parameter names (Exposure/Exposition) and coerces values. Effect removal triescomponents.remove/ QE, then verifies the component is gone.- CEP panel auto-starts the bridge on load.
verify_premiere_connectionlaunches Premiere when it is installed. - Premiere launch paths are joined with posix/win32 keyed off
process.platformso Windows CI stubs do not feed backslashes toopen -a.
Tool search
tools/list now advertises a small always-on set: search_tools, get_tool_schema, invoke_tool, verify_premiere_connection, and list_sequences. Search the rest with BM25 query or regex pattern, then invoke_tool. Set PREMIERE_MCP_TOOLSET=full to list every tool (for hosts that natively defer MCP schemas).
Install
npm install -g adobe-premiere-pro-mcp@1.2.6
premiere-pro-mcp --install-cepReload the MCP Bridge CEP panel in Premiere after updating.
See CHANGELOG.md for details.
v1.2.5
Fixes
- Clip, effect, and transition names match localized Premiere labels (Motion/Movimento, Scale/Escala, Volume/Lautstärke, Gaussian Blur/Flou gaussien, Cross Dissolve, Crop, and the same family).
add_keyframe,set_clip_properties, andadjust_audio_levelsresolve Opacity on Motion, Position X/Y as the Position array plus an axis, and do not pass arrays into scalar Scale.- Sequences resolve by GUID, name, or hex
projectItem.nodeId. A timeline clip id can resolve toclip.projectItem. export_frameconverts seconds toHH:MM:SS:FFfirst and retries QE after opening the sequence.apply_effectreuses a component that is already present. Transitions settle then resolve by localized name.capture_framewrites totmpdir()/premiere-mcp-frame-*.pngwhenoutputPathis omitted.
Install
npm install -g adobe-premiere-pro-mcp@1.2.5
premiere-pro-mcp --install-cepReload the MCP Bridge CEP panel in Premiere after updating.
See CHANGELOG.md for details.
v1.2.4
Fixes
- Clip speed uses the real QE
setSpeedsignature (fixesNot Enough Parameters/Illegal Parameter type). create_sequence_from_clipsresolves hex timeline ids like000f4242across sequences.add_text_overlayprobes more MOGRT text fields, including JSON after a binary prefix.- Telemetry no longer stores quoted sequence names.
Update prompt
The MCP Bridge panel shows Update now / Later when a newer npm version is published. Later snoozes for 7 days. Opt out with PREMIERE_MCP_UPDATE_CHECK=0.
Install
npm install -g adobe-premiere-pro-mcp@1.2.4
premiere-pro-mcp --install-cepReload the MCP Bridge CEP panel in Premiere after updating.
See CHANGELOG.md for details.
v1.2.3
Fixes
- Tool arguments accept snake_case and numeric strings;
add_transition_to_clipacceptsEnd/in/outand string durations. speed_changesends QE percents (50, not0.5).create_sequence_from_clipsaccepts a single item or timeline clip id; keyframes match names without regard to case.
UX
- If the MCP Bridge panel is not running, tools fail in about two seconds with
retry: falseinstead of hanging for a minute. Reload the CEP panel after updating so it writes the heartbeat file. add_text_overlaywithout a.mogrtfails immediately. Premiere cannot create titles from text alone.
Telemetry
Failed tool calls now send a short error code, the Zod field names that failed, and a path-stripped error template. Project names, media paths, and arguments are still not sent. See PRIVACY.md.
Install
npm install adobe-premiere-pro-mcp@1.2.3Reload Window > Extensions > MCP Bridge in Premiere after updating.
v1.2.2
Telemetry
Anonymous usage telemetry is on by default: install id, tool names, success or failure, duration, OS, and version. Project names, media paths, arguments, and results are not sent.
Opt out from Share anonymous usage data in Window > Extensions > MCP Bridge (CEP), with PREMIERE_MCP_TELEMETRY=0, DO_NOT_TRACK=1, or "telemetry": false in ~/.premiere-mcp-bridge/config.json. See PRIVACY.md.
Install
npm install adobe-premiere-pro-mcp@1.2.2Reload the MCP Bridge CEP panel in Premiere after updating so it is not running the old JavaScript.
See CHANGELOG.md for details.