Premiere Pro MCP Server

Make a new sequence from the part of a sequence between its in and out points (Sequence > Make Subsequence), on the targeted tracks or on every track. Set the in and out points first (set_sequence_times or mark_clips)

Delete a sequence from the project

Duplicate a sequence (Sequence > Duplicate). The copy appears next to the original

Trim edits in the Timeline, each one undo step. slip: move the source in and out points of clips by the same amount, so they show other frames in the same place (Slip tool, Slip Clip Selection). roll: move the edit point between a clip and the next clip on its track (Rolling Edit tool; on an audio clip alone this makes a J or L cut). slide: move a clip between its neighbours, which are trimmed to keep the gap closed (Slide tool). trim_start_to_playhead and trim_end_to_playhead: trim clips under the playhead to it without rippling (Trim Previous and Trim Next Edit to Playhead)

Change a marker chosen by index (from list_markers) or guid: name, comments, type, duration, colour, or move it to a new start. One undo step

Queue a clip or sequence from the project, or a media file on disk, in Adobe Media Encoder with an encoder preset (.epr) (Export > Send to Media Encoder, or Media Encoder's queue). Whole item, its in to out, or (sequences) the work area; a file can be trimmed with inPoint and outPoint. Optionally starts the queue. Returns once the job is queued; wait_for_event with render_complete waits for it to finish

Run your own UXP JavaScript in Premiere Pro, as the body of an async function with ppro (require("premierepro")) and transact(project, undoName, build) in scope; build(add) receives add(action) for each Action, created inside the project lock as Premiere Pro 26.3 requires. Return a JSON-friendly value. It runs unrestricted: it can change or delete anything. Prefer the specific tools

Export one frame of a sequence as an image (Export Frame): PNG, JPEG, TIFF, BMP, DPX, GIF, EXR or TGA, chosen by the file extension. Size defaults to the sequence frame size

Export a sequence with an encoder preset (.epr) (File > Export > Media, or Quick Export): encode it now in Premiere Pro (the call waits; raise PREMIERE_SCRIPT_TIMEOUT_MS for long exports), or queue it in Adobe Media Encoder or Premiere Pro's own queue. The preset sets the format and every Export setting (video, encoding, keyframe distance, audio, captions, effects such as Image Overlay, metadata, VR, HDR, still image sequences); save one from the Export page or Media Encoder. Whole sequence or in to out (set them with set_sequence_times). Without an extension the preset's is added. importIntoP…

Export a sequence's edit for another application: Final Cut Pro XML (.xml) or OpenTimelineIO (.otio), Premiere Pro 26.2 or later, or AAF (.aaf) with default options, 26.3 or later

Read a clip project item's transcript as JSON (the Text panel's transcript, with word timings). Returns it, or writes it to a .json file when outputFile is given

Fade clips in and/or out with keyframes: video clips on Opacity (from 0 to their opacity), audio clips on the Volume effect's Level (from silence to their level), over the given seconds at the start and end of each clip (Effect Controls keyframes; a cross-fade transition is add_transition). One undo step

Scale video clips so their frame fits the sequence frame (Clip > Video Options > Set to Frame Size), or fills it, by setting Motion > Scale without resampling. The source frame size comes from the project item's Video Info, or from sourceWidth and sourceHeight. Square pixels are assumed. One undo step

Describe a clip or sequence project item: media file path, source in and out points, offline and proxy state, label colour, and footage interpretation (frame rate, pixel aspect ratio, field order, alpha)

Read a project item's metadata: the project metadata (Project panel columns, as XML) and the XMP metadata (as an XMP packet)

Read the Project panel's column layout (Metadata Display: which metadata fields show as List view columns, in what order and width), as Premiere Pro's XML

Describe the active project: name, file path, guid, the active sequence, how many sequences and top-level items it has, and the bin imports go to

Read the active project's ingest setting and scratch disk folders (File > Project Settings > Ingest Settings, Scratch Disks)

Read a sequence's custom properties: named values a script stored on it, carried into FCP XML exports. Give the names to read

Read a sequence's settings (Sequence > Sequence Settings): editing mode, timebase and frame rate, frame size, pixel aspect ratio, fields, display formats, audio sample rate and channels, preview file format, codec and size, maximum bit depth and render quality, and linear-colour compositing

List the tools by area, or describe one tool's parameters

Import compositions from an After Effects project (.aep, .aepx) as Dynamic Link clips (File > Adobe Dynamic Link > Import After Effects Composition) without the dialog: named compositions, or all of them, into the root or a bin

Import caption files (.srt, .scc, .mcc, .dfxp, .stl, .xml: SubRip, Scenarist, MacCaption, DFXP, EBU STL, W3C/SMPTE/EBU Timed Text XML) into the project without Premiere Pro's dialogs (File > Import), into the root or a bin. Each becomes a captions item to place on a caption track

Import files into the project (File > Import, or Import from Media Browser by path) without Premiere Pro's dialogs, into the root or a bin: video (QuickTime, MP4, HEVC, ProRes, MXF, DNxHD, AVCHD, camera raw such as R3D, ARRIRAW, BRAW), audio (WAV, AIFF, MP3, AAC), stills and layered files (PSD, AI, JPEG, PNG, TIFF, EXR, DPX ...), projects (Premiere Pro, Premiere Elements, Character Animator) and interchange files (AAF, EDL, FCP XML, batch lists). Image sequences import as one clip with numberedStills. Layered files import merged

Import chosen sequences, with the clips they use, from another Premiere Pro project (File > Import of a .prproj, Import Selected Sequences) without the Import Premiere Pro Project dialog. Give the sequences' guids: open that project and run list_sequences to see them. To import a whole project, pass the .prproj to import_media

Place a Motion Graphics template from a Creative Cloud Library in a sequence at a time on the given tracks (Libraries panel, or Graphics Templates > Libraries). Needs Creative Cloud Libraries signed in and synced. Its parameters can then be set as effect parameters (list_clip_effects, set_effect_param)

Place a Motion Graphics template (.mogrt) in a sequence at a time on the given tracks. Its parameters can then be read and set as effect parameters (list_clip_effects, set_effect_param)

Move the playhead to the next or previous keyframe of an effect parameter on a clip (Effect Controls, Go to Next or Previous Keyframe), from the playhead or a given sequence time. Returns the keyframe's time and the new playhead

List the video effects (match names and display names), audio effects (display names) or video transitions (match names) Premiere Pro has installed. These are the names apply_effect and add_transition take

List a clip's effects (its component chain, as in Effect Controls) with each parameter's name, value and keyframe times. Component and parameter indexes are what the other effect tools take

List the clips on a sequence's tracks with the indexes other tools take (track, trackIndex, clipIndex), name, start and end in the sequence, source in and out points, duration, speed, enabled and selected state, and the project item each comes from. name finds clips by name

List the Motion Graphics templates (.mogrt) installed in Premiere Pro's local templates folder (Window > Graphics Templates, Browse). Each filePath can be placed with insert_mogrt. The folder must be inside your home folder or PREMIERE_ALLOWED_DIRS to be listed

List the markers of a sequence or of a clip project item: index, name, type, start, duration, comments, colour index, guid (Premiere Pro 26.3 or later) and web link

List the items in the project or in one bin, with their id, kind (bin, clip, sequence), bin path and type. Ids and paths are what other tools take

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

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