Cavi Premiere MCP
You call the shots.
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.
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:
- Overview, installation and quickstart
- Guides: Bridge relay setup, a first edit, cutting from a clip list, export and encode and troubleshooting
- Reference: tools, results and errors, configuration and Premiere Pro behavior
- Security model and version and support
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.