PremierPro MCP Server -- AI-Powered Video Editing for Adobe Premiere Pro
The open-source MCP server for Adobe Premiere Pro. Control every aspect of video editing -- timeline, color grading, audio mixing, effects, graphics, and export -- through natural language using Claude, GPT, or any AI assistant that supports the Model Context Protocol.
Give it a script and your footage. It handles the rest.
"Edit this 5-minute video using script.pdf with the footage in /media/"
The server parses your script, scans your media library, generates an edit decision list, and assembles the timeline in Premiere Pro -- all from a single prompt.
Why This Exists
Video editors spend hours on repetitive tasks: syncing clips, rough cuts, color matching, audio leveling, exporting variants. This MCP server turns Adobe Premiere Pro into an AI-controllable tool, so you can describe edits in plain English and let your AI assistant execute them.
No plugins. No subscriptions. Fully open source.
Features -- 1,060 MCP Tools
This is the most comprehensive MCP server for any NLE (non-linear editor). Every tool maps to real Adobe Premiere Pro ExtendScript and QE DOM operations.
| Category | Tools | What You Can Do |
|---|---|---|
| Core/Foundation | 14 | Ping, get project state, create sequences, import media, place clips, export |
| App Lifecycle | 3 | Launch, quit, and check Premiere Pro process status |
| Project Management | 23 | Create, open, save, close projects; manage bins, scratch disks, metadata |
| Sequence Management | 26 | Create, duplicate, delete sequences; playhead, in/out points, markers, nesting |
| Clip Operations | 29 | Insert, overwrite, move, trim, split, slip, slide, speed, link/unlink clips |
| Effects & Transitions | 36 | Apply/remove effects and transitions, keyframe animation, motion, Lumetri basics |
| Audio (basic) | 32 | Levels, gain, mute/solo, effects, Essential Sound, track management |
| Audio (advanced) | 30 | Mixer state, EQ, compressor, limiter, de-esser, loudness, sync, waveform analysis |
| Color Grading | 30 | Full Lumetri Color: exposure, contrast, curves, HSL, color wheels, LUTs, vignette |
| Graphics & Titles | 21 | MOGRTs, titles, lower thirds, captions, color mattes, time remapping |
| Export (basic) | 14 | Direct export, AME queue, frame export, AAF/OMF/FCPXML, audio-only export |
| Advanced Editing | 31 | Ripple/roll/slip/slide trims, gap management, grouping, snapping, navigation |
| Batch Operations | 30 | Batch import/export, apply effects to multiple clips, auto-organize, markers |
| AI/ML Workflows | 25 | Smart cut, auto color match, rough cut, B-roll suggestions, social cuts, analysis |
| Workspace & Multicam | 25 | Multicam, proxy management, workspaces, undo/redo, source monitor, cache |
| Playback & Navigation | 30 | Play/pause/stop, shuttle, step, loop, timecode navigation, render status |
| Transform & Masking | 30 | Crop, PIP, fade, stabilizer, noise reduction, blur, sharpen, distortion |
| Metadata & Labels | 30 | XMP metadata, labels, footage interpretation, smart bins, media management |
| Preferences | 30 | Still/transition durations, auto-save, playback resolution, cache, renderer, codecs |
| Templates & Presets | 30 | Sequence/effect/export presets, project templates, batch rename, macros |
| Motion Graphics | 30 | Essential Graphics, scrolling titles, shapes, watermarks, split screen, subtitles |
| Collaboration & Review | 30 | Review comments, version history, snapshots, EDL/AAF/XML import, delivery checks |
| VR/Immersive | 30 | VR projection, HDR, stereoscopic 3D, frame rates, letterboxing, timecode, captions |
| App Integration | 28 | Dynamic Link (AE), Photoshop, Audition, Media Encoder, Team Projects |
| Diagnostics | 30 | Performance metrics, disk space, plugins, render status, health checks, debug logs |
| Monitoring & Events | 30 | Event listeners, playhead/render watchers, state snapshots, notifications |
| UI Control | 30 | Panel management, window control, track display, label filters, dialogs, console |
| Compound Operations | 30 | Montage, slideshow, highlight reel, music bed, social exports, project setup |
| Encoding & Formats | 30 | Codec conversion (ProRes, H.264/265, DNxHR, GIF), thumbnails, render queue |
| Timeline Assembly | 30 | EDL/CSV assembly, clip sorting/shuffling, compositing, generators, timeline reports |
| Scripting | 30 | ExtendScript execution, global variables, conditionals, scheduling, file I/O |
| Analytics | 30 | Project/sequence summaries, codec/resolution breakdowns, pacing, comparison reports |
| Effect Chains | 30 | Effect chain management, visual presets (sepia, vintage, glow), transition control |
Total: 907 tools across 33 source files. View the full feature plan.
Supported Premiere Pro Versions
| Version | Year | Support |
|---|---|---|
| 14.x | 2020 | Community tested |
| 15.x | 2021 | Community tested |
| 22.x | 2022 | Community tested |
| 23.x | 2023 | Supported |
| 24.x | 2024 | Supported |
| 25.x | 2025 | Primary target |
| 26.x | 2026 | Beta support |
Works on macOS and Windows. The bridge uses Adobe's CEP (Common Extensibility Platform) and ExtendScript, which are supported across all modern Premiere Pro versions.
Help us expand compatibility -- report your setup.
Architecture
Four languages, each playing to their strengths:
CLI / MCP Client (Claude, GPT, any AI)
| stdio / JSON-RPC
v
+-------------------------------------+
| Go -- MCP Server & Orchestrator |
| Protocol handling . Concurrency |
| Service mesh . Health & recovery |
+------+------------+------------+-----+
| gRPC | gRPC | gRPC
v v v
+------------+ +----------+ +----------------+
| Rust | | Python | | TypeScript |
| Media | | Intel | | Premiere Pro |
| Engine | | Layer | | Bridge |
+------------+ +----------+ +-------+--------+
| CEP / ExtendScript
v
Adobe Premiere Pro
| Language | Role | Why |
|---|---|---|
| Go | MCP server, orchestration | Goroutines for concurrency, fast startup, low memory |
| Rust | Media processing | Raw performance for scanning, indexing, waveform analysis |
| Python | AI & NLP | Script parsing, edit decisions, shot matching via embeddings |
| TypeScript | Premiere Pro bridge | Native access to Adobe's ExtendScript/CEP DOM |
Full architecture diagram: docs/architecture.md
Project Structure
PremierProMCP/
+-- go-orchestrator/ # Go -- MCP server & task orchestrator
| +-- cmd/server/ # Entry point
| +-- internal/ # Core packages
| | +-- mcp/ # MCP protocol handler (1,060 tool definitions)
| | +-- orchestrator/ # Task orchestration
| | +-- health/ # Health checks
| | +-- grpc/ # gRPC client/server
| +-- configs/ # Configuration files
|
+-- rust-engine/ # Rust -- Media processing engine
| +-- src/
| +-- media/ # Media probe & metadata
| +-- assets/ # Asset indexing & fingerprinting
| +-- waveform/ # Waveform & silence detection
| +-- thumbnails/ # Thumbnail generation
|
+-- python-intelligence/ # Python -- AI intelligence layer
| +-- src/
| | +-- parser/ # Script parsing & NLP
| | +-- edl/ # Edit Decision List generation
| | +-- matching/ # Shot-to-asset matching
| | +-- analysis/ # Pacing & timing analysis
| +-- tests/
| +-- models/ # ML model configs
|
+-- ts-bridge/ # TypeScript -- Premiere Pro bridge
| +-- src/
| +-- extendscript/ # ExtendScript API layer
| +-- cep/ # CEP Panel bridge (primary)
| +-- standalone/ # Node.js fallback bridge
| +-- timeline/ # Timeline operations
|
+-- cep-panel/ # CEP Panel -- Premiere Pro extension
| +-- src/
| +-- assets/
| +-- CSXS/ # Adobe extension manifest
|
+-- proto/ # Shared protobuf definitions
+-- docs/ # Documentation
+-- scripts/ # Build & setup scripts
+-- Justfile # Unified build system
+-- .env.example # Environment template
Prerequisites
- Go 1.22+
- Rust 1.77+
- Python 3.12+
- Node.js 20+
- just (command runner)
- buf (protobuf toolchain)
- FFmpeg (media processing)
- Adobe Premiere Pro (2020 or later)
Quick Start
# Clone the repository
git clone https://github.com/ayushozha/AdobePremiereProMCP.git
cd PremierProMCP
# Copy env template
cp .env.example .env
# Install dependencies
just install
# Generate protobuf stubs
just proto
# Build all components
just build
# Run tests
just test
# Install the CEP panel into Premiere Pro
just install-panel
Usage
As an MCP Server (Claude Code, Claude Desktop, Cursor, etc.)
Add to your MCP client configuration:
{
"mcpServers": {
"premiere-pro": {
"command": "./go-orchestrator/bin/server",
"args": ["--transport", "stdio"]
}
}
}
Via CLI
# Start the server
just go-run
# Or run directly
./go-orchestrator/bin/server --transport stdio
One-Click Launchers
Platform-specific launchers are included for quick setup:
- macOS:
./PremierPro.command - Windows:
PremierPro.bat - Linux/Universal:
./PremierPro.sh
How It Works
- You send a prompt -- "Edit this video using the script with footage from /media/"
- Go orchestrator receives the MCP tool call and fans out:
- Rust engine scans
/media/, indexes all assets (codec, duration, resolution, waveforms) - Python intelligence parses the script, generates an Edit Decision List, matches shots to assets
- Rust engine scans
- Go merges results and sends the EDL to the TypeScript bridge
- TypeScript bridge executes in Premiere Pro -- creates sequence, places clips, adds transitions, text
- Premiere Pro renders the final output
Build Commands
| Command | Description |
|---|---|
just build | Build all components |
just test | Run all test suites |
just lint | Lint all code |
just ci | Full CI pipeline (lint + build + test) |
just proto | Generate protobuf stubs |
just clean | Remove all build artifacts |
just go-build | Build Go orchestrator only |
just rust-build | Build Rust engine only |
just py-test | Run Python tests only |
just ts-build | Build TypeScript bridge only |
just cep-build | Build CEP panel only |
just install-panel | Install CEP panel into Premiere Pro |
just start | Start all backend services |
just stop | Stop all backend services |
just status | Check service status |
Use Cases
- Automated rough cuts -- Parse a script and assemble a timeline from raw footage
- Batch color grading -- Apply Lumetri Color adjustments across clips via natural language
- Audio post-production -- Set levels, apply effects, and mix tracks through AI prompts
- Template-based editing -- Generate videos from MOGRTs and data using AI
- Multi-format export -- Queue multiple export presets from a single command
- Review workflows -- Add markers, comments, and metadata programmatically
- AI-assisted editing -- Let Claude or GPT analyze your footage and suggest edits
Community
We are actively looking for testers and contributors!
- Test the server with your Premiere Pro setup and report results
- Request features you need for your workflow in the feature tracker
- Report bugs with reproduction steps in the bug tracker
- Confirm your Premiere Pro version works in the compatibility tracker
- Start or join a discussion in GitHub Discussions
- Read the Contributing Guide to get started with development
If this project is useful to you, please star the repository to help others find it.
Related
- Model Context Protocol -- The open protocol for AI tool use
- Adobe Premiere Pro Scripting Guide -- ExtendScript API reference
- Adobe CEP Resources -- CEP panel development
License
MIT