Premiere Pro MCP Server

List the project's sequences: name, guid, whether active, frame size, timebase, end time, in/out and zero points, playhead and track counts

List a sequence's video, audio and caption tracks: index (0 = V1/A1/C1), name, id, mute state and how many clips each holds

List the languages Speech to Text can transcribe (Premiere Pro 26.3 or later) and whether each one's language pack is installed (Preferences > Transcription), or check given language codes such as "en-US". Language packs are installed from Creative Cloud or Premiere Pro, not here

Rename, move to another bin, set the label colour of, or delete project items (bins, clips, sequences). Changes are one undo step

Refresh clips' media from disk (Refresh Media), take them offline keeping the files (Clip > Make Offline, one undo step), or attach a proxy or the full-resolution file to one clip (Proxy > Attach Proxies, Reconnect Full Resolution Media; not undoable)

List, apply or remove source clip effects: effects on a clip project item itself (applied in the Source Monitor or Project panel), which every use of the clip in sequences inherits. Video effects only for apply. Applying and removing are one undo step each

Set a sequence's in and out points around clips: the clips under the playhead (Markers > Mark Clip) or the given or selected clips (Markers > Mark Selection), from the earliest start to the latest end. One undo step

Change how clips' media is interpreted (Clip > Modify > Interpret Footage: frame rate, pixel aspect ratio, field order, alpha channel, remove pulldown), set their starting timecode (Clip > Modify > Timecode), or scale them to the sequence frame size (Clip > Video Options > Scale to Frame Size). One undo step

Move clips later or earlier in the sequence by a number of seconds (negative moves earlier), keeping their tracks. One undo step

Move a sequence's playhead: by frames (Step Forward, Step Back), to the next or previous edit point (Go to Next/Previous Edit Point), gap (Sequence > Go To Gap) or marker (Markers > Go to Next/Previous Marker), or to the in or out point (Markers > Go to In, Go to Out). Edits and gaps are on every video and audio track unless track is given. Not an undo step

Open a project file (.prproj) and make it the active project, with Premiere Pro's convert, locate-file and warning dialogs turned off unless showDialogs is true. Projects already open stay open

Open a sequence in the Timeline and make it the active sequence

Overwrite a sequence with a project item (clip or sequence) at a time: whatever is there on the targeted tracks is replaced. A track index past the last track adds a track. sourceIn and sourceOut place only that range (for example words found in export_transcript, as Text-Based Editing does)

Check the connection to Premiere Pro: the port the server listens on, whether the plugin is connected, Premiere Pro's version, and (with probe) the active project and sequence. Use this first when a call fails to connect

Recover a project after a crash: list the copies in its Auto-Save folder (the Auto Save scratch disk, by default "Adobe Premiere Pro Auto-Save" beside the project), newest first, and with open: true open the newest (or a chosen one) as a separate project, with Premiere Pro's dialogs turned off. The original project file is not changed

Point clips at different media files (File > Link Media, Clip > Replace Footage) without the Link Media or Where Is the File dialogs: one clip to newPath, or every offline clip (or the items given) to the file of the same name found in searchFolders. Not undoable

Remove clips from the sequence (Clear), or close the gap they leave with ripple: true (Ripple Delete). One undo step

Remove an applied effect from clips, by component index (from list_clip_effects). One undo step

Remove keyframes from an effect parameter on a clip: at given times, in a time range, or all of them (turns animation off, keeping the value at the start). One undo step

Remove markers from a sequence or clip project item, chosen by index or guid, or all of them (optionally of one type). One undo step

Remove the video transition at the start, end or both ends of video clips. One undo step

Change how fast an effect animates by spreading its keyframes further apart or closer together (scale) from the first or last keyframe, and optionally shifting them all (offset), keeping each keyframe's value and interpolation. Keyframes are one undo step, interpolation a second

Show a clip's media file in Finder or File Explorer (Reveal in Finder, Reveal in Explorer). Returns the path

Discard the active project's unsaved changes by reopening its last saved version (File > Revert), with Premiere Pro's dialogs off

Analyse clips for cuts in their footage (Clip > Scene Edit Detection, without the dialog) and add an edit, a clip marker or a subclip at each cut. Runs on the given clips or the Timeline selection; the selection is replaced by those clips. Analysis can continue after the call returns: waitSeconds waits for it

Save the active project, or save it as a new .prproj (File > Save As: the project then refers to the new file, not the original)

