Skip to main content

Cavi Premiere MCP

An illustrated penguin editor arranging film of a coastal journey

You call the shots.

License: MIT PyPI weekly downloads

Give your editing partner the footage and the direction. Cavi Premiere MCP works in a native Premiere Pro project: organize clips, shape sequences, review still frames and export a ProRes master. The project stays editable in Premiere.

Bring your own footage and licensed Adobe applications. The server connects to Premiere Pro through an Adobe Bridge relay.

Install

Requires macOS, Premiere Pro 2026 or later, Adobe Bridge 2026 or later (the script relay), FFmpeg (ffprobe) and Python 3.15 or later with uv. You supply your own licensed Adobe applications.

uv tool install cavi-premiere-mcp

Upgrade with uv tool upgrade cavi-premiere-mcp. To work from a checkout instead, see CONTRIBUTING.md.

Install the relay script into Bridge and approve it once in Bridge Settings > Startup Scripts; the steps are in Set up the Bridge relay.

Quickstart

Register the stdio server with your MCP client:

{"mcpServers": {"premiere": {"command": "cavi-premiere-mcp"}}}

If your client does not inherit your shell's PATH, use the absolute path that command -v cavi-premiere-mcp prints. Install and approve the relay using the Bridge setup guide, then try a request like:

Cut these three shots to the music, add dissolves, show me stills from the sequence and export a ProRes master.

The quickstart walks through a first edit. See the example cut for the source media and result.

Try one cut

This example cuts three shots and a score into a Premiere project with dissolves and a ProRes master.

Four frames from the example cut

Explore the example and source media.

What you can do

Work In Premiere Pro
Organize Import media, arrange bins and find clips.
Edit Create sequences, place and trim clips, and work with tracks.
Refine Add transitions, adjust color and animate clip properties.
Review Inspect the project and export still frames.
Deliver Export a sequence or queue it in Media Encoder.

See the tool reference for the full set of operations and parameters.

Tool inventory
Tool What it does
premiere_status Installed Premiere Pro, Adobe Bridge and Media Encoder, relay state and mailbox.
premiere_bridge_install Copies the relay startup script into Adobe Bridge.
premiere_script Runs a .jsx file in Premiere Pro.
premiere_cut Cuts a clip list into a new project and exports a ProRes 422 HQ master.
premiere_project Opens, creates, saves or closes a project.
premiere_inspect Bins, project items, sequences, tracks, clips, transitions and markers.
premiere_transitions Lists the video and audio transitions Premiere offers.
premiere_presets Lists export and sequence presets.
premiere_effects Lists the video and audio effects Premiere offers.
premiere_find Finds project items and placed clips by name or path.
premiere_import Imports files into a bin.
premiere_items Renames, moves, labels, subclips, interprets, proxies or deletes a project item.
premiere_bins Creates, renames, deletes bins and moves items into them.
premiere_media_replace Points a project item at a new file or refreshes it.
premiere_sequence_new Creates an empty sequence.
premiere_sequence_set Changes settings, in/out points, nests, duplicates, renames or deletes a sequence.
premiere_tracks Adds tracks and sets mute, lock and target state.
premiere_clip_place Places a project item on a track.
premiere_clip_edit Trims, moves, enables, renames, links or removes a placed clip.
premiere_clip_copy Places another copy of a clip.
premiere_clip_slip Shows a different part of a clip's source in the same place.
premiere_clip_speed Sets a clip's speed or the duration it fills.
premiere_clip_fit Scales a clip to fit or fill the frame.
premiere_clip_props Sets Motion, Opacity and Volume, static or keyframed.
premiere_fade Fades a clip in and out.
premiere_color Basic Lumetri Color correction.
premiere_effect_add Adds an effect to a clip.
premiere_effect_set Sets or lists component parameters.
premiere_transition_add Adds a transition to a clip edge.
premiere_razor Splits clips at times.
premiere_gaps Lists or closes empty gaps.
premiere_range_remove Cuts a time range out of every unlocked track.
premiere_scene_detect Finds hard cuts in a clip's media and optionally splits or marks them.
premiere_markers_add Adds sequence markers or a beat grid.
premiere_markers_edit Lists, updates or deletes sequence markers.
premiere_mogrt_add Places a Motion Graphics template and sets its text.
premiere_captions Imports an .srt as a caption track.
premiere_auto_reframe Makes a new sequence at another aspect ratio.
premiere_frame_export Exports PNG stills of a sequence.
premiere_export Exports a sequence with a preset.
premiere_encode Queues a sequence in Media Encoder.
premiere_interchange Exports FCP XML, AAF or OMF, or imports an FCP XML.

Documentation

The documentation source is in docs/premiere-mcp/source:

Configuration

Variable Meaning
CAVI_PREMIERE_APP The Premiere Pro .app to use.
CAVI_BRIDGE_APP The Adobe Bridge .app to use.
CAVI_MEDIA_ENCODER_APP The Media Encoder .app to use.

Without an override the newest installed version under /Applications is used. An override that names another application is refused.

Security

The server speaks MCP over stdio, sends no telemetry and uses no accounts. premiere_script runs a caller-chosen .jsx file in Premiere Pro, and any local process that can write the relay mailbox can run ExtendScript in Adobe applications. See the security model and SECURITY.md.

Contributing

See CONTRIBUTING.md for setup, checks and the rules for changes. This project follows the Code of Conduct.

License

MIT. See LICENSE.

Trademarks

Adobe, Premiere Pro, After Effects, Adobe Bridge and Media Encoder are either registered trademarks or trademarks of Adobe in the United States and/or other countries. This project is not affiliated with, endorsed by, or sponsored by Adobe. It does not include or redistribute Adobe software, templates or presets; you supply your own licensed applications.

Metadata

Release files for cavi-premiere-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cavi-premiere-mcp 0.1.1
File Size Uploaded Provenance Actions
cavi_premiere_mcp-0.1.1.tar.gz 67.4 kB With provenance Details for cavi_premiere_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cavi-premiere-mcp 0.1.1
File Interpreter ABI Platform Actions
cavi_premiere_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for cavi_premiere_mcp-0.1.1-py3-none-any.whl

Total release size: 137.8 kB

Release files / cavi_premiere_mcp-0.1.1.tar.gz

Download URL cavi_premiere_mcp-0.1.1.tar.gz
Size 67.4 kB
Tags Source
SHA-256 checksum
How to use checksums
288b09f46e8e816e8f0cc8ea840c05c8a9de651d71a62577d54d7c2a4f51b2c1
BLAKE2b-256 checksum
How to use checksums
462459ceb8944e87ad472c12d69e5001d6490135f88f189d3e9c39dcc2704937
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / cavi_premiere_mcp-0.1.1-py3-none-any.whl

Download URL cavi_premiere_mcp-0.1.1-py3-none-any.whl
Size 70.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bb7b784ffca2825050074741911d82ed1721049fdf36d9893f716e8d53f21820
BLAKE2b-256 checksum
How to use checksums
8b7a59b7b413b55273767d7f31e93dfea9a187ece46ca05bccc3e82f2a65a494
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for cavi-premiere-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cavi_premiere_mcp-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page