premiere-pro-mcp

Get detailed properties of a specific clip by its node ID

Change the frame rate of the active sequence.

Enable 'Scale to Frame Size' on a project item so it fills the sequence frame

Create a subsequence (nested sequence) from selected clips or a time range

Attach a custom property (key/value pair) to the active sequence

Set the field order of the active sequence.

List all available video effects in Premiere Pro. Uses QE DOM.

List all available audio effects in Premiere Pro. Uses QE DOM.

List all available audio transitions. Uses QE DOM.

Get the current work area in and out points

Set project metadata on a project item

Create a subclip from a project item with in/out points

Get the current playhead (CTI) position in the active sequence

Enable or disable multiple clips at once (selected, track, or all).

Lift (remove without closing gap) the content between sequence in/out points or selected clips.

Add the same transition to all cut points on a track

Get all markers on a specific project item (source clip markers, not sequence markers).

Refresh a project item to pick up changes to the source file

Modify sequence settings (frame size, frame rate, etc.)

Auto-reframe a sequence for a different aspect ratio

Create a new sequence from a specific preset file (.sqpreset)

Add a transition to a specific clip's start or end

Encode an external file (not in project) using Adobe Media Encoder

Get the currently selected clips in the active sequence

Overwrite a project item onto the timeline (replaces existing clips at the insertion point)

Set the work area (bar) in and out points

Get the raw XMP metadata for a project item (includes EXIF, IPTC, Dublin Core, etc.)

List available Adobe Media Encoder export presets for a given format.

List all markers on the active sequence or a specific clip

Move a clip to a different track. Uses QE DOM.

Get information about the clip currently loaded in the Source Monitor.

Get the color label of a project item

Export the active sequence as a Final Cut Pro XML file

Set footage interpretation settings for a project item

Add a marker to a project item (source clip marker).

List all sequences in the project

Start encoding all items in the Adobe Media Encoder render queue

Enable or disable transcoding on ingest for the project

Get the current status of the Adobe Media Encoder render queue

Select a project item in the Project panel

Get the color space information for a project item

Duplicate a clip on the timeline (copy to same position on next available track)

Create a new Premiere Pro project at the specified path

Apply the Warp Stabilizer effect to a clip for video stabilization. Uses QE DOM.

Add a new video or audio track to the active sequence

Set the sequence in and out points (for export range, etc.)

Perform a slide edit on a clip (moves clip without changing its duration, adjusting adjacent clips). Uses QE DOM.

Check whether the work area bar is enabled on the active sequence

Apply a LUT file to a clip via Lumetri Color

Save the current Premiere Pro project

Undo the last action in Premiere Pro

Find project items whose media path contains the given search string

Get the current project panel metadata/column configuration as XML

Set the scratch disk path for a specific media type

Move a project item to a different bin

Set a project item to offline status (unlinks its media)

Get a human-readable summary of the timeline: total duration, clip count per track, total gaps, coverage percentage, used media files, effect usage, and marker overview. Great for a quick understanding of sequence state.

Perform scene edit detection on the selected clips in the active sequence

Check if a clip is an adjustment layer

Get a comprehensive snapshot of the current Premiere Pro state: project info, active sequence, playhead position, selected clips, and available sequences. The best first call to understand the current context.

Close a sequence tab in the timeline

Select all clips in the active sequence, or all clips on a specific track.

Remove all instances of a specific effect from a clip by display name.

Find all offline/missing media in the project with their expected file paths. Essential for diagnosing broken links.

Deselect all clips in the active sequence.

Select all disabled clips in the active sequence.

Close the clip currently open in the Source Monitor.

Set all tracks targeted or untargeted. Useful before insert/overwrite edits.

Set the start time (timecode offset) of a project item. This shifts where timecode begins for the source media.

Set the Position property on a video clip's Motion effect. Values are in pixels.

Get detailed information about a specific track: name, clip count, muted, locked, targeted, and list of all clips.

Set the Rotation property on a video clip's Motion effect.

Set the pan (left/right balance) on an audio clip.

Clear the in and/or out points on the active sequence.

Undo multiple steps at once.

Redo the last undone action in Premiere Pro.

Move multiple project items to a target bin at once.

Delete a project item (clip, bin, etc.) from the project panel. This removes it from the project but does not affect timeline instances.

Change the pixel aspect ratio of the active sequence.

Find project items that reference the same source media file. Useful for consolidation.

