# Premiere Pro MCP Server (npm · adobe-mcp-premiere)

Drive Adobe Premiere Pro from any MCP client: projects, sequences, timeline edits, effects, export.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-23

## Components

- npm · `adobe-mcp-premiere`: 69/100 (this document), [markdown](https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere.md), [page](https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere)

## Channel facts

- Registry: `npm`
- Package: `adobe-mcp-premiere`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-23.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 96 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 14519 tokens (~151/item across 96 items; 96 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 93% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 9 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 97 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Premiere Pro MCP Server server?

Premiere Pro MCP Server runs locally as an npm package, launched with npx -y adobe-mcp-premiere. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add zachshallbetter-adobe-mcp-premiere -- npx -y adobe-mcp-premiere
```

### Cursor

```json
{
  "mcpServers": {
    "zachshallbetter-adobe-mcp-premiere": {
      "command": "npx",
      "args": [
        "-y",
        "adobe-mcp-premiere"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "zachshallbetter-adobe-mcp-premiere": {
      "command": "npx",
      "args": [
        "-y",
        "adobe-mcp-premiere"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add zachshallbetter-adobe-mcp-premiere -- npx -y adobe-mcp-premiere
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zachshallbetter-adobe-mcp-premiere": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "adobe-mcp-premiere"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add zachshallbetter-adobe-mcp-premiere --command npx --arg -y --arg adobe-mcp-premiere
```

### Hermes

```yaml
mcp_servers:
  zachshallbetter-adobe-mcp-premiere:
    command: "npx"
    args: ["-y", "adobe-mcp-premiere"]
```

### Netclaw

```json
{
  "McpServers": {
    "zachshallbetter-adobe-mcp-premiere": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "adobe-mcp-premiere"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add zachshallbetter-adobe-mcp-premiere -t stdio -c npx -a -y adobe-mcp-premiere
```

### Other

```json
{
  "mcpServers": {
    "zachshallbetter-adobe-mcp-premiere": {
      "command": "npx",
      "args": [
        "-y",
        "adobe-mcp-premiere"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-21 (score 69, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-20 (score 54)

First indexed and scored.

## MCP tools (96)

### `get_project_info` (~42 tokens)

Get Project Info

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

### `create_project` (~97 tokens)

Create Project

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

Input parameters:

- `filePath` (string, required): Absolute path of the new .prproj
- `template` (string): Absolute path of a .prproj to start from (a project template). Default: an empty project

### `open_project` (~112 tokens)

Open Project

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

Input parameters:

- `addToRecent` (boolean): Add the project to File > Open Recent. Default true
- `filePath` (string, required): Absolute path of the .prproj
- `showDialogs` (boolean): Let Premiere Pro show its convert, locate-file and warning dialogs (they wait for the user). Default false

### `save_project` (~81 tokens)

Save Project

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)

Input parameters:

- `filePath` (string): Save As to this absolute .prproj path. Omit to save in place
- `overwrite` (boolean): Replace filePath if it exists. Default false

### `close_project` (~70 tokens)

Close Project

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

Input parameters:

- `all` (boolean): Close every open project, not only the active one. Default false
- `save` (boolean): Save before closing. Default false

### `revert_project` (~35 tokens)

Revert Project

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

### `list_project_items` (~125 tokens)

List Project Items

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

Input parameters:

- `bin` (object): List inside this bin. Default: the project root
- `depth` (integer): How many bin levels to descend. Default 10
- `kind` (string): Only items of this kind
- `limit` (integer): At most this many items. Default 500
- `selected` (boolean): List the items selected in the Project panel instead

### `search_project_items` (~172 tokens)

Search Project Items

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

Input parameters:

- `bin` (object): Search inside this bin. Default: the whole project
- `kind` (string): Only items of this kind
- `limit` (integer): At most this many items. Default 500
- `mediaPath` (string): Text the media file path contains (any case); only clips match
- `name` (string): Text the item name contains (any case)
- `offline` (boolean): true: only clips whose media is offline; false: only online clips

### `get_clip_info` (~91 tokens)

Get Clip Info

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)

Input parameters:

- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique

### `import_media` (~206 tokens)

Import Media

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

Input parameters:

- `bin` (object): Import into this bin. Default: the project root
- `files` (array, required): Absolute paths
- `numberedStills` (boolean): Treat numbered still images as one image sequence. Default false

### `create_bin` (~109 tokens)

Create Bin

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

Input parameters:

- `makeUnique` (boolean): If the name is taken, let Premiere Pro make it unique. Default true
- `name` (string, required): Bin name
- `parent` (object): Create inside this bin. Default: the project root
- `searchQuery` (string): Make a search bin showing the items that match this text

### `manage_items` (~149 tokens)

Manage Items

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

Input parameters:

- `delete` (boolean): Remove the items from the project. Default false
- `items` (array): The items
- `label` (integer): Label colour by index, 0-15, as in Edit > Label
- `moveTo` (object): Move into this bin (moveToRoot for the project root)
- `moveToRoot` (boolean): Move to the project root
- `rename` (string): New name (one item only)
- `selected` (boolean): Also act on the items selected in the Project panel

### `import_project_sequences` (~121 tokens)

Import Project Sequences

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

Input parameters:

- `projectPath` (string, required): Absolute path of the .prproj to import from
- `sequences` (array, required): Guids of the sequences to import, as list_sequences reports them in that project

### `import_after_effects_comps` (~119 tokens)

Import After Effects Comps

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

Input parameters:

- `aepPath` (string, required): Absolute path of the .aep or .aepx
- `bin` (object): Import into this bin. Default: the project root
- `comps` (array): Composition names to import. Omit to import every composition

### `relink_media` (~207 tokens)

Relink Media

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

Input parameters:

- `depth` (integer): With searchFolders: how many folder levels to search. Default 5
- `item` (object): With newPath: the clip to relink
- `items` (array): With searchFolders: only these clips (still only the offline ones). Default: every offline clip in the project
- `newPath` (string): Absolute path of the new media file for item
- `overrideChecks` (boolean): Relink even when Premiere Pro finds the new file incompatible (different media type or duration). Default false
- `searchFolders` (array): Relink offline clips to the file with the same name found in these folders (absolute paths)

### `manage_media` (~130 tokens)

Manage Media

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)

Input parameters:

- `action` (string, required): What to do
- `items` (array): The clip items (from list_project_items)
- `mediaPath` (string): With attach_proxy or attach_full_resolution: absolute path of the proxy or full-resolution file
- `selected` (boolean): Also act on the items selected in the Project panel

### `modify_footage` (~295 tokens)

Modify Footage

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

Input parameters:

- `alphaUsage` (string): How the alpha channel is interpreted
- `fieldOrder` (string): Field order: default uses the file's own
- `frameRate` (number): Assume this frame rate, frames per second (e.g. 23.976)
- `ignoreAlpha` (boolean): Ignore the alpha channel
- `invertAlpha` (boolean): Invert the alpha channel
- `items` (array): The clip items (from list_project_items)
- `pixelAspectRatio` (number): Conform to this pixel aspect ratio, e.g. 1 for square pixels or 2 for 2:1 anamorphic
- `removePulldown` (boolean): Remove 3:2 pulldown
- `scaleToFrameSize` (boolean): true: scale to the sequence frame size (only true is accepted)
- `selected` (boolean): Also act on the items selected in the Project panel
- `startTime` (number): Media start timecode, in seconds (3600 = 01:00:00:00)

### `reveal_media_file` (~73 tokens)

Reveal Media File

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

Input parameters:

- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique

### `get_project_media_settings` (~34 tokens)

Get Project Media Settings

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

### `set_project_media_settings` (~142 tokens)

Set Project Media Settings

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

Input parameters:

- `ingestEnabled` (boolean): Run the project's ingest operation (copy, transcode or create proxies, as set in Premiere Pro) on import
- `pauseGrowing` (boolean): true pauses refreshing growing files (media still being written); false resumes
- `scratchDisks` (object): Scratch disk folders to change. Each is "same_as_project", "my_documents" or an absolute path of an existing folder

### `list_sequences` (~41 tokens)

List Sequences

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

### `create_sequence` (~136 tokens)

Create Sequence

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

Input parameters:

- `bin` (object): With items: put the new sequence in this bin
- `items` (array): Clips to build the sequence from, in order
- `name` (string, required): Sequence name
- `open` (boolean): Open it in the Timeline and make it active. Default true
- `preset` (string): Absolute path of a .sqpreset file

### `open_sequence` (~46 tokens)

Open Sequence

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

Input parameters:

- `sequence` (object, required): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `get_sequence_settings` (~94 tokens)

Get Sequence Settings

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

Input parameters:

- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_sequence_settings` (~315 tokens)

Set Sequence Settings

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

Input parameters:

- `audioDisplayFormat` (string)
- `audioSampleRate` (integer): Samples per second, e.g. 48000
- `compositeInLinearColor` (boolean)
- `editingMode` (string): As get_sequence_settings reports it
- `fieldType` (string)
- `frameRate` (number): Frames per second, e.g. 23.976, 25, 29.97 (26.2 or later)
- `height` (integer): Frame height in pixels (give with width)
- `maximumBitDepth` (boolean)
- `maximumRenderQuality` (boolean)
- `pixelAspectRatio` (string): As get_sequence_settings reports it
- `previewCodec` (string): As get_sequence_settings reports it
- `previewFileFormat` (string): As get_sequence_settings reports it
- `previewHeight` (integer)
- `previewWidth` (integer)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `videoDisplayFormat` (string)
- `width` (integer): Frame width in pixels (give with height)

### `duplicate_sequence` (~49 tokens)

Duplicate Sequence

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

Input parameters:

- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `delete_sequence` (~40 tokens)

Delete Sequence

Delete a sequence from the project

Input parameters:

- `sequence` (object, required): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_sequence_times` (~190 tokens)

Set Sequence Times

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

Input parameters:

- `inPoint` (number): Sequence in point, seconds
- `outPoint` (number): Sequence out point, seconds
- `playhead` (number): Move the playhead here, seconds
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `workAreaIn` (number): Work area in, seconds (26.5 or later)
- `workAreaOut` (number): Work area out, seconds (26.5 or later)
- `zeroPoint` (number): Start time of the timecode, seconds

### `close_sequence` (~57 tokens)

Close Sequence

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

Input parameters:

- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `create_subsequence` (~117 tokens)

Create Subsequence

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)

Input parameters:

- `allTracks` (boolean): Take every track, ignoring track targeting. Default false
- `open` (boolean): Open the new sequence in the Timeline. Default false
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `move_playhead` (~207 tokens)

Move Playhead

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

Input parameters:

- `frames` (integer): With next_frame and previous_frame: how many frames. Default 1 (Shift steps 5)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `to` (string, required)
- `track` (string): Only clips on this kind of track (give with trackIndex); default every video and audio track
- `trackIndex` (integer): Only this track, 0 = V1 or A1 (with track)

### `run_scene_edit_detection` (~190 tokens)

Run Scene Edit Detection

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

Input parameters:

- `clips` (object, required): The clips to analyse (items from list_clips, or selected: true)
- `operation` (string): cut: Apply a cut at each scene edit; marker: Generate clip markers; subclip: Create subclips in the project. Default cut
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `waitSeconds` (number): Wait up to this long for the analysis to finish. Default 0. Raise PREMIERE_SCRIPT_TIMEOUT_MS for long waits

### `get_sequence_properties` (~71 tokens)

Get Sequence Properties

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

Input parameters:

- `names` (array, required): Property names
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_sequence_properties` (~130 tokens)

Set Sequence Properties

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

Input parameters:

- `clear` (array): Names of properties to remove
- `persistent` (boolean): Save the values with the project (false keeps them for this session only). Default true
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `values` (object): Names and the values to store, e.g. { "review.status": "approved" }

### `list_tracks` (~68 tokens)

List Tracks

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

Input parameters:

- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `list_clips` (~159 tokens)

List Clips

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

Input parameters:

- `name` (string): Only clips whose name contains this text (any case), to find clips in the sequence
- `selected` (boolean): Only the clips selected in the Timeline
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `track` (string): Only this kind of track
- `trackIndex` (integer): Only this track (with track)

### `insert_clip` (~289 tokens)

Insert Clip

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)

Input parameters:

- `audioTrackIndex` (integer): Audio track for the audio, 0 = A1. Default 0
- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `limitShift` (boolean): Shift clips only on the targeted tracks, not on every track. Default false
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `sourceIn` (number): Place only part of the clip: set its source in point first, seconds into the media (give with sourceOut). The item keeps these in and out points, as when they are marked in the Source Monitor
- `sourceOut` (number): Source out point, seconds into the media (give with sourceIn)
- `time` (number, required): Sequence time in seconds
- `videoTrackIndex` (integer): Video track for the video, 0 = V1. Default 0

### `overwrite_clip` (~266 tokens)

Overwrite Clip

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)

Input parameters:

- `audioTrackIndex` (integer): Audio track for the audio, 0 = A1. Default 0
- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `sourceIn` (number): Place only part of the clip: set its source in point first, seconds into the media (give with sourceOut). The item keeps these in and out points, as when they are marked in the Source Monitor
- `sourceOut` (number): Source out point, seconds into the media (give with sourceIn)
- `time` (number, required): Sequence time in seconds
- `videoTrackIndex` (integer): Video track for the video, 0 = V1. Default 0

### `trim_clip` (~137 tokens)

Trim Clip

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

Input parameters:

- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `end` (number): End in the sequence, seconds
- `inPoint` (number): Source in point, seconds into the media
- `outPoint` (number): Source out point, seconds into the media
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `start` (number): Start in the sequence, seconds

### `move_clips` (~111 tokens)

Move Clips

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

Input parameters:

- `by` (number, required): Seconds to move by; negative moves earlier
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `remove_clips` (~114 tokens)

Remove Clips

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `ripple` (boolean): Close the gap: later clips move earlier. Default false
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_clip_properties` (~120 tokens)

Set Clip Properties

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `enabled` (boolean): false disables the clips (they stay in place but do not play)
- `name` (string): New clip name
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_track_properties` (~119 tokens)

Set Track Properties

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

Input parameters:

- `muted` (boolean)
- `name` (string): New track name (26.3 or later)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `track` (string, required)
- `trackIndex` (integer, required): 0 = V1, A1 or C1

### `insert_mogrt` (~141 tokens)

Insert Motion Graphics Template

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)

Input parameters:

- `audioTrackIndex` (integer): 0 = A1. Default 0
- `filePath` (string, required): Absolute path of the .mogrt
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `time` (number, required): Sequence time in seconds
- `videoTrackIndex` (integer): 0 = V1. Default 1 (V2)

### `select_clips` (~258 tokens)

Select Clips

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

Input parameters:

- `clips` (object): With mode clips: the clips to select (items from list_clips)
- `mode` (string, required): clips: the given clips; all; none; at_playhead; forward: clips ending after time; backward: clips starting before time; next and previous: the neighbour of each selected clip on its track
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `time` (number): With forward and backward: seconds. Default the playhead
- `track` (string): Only clips on this kind of track (give with trackIndex); default every video and audio track
- `trackIndex` (integer): Only this track, 0 = V1 or A1 (with track)

### `edit_clips` (~261 tokens)

Edit Clips

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)

Input parameters:

- `by` (number): slip, roll and slide: seconds; negative is earlier (slip: shows earlier frames)
- `clips` (object): Clips (items from list_clips, or selected: true). roll and slide take one clip. The trims default to every clip under the playhead
- `frames` (integer): Instead of by: frames of the sequence (Slip Clip Selection uses 1 or 5)
- `operation` (string, required)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `fit_clips_to_frame` (~211 tokens)

Fit Clips To Frame

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `mode` (string): fit: the whole frame shows (Set to Frame Size); fill: the sequence frame is covered, cropping the rest. Default fit
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `sourceHeight` (integer): Source frame height in pixels (give with sourceWidth)
- `sourceWidth` (integer): Source frame width in pixels, when the Video Info is missing (give with sourceHeight)

### `list_markers` (~101 tokens)

List Markers

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

Input parameters:

- `item` (object): Markers of this clip project item instead of a sequence
- `sequence` (object): Markers of this sequence (default: the active sequence)
- `type` (string): Only markers of this type

### `add_marker` (~136 tokens)

Add Marker

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

Input parameters:

- `color` (string)
- `comments` (string)
- `duration` (number): Seconds; 0 for a point marker. Default 0
- `item` (object): Markers of this clip project item instead of a sequence
- `name` (string)
- `sequence` (object): Markers of this sequence (default: the active sequence)
- `start` (number, required): Seconds
- `type` (string): Default Comment

### `edit_marker` (~158 tokens)

Edit Marker

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

Input parameters:

- `color` (string)
- `comments` (string)
- `duration` (number): Seconds
- `guid` (string): Marker guid (26.3 or later)
- `index` (integer): Marker index from list_markers
- `item` (object): Markers of this clip project item instead of a sequence
- `name` (string)
- `sequence` (object): Markers of this sequence (default: the active sequence)
- `start` (number): Move the marker here, seconds
- `type` (string)

### `remove_markers` (~129 tokens)

Remove Markers

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

Input parameters:

- `all` (boolean): Remove every marker (of type, if given)
- `guids` (array): Marker guids
- `indexes` (array): Marker indexes from list_markers
- `item` (object): Markers of this clip project item instead of a sequence
- `sequence` (object): Markers of this sequence (default: the active sequence)
- `type` (string): With all: only this type

### `mark_clips` (~165 tokens)

Mark Clips

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

Input parameters:

- `clips` (object): The clips to mark around (items from list_clips, or selected: true for Mark Selection). Default the clips under the playhead
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `track` (string): Only clips on this kind of track (give with trackIndex); default every video and audio track
- `trackIndex` (integer): Only this track, 0 = V1 or A1 (with track)

### `create_subclip` (~187 tokens)

Create Subclip

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

Input parameters:

- `audio` (boolean): Include the audio. Default true
- `end` (number, required): End, seconds into the media
- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `name` (string, required): Name of the subclip
- `restrictTrims` (boolean): Restrict Trims to Subclip Boundaries. Default false
- `start` (number, required): Start, seconds into the media
- `video` (boolean): Include the video. Default true

### `set_source_in_out` (~170 tokens)

Set Source In Out

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

Input parameters:

- `clear` (boolean): Clear both points (Clear In and Out)
- `inPoint` (number): In point, seconds into the media
- `item` (object): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `items` (array): Several clip project items instead of item
- `outPoint` (number): Out point, seconds into the media

### `scale_to_frame_size` (~121 tokens)

Scale To Frame Size

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

Input parameters:

- `item` (object): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `items` (array): Several clip project items instead of item

### `control_source_monitor` (~250 tokens)

Control Source Monitor

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

Input parameters:

- `action` (string, required)
- `clip` (object): With match_frame: the clip; default the clip under the playhead on the highest video track that has one, else on the first audio track that has one
- `item` (object): With open: the clip project item to open
- `position` (number): With open: show this time, seconds into the media (26.3 or later)
- `sequence` (object): With match_frame: the sequence (default the active one)
- `speed` (number): With play: playback speed, 1 = normal, negative plays backward, 0 stops. Default 1

### `list_available_effects` (~73 tokens)

List Available Effects

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

Input parameters:

- `filter` (string): Only names containing this text (case-insensitive)
- `kind` (string, required)

### `list_clip_effects` (~93 tokens)

List Clip Effects

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

Input parameters:

- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `apply_effect` (~172 tokens)

Apply Effect

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `effect` (string, required): Video: match name (e.g. "AE.ADBE Gaussian Blur 2") or display name; audio: display name
- `position` (integer): Insert at this component index instead of appending
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `remove_effect` (~104 tokens)

Remove Effect

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `component` (integer, required): Component index from list_clip_effects
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_effect_param` (~249 tokens)

Set Effect Param

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

Input parameters:

- `clearKeyframes` (boolean): Turn animation off first (removes the parameter's keyframes). Default false
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `component` (integer, required): Component index from list_clip_effects
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `value` (required): A number, text, true/false, a point { x, y }, or a colour { red, green, blue, alpha } with channels from 0 to 1

### `add_keyframes` (~158 tokens)

Add Keyframes

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

Input parameters:

- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `component` (integer, required): Component index from list_clip_effects
- `keyframes` (array, required)
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `remove_keyframes` (~191 tokens)

Remove Keyframes

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

Input parameters:

- `all` (boolean)
- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `component` (integer, required): Component index from list_clip_effects
- `from` (number): Range start, seconds (with to)
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `times` (array): Keyframe times, seconds
- `to` (number): Range end, seconds (with from)

### `add_transition` (~191 tokens)

Add Transition

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

Input parameters:

- `at` (string): Default end
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `duration` (number): Seconds. Default 1
- `replace` (boolean): Remove the transition already at that end first (Replace transition); there must be one. Default false
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `singleSided` (boolean): Keep the transition on this clip only. Default false
- `transition` (string, required): Transition match name

### `remove_transition` (~98 tokens)

Remove Transition

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

Input parameters:

- `at` (string): Default both
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_clip_transform` (~266 tokens)

Set Clip Transform

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

Input parameters:

- `blendMode` (string): Blend Mode, by its name in the Opacity menu
- `blendModeIndex` (integer): Blend Mode as the index Premiere Pro stores, instead of blendMode
- `clearKeyframes` (boolean): Turn animation off for the settings given (removes their keyframes). Default false
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `motion` (object): Motion settings (Vector Motion with vectorMotion: true)
- `opacity` (number): Opacity, percent
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `vectorMotion` (boolean): Set the Vector Motion effect of graphics clips instead of Motion. Default false

### `copy_clip_effects` (~246 tokens)

Copy Clip Effects

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

Input parameters:

- `components` (array): Only these component indexes of the source (from list_clip_effects). Default: every applied effect, plus the fixed ones with intrinsic
- `from` (object, required): The clip to copy from, as list_clips reports it
- `intrinsic` (boolean): Also copy the fixed effects' values when components is not given. Default false
- `keyframes` (boolean): Copy keyframes of animated parameters (otherwise their value at the clip start). Default true
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `to` (object, required): The clips to paste onto

### `manage_source_effects` (~166 tokens)

Manage Source Effects

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

Input parameters:

- `action` (string): Default list
- `component` (integer): For remove: component index from the list
- `effect` (string): For apply: video effect match name or display name (from list_available_effects)
- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `media` (string): Which chain to list or remove from. Default video

### `jump_to_keyframe` (~183 tokens)

Jump To Keyframe

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

Input parameters:

- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `component` (integer, required): Component index from list_clip_effects
- `direction` (string, required)
- `from` (number): Sequence time to search from, seconds. Default: the playhead
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `copy_keyframes` (~263 tokens)

Copy Keyframes

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

Input parameters:

- `clip` (object, required): The clip to copy from
- `component` (integer, required): Component index from list_clip_effects
- `offset` (number): Shift the pasted keyframes by this many seconds. Default 0
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `replace` (boolean): Remove the target parameter's own keyframes first. Default false
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `to` (object): The clips to paste onto. Default: the source clip
- `toComponent` (integer): Target component index. Default: the source's
- `toParam` (string): Target parameter name. Default: the source's
- `toParamIndex` (integer): Target parameter index instead of a name

### `retime_keyframes` (~230 tokens)

Retime Keyframes

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

Input parameters:

- `anchor` (string): The keyframe that stays put when scaling. Default first
- `clip` (object, required): A clip in the sequence, as list_clips reports it
- `component` (integer, required): Component index from list_clip_effects
- `offset` (number): Then move every keyframe by this many seconds. Default 0
- `param` (string): Parameter name as list_clip_effects reports it, e.g. "Scale"
- `paramIndex` (integer): Parameter index instead of a name
- `scale` (number): Spacing factor: 2 makes the animation take twice as long, 0.5 half as long. Default 1
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `fade_clips` (~165 tokens)

Fade Clips

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `fadeIn` (number): Fade-in length, seconds
- `fadeOut` (number): Fade-out length, seconds
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `set_lumetri_color` (~460 tokens)

Set Lumetri Color

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

Input parameters:

- `add` (boolean): Add a Lumetri Color effect to clips without one. Default true
- `basic` (object): Basic Correction: settings by display name, e.g. Input LUT, HDR White, Temperature, Tint, Saturation, Exposure, Contrast, Highlights, Shadows, Whites, Blacks
- `byIndex` (array): Lumetri parameters by index (from list_clip_effects), for any setting the sections do not name
- `clearKeyframes` (boolean): Turn animation off for animated settings given (removes their keyframes). Default false
- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `component` (integer): Index of the Lumetri Color effect to set (from list_clip_effects). Default: the clip's first Lumetri Color
- `creative` (object): Creative: settings by display name, e.g. Look, Intensity, Faded Film, Sharpen, Vibrance, Saturation, Shadow Tint, Highlight Tint, Tint Balance
- `hsl` (object): HSL Secondary: settings by display name, e.g. Denoise, Blur, Temperature, Tint, Contrast, Sharpen, Saturation
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `vignette` (object): Vignette: settings by display name, e.g. Amount, Midpoint, Roundness, Feather
- `wheels` (object): Color Wheels & Match: settings by display name, e.g. the shadow, midtone and highlight wheels and their lightness

### `set_clip_input_lut` (~144 tokens)

Set Clip Input LUT

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

Input parameters:

- `embedded` (boolean): With fromItem, use the LUT embedded in its media rather than its override. Default false
- `fromItem` (object): Use the Input LUT this clip has instead of lutId
- `items` (array, required): Video clip project items
- `lutId` (string): The LUT id (a guid, as these results report it)

### `set_clip_volume` (~135 tokens)

Set Clip Volume

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `level` (number, required): The Level parameter's value (linear amplitude)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `adjust_clip_audio` (~211 tokens)

Adjust Clip Audio

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

Input parameters:

- `clips` (object, required): Which clips: items (track, trackIndex, clipIndex from list_clips) and/or selected: true for the clips selected in the Timeline
- `gainDb` (number): Raise (positive) or lower (negative) the Volume Level by this many dB
- `pan` (number): Panner Balance (stereo clips) or Pan (mono): -100 full left, 0 centre, 100 full right, as Effect Controls shows it
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `list_graphics_templates` (~98 tokens)

List Graphics Templates

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

Input parameters:

- `filter` (string): Only templates whose name contains this text (case-insensitive)
- `limit` (integer): At most this many. Default 500

### `insert_library_mogrt` (~174 tokens)

Insert Library Motion Graphics Template

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)

Input parameters:

- `audioTrackIndex` (integer): 0 = A1. Default 0
- `element` (string, required): The template's name in that library
- `library` (string, required): Library name, as the Libraries panel shows it
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `time` (number, required): Sequence time in seconds
- `videoTrackIndex` (integer): 0 = V1. Default 1 (V2)

### `list_transcription_languages` (~102 tokens)

List Transcription Languages

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

Input parameters:

- `languages` (array): Only check these language codes, e.g. ["en-US", "fr-FR"] (works before 26.3 too)

### `import_captions` (~129 tokens)

Import Captions

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

Input parameters:

- `bin` (object): Import into this bin. Default: the project root
- `files` (array, required): Absolute paths of caption files

### `transcribe_clip` (~97 tokens)

Transcribe Clip

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

Input parameters:

- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique

### `export_transcript` (~107 tokens)

Export Transcript

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

Input parameters:

- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `outputFile` (string): Absolute path of a .json file to write instead of returning the transcript

### `export_sequence` (~365 tokens)

Export Sequence

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

Input parameters:

- `importBin` (object): With importIntoProject: the bin to import into. Default: the project root
- `importIntoProject` (boolean): With mode immediately: import the exported file into the project (Import into Project). Default false
- `mode` (string): Default immediately
- `outputFile` (string, required): Absolute path of the file to write
- `overwrite` (boolean): Replace outputFile if it exists. Default false
- `preset` (string, required): Absolute path of an encoder preset (.epr), e.g. one saved from the Export page or Media Encoder
- `range` (string): Default full
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `startQueue` (boolean): With queue_to_ame: start Media Encoder's queue (Premiere Pro 26.3 or later). Default false
- `xmp` (string): Write XMP metadata into the file, beside it, both or neither (26.3 or later). Default: Premiere Pro's setting

### `encode_media` (~311 tokens)

Encode Media

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

Input parameters:

- `file` (string): Absolute path of a media file to encode without importing it. Give item or file
- `inPoint` (number): With file: start at this time, seconds. Default the start
- `item` (object): The clip or sequence project item to encode. Give item or file
- `outPoint` (number): With file: stop at this time, seconds. Default the end
- `outputFile` (string, required): Absolute path of the file to write, with its extension
- `overwrite` (boolean): Replace outputFile if it exists. Default false
- `preset` (string, required): Absolute path of an encoder preset (.epr)
- `range` (string): With item: the whole item, its in to out, or the work area (sequences only). Default full
- `removeWhenDone` (boolean): Remove the job from Media Encoder's queue when it finishes. Default false
- `startQueue` (boolean): Start Media Encoder's queue straight away. Default false

### `export_frame` (~133 tokens)

Export Frame

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

Input parameters:

- `height` (integer)
- `outputFile` (string, required): Absolute path; the extension picks the format
- `overwrite` (boolean)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence
- `time` (number): Sequence time in seconds. Default: the playhead
- `width` (integer)

### `export_timeline` (~114 tokens)

Export Timeline

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

Input parameters:

- `format` (string, required)
- `outputFile` (string, required): Absolute path with the format's extension
- `overwrite` (boolean)
- `sequence` (object): Which sequence. Give its name or guid (from list_sequences); omit for the active sequence

### `get_metadata` (~86 tokens)

Get Metadata

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

Input parameters:

- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `kind` (string): Default both

### `set_metadata` (~131 tokens)

Set Metadata

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

Input parameters:

- `fields` (array): With projectMetadata: the field names that changed
- `item` (object, required): A project item: its id (from list_project_items), its bin path such as "Footage/Interviews/a.mov", or its name when that is unique
- `projectMetadata` (string): Project metadata XML
- `xmp` (string): The full XMP packet to store

### `get_metadata_display` (~41 tokens)

Get Metadata Display

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

### `set_metadata_display` (~83 tokens)

Set Metadata Display

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

Input parameters:

- `addFields` (array): Fields to add to the project metadata schema
- `panelMetadata` (string): The column layout XML to apply

### `wait_for_event` (~141 tokens)

Wait For Event

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

Input parameters:

- `event` (string, required): The event to wait for
- `sequence` (object): Sequence events: listen on this sequence. Default: any sequence
- `timeout` (number): Give up after this many seconds. Default 60

### `clear_media_cache` (~64 tokens)

Clear Media Cache

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

### `recover_project` (~185 tokens)

Recover Project

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

Input parameters:

- `folder` (string): Absolute path of the Auto-Save folder, when it is not the project's
- `limit` (integer): List at most this many copies. Default 20
- `open` (boolean): Open a copy: the newest, or openFile. Default false
- `openFile` (string): With open: the copy to open, from the list
- `project` (string): Absolute path of the project (.prproj) to recover. Default: the active project

### `premiere_status` (~74 tokens)

Premiere Status

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

Input parameters:

- `probe` (boolean): Also ask Premiere Pro for the active project and sequence. Default true

### `execute_premiere_code` (~126 tokens)

Execute Premiere Code

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

Input parameters:

- `code` (string, required): Async function body, e.g. const p = await ppro.Project.getActiveProject(); return p.name;

### `help` (~30 tokens)

Help

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

Input parameters:

- `tool` (string): A tool name

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere#diagnostics

## Score history

- 2026-10-23: 69
- 2026-10-22: 69
- 2026-10-21: 69
- 2026-10-20: 54

## Common questions

### What is the Premiere Pro MCP Server server?

Premiere Pro MCP Server is listed in the public MCP registry as io.github.zachshallbetter/adobe-mcp-premiere. Drive Adobe Premiere Pro from any MCP client: projects, sequences, timeline edits, effects, export. This page covers its npm package (adobe-mcp-premiere).

### Is the Premiere Pro MCP Server server safe to use?

Premiere Pro MCP Server scores 69 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 23 October 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Premiere Pro MCP Server server expose?

Premiere Pro MCP Server exposes 96 tools: get_project_info, create_project, open_project, save_project, close_project, and 91 more. Their descriptions and schemas cost roughly 14,153 tokens of context every time the server is loaded.

### Is the Premiere Pro MCP Server server still maintained?

Premiere Pro MCP Server is still listed as active in the MCP registry. We last reached this channel on 23 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Premiere Pro MCP Server server under?

Premiere Pro MCP Server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/adobe-mcp-premiere
- Socket report: https://socket.dev/npm/package/adobe-mcp-premiere
- Repository: https://github.com/zachshallbetter/adobe-mcp
- Changelog RSS feed: https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere.xml
- Changelog JSON feed: https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere.json
- HTML version of this page: https://verifymcp.io/servers/zachshallbetter-adobe-mcp-premiere/adobe-mcp-premiere