Premiere Pro MCP Server

Animate an effect parameter on a clip: turn animation on and add keyframes at times (seconds, as list_clip_effects reports keyframe times) with values and optional interpolation. Keyframes are one undo step, interpolation a second

Add a marker to a sequence or a clip project item at a time, with a name, type, duration, comments and colour. The colour is a second undo step

Add a video transition (by match name, from list_available_effects) at the start, end or both ends of video clips, with a duration and optionally single-sided, or replace the transition already there. One undo step

Change audio clips' volume by a number of decibels (Clip > Audio Options > Increase or Decrease Clip Volume; the Audio Clip Mixer's and Properties panel's volume), scaling every Level keyframe when the volume is animated, and set their pan or balance (the Panner's Balance, or Pan). Volume and pan are one undo step, keyframe interpolation a second

Apply an effect to clips: a video effect by match name or display name to video clips, an audio effect by display name to audio clips (names from list_available_effects). Appended to the end of the chain, or inserted at position. One undo step

Delete Premiere Pro's media cache files (Settings > Media Cache > Delete): conformed audio, peak files and indexes, which Premiere Pro rebuilds as needed. Premiere Pro 26.5 or later. The cache folder and automatic clean-up settings cannot be changed by script

Close the active project, or every open project (File > Close All Projects), without prompting. Unsaved changes are lost unless save is true

Close a sequence's Timeline panel (Premiere Pro 26.2 or later). The sequence stays in the project

Work the Source Monitor: open a clip project item (optionally at a time), play it at a speed (Play-Stop Toggle; negative plays backward, as the J, K and L shuttle keys do), close the clip or every clip, report what is open, or Match Frame (Sequence > Match Frame: open the source of a sequence clip at the frame under the playhead). Positioning needs Premiere Pro 26.3 or later. Playback is the Source Monitor only: the Program Monitor cannot be played from a script

Copy a clip's effects to other clips of the same kind (Edit > Copy, then Paste Attributes): applied effects are added to each target with the source's values and keyframes; with intrinsic: true, Motion, Opacity, Time Remapping (video) or Volume, Channel Volume, Panner (audio) values are copied onto the targets' own. Keyframes keep their offset from the clip's In point. Up to three undo steps: adding effects, values, keyframe interpolation

Copy an effect parameter's keyframes (values and interpolation) to the same or another parameter on other clips or the same clip (Effect Controls, copy and paste keyframes). Times keep their offset from each clip's In point, plus offset. Keyframes are one undo step, interpolation a second

Add a bin, or a search bin (File > New > Search Bin) that shows the items matching searchQuery, to the project root or inside another bin

Create a new project file (.prproj) and make it the active project: empty, or a copy of a template project (its bins, sequences and settings; the template file is not changed). Other open projects stay open

Create a sequence: empty with the default settings, from a sequence preset (.sqpreset), or from clips (New Sequence From Clip: settings match the first clip and the clips are placed in order). Opens it in the Timeline unless open is false

Make a subclip of a clip project item (Clip > Make Subclip): a new project item limited to a range of the source, optionally restricted so it cannot be trimmed past it (Premiere Pro 26.3 or later). Returns the new item

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. importIntoProject imports the file afterwards

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

Insert a project item (clip or sequence) into a sequence at a time: clips after that point on the targeted tracks move later. 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)

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