Get all clips at the current playhead position across all tracks.

Get the current scratch disk paths for the project.

Get source media info for the frame at the current playhead on a specific track. Useful for match frame operations.

Set the poster frame (thumbnail) for a project item at a specific time.

Rename a project item in the project panel.

Change the resolution (frame size) of the active sequence.

Get all unique media file paths used in the project. Useful for asset management and archiving.

Extract (remove and close gap) the content between sequence in/out points.

Move the playhead to the next or previous edit point.

Get the total number of sequences in the project.

List all available workspace layouts in Premiere Pro

Stop playback of the active sequence timeline. Uses QE DOM.

Add an adjustment layer to the active sequence via QE DOM. The layer is added at the playhead position on the specified track.

Change audio settings of the active sequence (sample rate, channel type).

Find all project items that are NOT used in any sequence. Useful for cleaning up projects.

Get information about linked clips (audio/video linked together) for a given clip.

Set the timecode display format for the active sequence.

Set the project's scratch disk paths for captured video, audio, and previews.

Get the total number of clips across all tracks in the active sequence.

Switch to a specific workspace layout (e.g., 'Editing', 'Color', 'Audio', 'Effects', 'Graphics')

Start playback of the clip in the Source Monitor

Start playback of the active sequence timeline. Uses QE DOM.

Set the project panel metadata/column configuration from XML

Relink an offline media item to a new file path

Select or deselect a clip in the active sequence

List all properties of a specific effect on a clip, including current values

Import an entire folder of media into the project

Export a sequence as a standalone Premiere Pro project file

Find the next or previous edit point (clip boundary) from the playhead position.

Get information about the currently open Premiere Pro project

Save the current project to a new location

Open a Premiere Pro project file

Consolidate duplicate project items

Delete a sequence from the project

Remove a clip from the timeline

Invert the current clip selection in the active sequence (selected become deselected and vice versa).

Open a project item in the Source Monitor for preview and trimming.

Enable or disable frame blending on a clip. Uses QE DOM.

Clear in and/or out points on a project item (reset to full duration).

Toggle uniform scale on a clip's Motion effect. When enabled, Scale Width and Scale Height are linked.

Create a caption/subtitle track in the active sequence from an imported caption file (e.g., .srt, .vtt)

Rename a video or audio track.

Get detailed information about the currently active sequence

List all tracks (video and audio) in a sequence

Get the settings (resolution, frame rate, etc.) of a sequence

Set the active sequence by name or ID

Import a Final Cut Pro XML file into the current project

Check if a project item has a proxy attached

Override the frame rate of a project item (useful for image sequences or misinterpreted media)

Get detailed type info about a project item (is it a sequence, multicam, merged clip, etc.)

Unnest a nested sequence on the timeline, replacing it with the contents of the nested sequence

Split (razor) a clip at a specific time position. Requires QE DOM.

Apply an audio effect to a clip

Rename a bin (folder) in the project panel

Get the graphics white luminance value (HDR setting) for the project

Get footage interpretation settings for a project item

Rename a clip on the timeline. Uses QE DOM.

Insert the clip from the Source Monitor at the playhead position (insert edit — shifts existing clips).

Get all keyframes for a specific effect property on a clip

Get the clip at a specific time position on a track

Create a new sequence in the project

Find a project item by name (searches recursively through bins)

Create a Bars and Tone synthetic media item in the project (useful for leader/calibration)

Replace a clip on the timeline with a different project item, preserving position and duration

Add a video transition between two clips at a cut point. Uses QE DOM.

Toggle a video track's visibility (eye icon)

Set the value of a specific effect property on a clip

Get metadata for a project item

Export the active sequence as an AAF file (for Pro Tools, etc.)

Add video and/or audio tracks to the active sequence. Uses QE DOM.

Set a color value on an effect property (e.g., tint color, fill color)

Get the interpolated value of an effect property at a specific time

Remove all currently selected clips from the timeline.

Get exhaustive information about a specific clip: all effects with every property value, source media details, footage interpretation, metadata, markers, speed, enabled state, color label, linked clips, and proxy status.

Rename multiple clips on the timeline using a pattern. Supports sequential numbering.

Find all gaps (empty spaces) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.

Health check — verify the CEP plugin is running and connected to Premiere Pro. Call this before other tools to confirm connectivity.

