AdobePremiereProMCP

PremierPro MCP Server -- AI-Powered Video Editing for Adobe Premiere Pro

[](https://opensource.org/licenses/MIT) [](https://github.com/ayushozha/AdobePremiereProMCP/pulls) [](https://www.adobe.com/products/premiere.html) [](https://modelcontextprotocol.io) [](https://github.com/ayushozha/AdobePremiereProMCP/stargazers)

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](docs/feature-plan.md).

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](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

1. You send a prompt -- "Edit this video using the script with footage from /media/"
2. 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

1. Go merges results and sends the EDL to the TypeScript bridge
2. TypeScript bridge executes in Premiere Pro -- creates sequence, places clips, adds transitions, text
3. 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](CONTRIBUTING.md) 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ayushozha
• Source: ayushozha/AdobePremiereProMCP
• License: MIT
• Homepage: https://ayushozha.github.io/AdobePremiereProMCP

Install and usage instructions live in the source repository linked above.