Turn on Scale to Frame Size for clip project items (Clip > Video Options > Scale to Frame Size): clips placed from them afterwards are resampled to the sequence frame size. Clips already in a sequence are not changed; fit_clips_to_frame sets their scale. One undo step

Find project items (Edit > Find) by part of their name, part of their media file path, kind, or whether their media is offline, in the whole project or one bin. Returns ids and bin paths as list_project_items does, with the media path and offline state when those were searched

Change the Timeline selection: select given clips (Selection tool), every clip (Edit > Select All), none (Edit > Deselect All), the clips under the playhead (Select Clip at Playhead), every clip from a time on or before it (Track Select Forward and Backward tools), or the clip after or before each selected one on its track (Next and Previous in Sequence). Returns the selected clips. Not an undo step

Set the Input LUT override of clip project items (Clip > Modify > Input LUT), which converts the footage before any grading: a LUT id, or the override (or embedded LUT) another clip uses. Returns each clip's override and embedded LUT ids before and after. One undo step

Rename clips in the Timeline, or enable or disable them (Clip > Enable). One undo step

Set video clips' built-in Motion (or Vector Motion, for graphics) and Opacity settings (Effect Controls): position, scale, rotation, anchor point, anti-flicker, opacity and blend mode, for placing and compositing clips over the tracks below. Values are in the units list_clip_effects reports. An animated setting is refused unless clearKeyframes is true. One undo step

Set the Level of audio clips' built-in Volume effect. Premiere Pro stores Level as a linear amplitude, not decibels; read the current value with list_clip_effects first and scale it. Turns off Level keyframes. One undo step

Set an effect parameter on clips to one value (not animated). An animated parameter keeps its keyframes unless clearKeyframes is true. Values: numbers, text, true/false, points { x, y }, colours { red, green, blue, alpha } from 0 to 1. One undo step

Grade video clips with Lumetri Color (Window > Lumetri Color): set Basic Correction (Input LUT, white balance, tone), Creative (Look, intensity, faded film, vibrance, tints), Color Wheels & Match, HSL Secondary corrections and Vignette settings by their display names, or any Lumetri parameter by index. Adds a Lumetri Color effect to clips that have none. Values as list_clip_effects reports them. One undo step, two when an effect is added

Write a project item's XMP metadata (a whole XMP packet, usually get_metadata's with your changes) or project metadata (XML, with the names of the fields that changed). One undo step

Change the Project panel's Metadata Display: add fields to the project metadata schema (they become available as columns), and/or set the column layout from XML (usually get_metadata_display's with your changes). Not undoable

Turn ingest on or off (File > Project Settings > Ingest Settings), choose scratch disk folders (Scratch Disks), and pause or resume refreshing growing files. Settings are one undo step; pausing growing files is not undoable

Store or clear custom properties on a sequence: named text, number or true/false values a script keeps with it, carried into FCP XML exports. One undo step

Change a sequence's settings: frame size, frame rate (Premiere Pro 26.2 or later), pixel aspect ratio, fields, editing mode, display formats, audio sample rate, preview file format, codec and size, maximum bit depth and render quality, linear-colour compositing. Values as get_sequence_settings reports them. One undo step

Set a sequence's in and out points, zero point (start time), work area (Premiere Pro 26.5 or later) and playhead position. Times are seconds. In, out and zero point are one undo step; the playhead and work area are not undoable

Set or clear the in and out points of clip project items, as marking them in the Source Monitor does (Markers > Mark In, Mark Out, Clear In and Out). Used to choose the part of a clip to edit in, or to line up camera angles for synchronising. One undo step

Mute or unmute a track (Toggle Track Output for video), or rename it (Premiere Pro 26.3 or later). Muting is not an undo step

Transcribe a clip project item's audio with Speech to Text (Premiere Pro 26.5 or later). Needs the language pack Premiere Pro uses; waits until the transcript is done, so raise PREMIERE_SCRIPT_TIMEOUT_MS for long clips

Trim a clip: set its source in and out points, or its start and end in the sequence (seconds). One undo step

Wait until Premiere Pro reports an event (script events), or until the timeout: a project opening, closing, changing, being activated or its Project panel selection changing; a sequence being activated, closed or its selection changing; a Media Encoder job being queued, progressing, completing, failing or being cancelled; an export or import finishing. Returns whether it happened and the event's details. Other calls wait while this one runs