Apply an effect to multiple clips at once. Can target selected clips, all clips on a track, or all clips in the sequence.

Consolidate, copy, or transcode project media using the Project Manager. Useful for archiving or transferring projects.

Import After Effects compositions from an .aep file

Override the pixel aspect ratio of a project item

Move a clip to a new position on the timeline

Set raw XMP metadata on a project item (provide complete XMP XML string)

Export the active sequence as an OMF file (Open Media Framework, for audio post-production)

Add a keyframe to an effect property at a specific time

Set in and/or out points on a project item in the project panel (marks source range for editing).

Add a custom metadata field to the project's metadata schema

Set the graphics white luminance value (HDR setting) for the project

Evaluate a simple ExtendScript expression and return its value. Use for quick queries like checking a property, getting a count, or reading state. The expression should be a single value/call — NOT a full script. Examples: - "app.project.name" → project name - "app.project.activeSequence.name" → active sequence name - "app.project.rootItem.children.numItems" → number of root items - "app.project.activeSequence.videoTracks.numTracks" → number of video tracks - "app.version" → Premiere Pro version

Import a MOGRT from an Adobe Library by name

Get the current sequence in and out points

Set the opacity of a video clip (0-100).

Get the file extension that would be used when exporting the active sequence with a given preset

Copy all property values from one effect to the matching effect on another clip. Both clips must already have the same effect applied.

Set a track as targeted (active for insert/overwrite edits). Only one video and one audio track can be targeted at a time.

Delete a bin (folder) from the project panel

Enable or disable a clip on the timeline

Set in and/or out points on the clip currently open in the Source Monitor.

Delete all preview/render cache files for the project. Uses QE DOM.

Set the start time (timecode offset) for a project item

Trim a clip's in or out point

Set the color label on a project item or clip

Export the current frame as an image file

Remove a keyframe at a specific time from an effect property

Get the current time indicator position in the Source Monitor

Create a new sequence by automatically placing project items in order

Detach/remove the proxy from a project item

List all items in the project panel (clips, bins, sequences)

Capture the current frame and return it as inline image data for the LLM to see. This lets the AI visually inspect the current state of the timeline.

Set clip playback speed using QE DOM (more reliable than ExtendScript). Supports reverse.

Remove an effect from a clip by its index or name

Razor (split) all clips at the playhead position across all tracks, or at a specific time.

Get the current target bin for new imports (the bin that is currently focused in the Project panel)

Check for offline (missing) media in the project

Get Premiere Pro version and build information.

Get a complete structural overview of the active sequence: all tracks, all clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.

Set independent Scale Width and Scale Height on a clip (requires Uniform Scale to be OFF).

Add a marker to the active sequence or a clip

Perform a roll edit on a clip (adjusts the edit point between two adjacent clips). Uses QE DOM.

Set time interpolation type for a clip (Frame Sampling, Frame Blending, Optical Flow). Uses QE DOM.

Get a comprehensive overview of the entire project: all bins (recursive tree), all sequences, media stats, offline items, and project settings. This is the best first call to fully understand a project.

Get QE DOM information about a clip, including properties not available through the standard API.

Create a new bin (folder) in the project panel

Ripple delete a clip (removes clip and closes the gap). Uses QE DOM.

Set the volume level on an audio clip (in dB).

Get all clips in the sequence that are linked to the same source as a given clip

Get MOGRT (Motion Graphics Template) component parameters from a clip

Change the playback speed of a clip

Delete a video or audio track from the active sequence

Lock or unlock a video track

List all available video transitions. Uses QE DOM.

Add audio level keyframes to create fades or level changes

Mute or unmute an audio track

Add a text overlay (title) to the active sequence

Delete a marker at a specific time position

Update an existing marker's properties

Get the playback speed and reverse state of a clip

Link the currently selected video and audio clips in the active sequence

Unlink the currently selected video and audio clips in the active sequence

Set the starting timecode (zero point) of a sequence

Select all clips whose source project item has a specific color label.

Replace the source media of a clip on the timeline with a different project item, keeping the clip's position and duration.

Close all clips in the Source Monitor.

Get which tracks are currently targeted for editing.

Import a numbered image sequence as a single video clip.

Set the Scale property on a video clip's Motion effect.

Delete multiple project items at once from the project panel.

Nest selected clips into a nested sequence. Select the clips first, then call this tool.

Export the active sequence using Adobe Media Encoder

Remove all keyframes in a time range from an effect property

Encode a specific project item (not a sequence) using Adobe Media Encoder

Set the anti-alias quality on a clip's Motion effect (useful for scaled/rotated clips).

Set the Anchor Point property on a video clip's Motion effect.

Reverse a clip's playback direction. Uses QE DOM.

Set the playhead (CTI) position in the active sequence

Get detailed contents of a specific bin (folder) including all nested items, media paths, offline status, color labels, and metadata. Searches by bin name or node ID.

Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips).

Create a freeze frame from a clip at a specific time. Exports the frame and imports it back as a still image.

Close the current Premiere Pro project

Import sequences from another Premiere Pro project file

Set the interpolation type of a keyframe (Linear, Hold, or Bezier)

Set properties on a clip (opacity, speed, etc.)

Add the active sequence to the Adobe Media Encoder render queue

Execute custom ExtendScript code in Premiere Pro. The code runs inside an IIFE with helper functions available. IMPORTANT: You MUST write ES3 syntax (var instead of let/const, no arrow functions, no template literals, no destructuring). Available helpers (auto-prepended): - __ticksToSeconds(ticks) / __secondsToTicks(seconds) — time conversion - __ticksToTimecode(ticks, fps) — timecode string - __findSequence(idOrName) — find sequence by name or ID - __findProjectItem(nodeIdOrName) — find project item recursively - __findClip(nodeId) — find clip in active sequence, returns {clip, trackIndex, clipIndex, trackType} - __getAllClips(seq) — get all clips in a sequence - __result(data) — return success with data (MUST call this or __error) - __error(msg) — return error message - TICKS_PER_SECOND — constant 254016000000 - app.enableQE() — enable QE DOM access Your code MUST end with: return __result({...}) or return __error("message") Example: Set opacity to 50% on all video clips var seq = app.project.activeSequence; if (!seq) return __error("No active sequence"); var count = 0; for (var t = 0; t < seq.videoTracks.numTracks; t++) { var track = seq.videoTracks[t]; for (var c = 0; c < track.clips.numItems; c++) { var clip = track.clips[c]; for (var i = 0; i < clip.components.numItems; i++) { var comp = clip.components[i]; if (comp.displayName === "Opacity") { for (var p = 0; p < comp.properties.numItems; p++) { if (comp.properties[p].displayName === "Opacity") { comp.properties[p].setValue(50, true); count++; } } } } } } return __result({updated: count});

Get all markers of a specific type (comment, chapter, web link, etc.) from a sequence.

Import a Motion Graphics Template (.mogrt) file and add it to the timeline

Create or attach proxies for a project item

Perform a slip edit on a clip (changes source in/out points without moving clip on timeline). Uses QE DOM.

Select all clips that overlap a time range in the active sequence.

Import media files into the project

Set the blend mode on a video clip. Uses the Opacity effect's Blend Mode property.

Adjust the audio level (volume) of a clip in dB

Create a smart bin (search bin) in the project panel

Add a project item (clip) to the timeline at a specific position

Apply basic color correction to a clip using Lumetri Color

Get exhaustive information about a sequence: settings, all tracks with lock/mute/target state, all clips with positions/effects/speed/enabled state, all markers, transitions, in/out points, and work area.

Search for project items by name, media file extension, offline status, or color label. Returns matching items with full details.

Select all clips in the active sequence that match a name (substring match). Optionally filter by track type and index.

Duplicate an existing sequence

List all effects/components on a clip with their properties and current values. Essential for debugging effect issues.

Remove ALL effects from a clip. Uses QE DOM.

Get detailed information about a project item (media file in the project panel): media path, resolution, duration, frame rate, codec info, metadata, color label, offline status, in/out points, and proxy status.

Apply a video effect to a clip. Uses QE DOM for effect lookup.

Get a report of all media files used in a sequence: which source files are used, how many times each appears, on which tracks, and whether any sources are offline.

Inspect a Premiere Pro DOM object and list its properties, methods, and values. Useful for exploring the API and debugging. Examples: - "app.project" → project properties - "app.project.activeSequence" → sequence properties - "app.project.activeSequence.videoTracks[0].clips[0]" → first clip on V1 - "app.project.activeSequence.videoTracks[0].clips[0].components[0]" → first component of a clip

Copy all effects (or a specific effect) from one clip to another. Does not copy intrinsic properties like Motion/Opacity unless specified.