Adobe Premiere Pro MCP server

This Adobe Premiere Pro MCP server acts as an AI-powered automation bridge for Adobe Premiere Pro, allowing you to control your editing process using natural language through Claude or other AI agents. It leverages the Model Context Protocol (MCP) to enable voice control, task automation, and context-aware workflows in your editing process.

Installation Guide

Prerequisites

Before installing the MCP server, ensure you have:

• Adobe Premiere Pro installed (version 24.4+ recommended for UXP support)
• Node.js installed on your system
• Git installed for cloning the repository

Setup Instructions

1. Clone the repository and install dependencies:

git clone https://github.com/hetpatel-11/Adobe_Premiere_Pro_MCP
cd MCP_Adobe_Premiere_Pro
npm install

2. Build and start the MCP server:

npm run build
npm start

3. Install the CEP Extension in Premiere Pro:

   • Copy the PremiereRemote extension folder to your Adobe CEP extensions directory:

     • macOS: ~/Library/Application Support/Adobe/CEP/extensions/
     • Windows: %APPDATA%/Adobe/CEP/extensions/

   • Enable loading of unsigned extensions:

     • On macOS: Edit ~/Library/Preferences/com.adobe.CSXS.9.plist and set PlayerDebugMode to 1.
     • On Windows: Use regedit to set PlayerDebugMode to 1 under HKEY_CURRENT_USER/Software/Adobe/CSXS.9.

   • Restart Adobe Premiere Pro

   • Open the extension by navigating to Window > Extensions (Legacy) > PremiereRemote

   • The panel should display "Ready!" if the bridge is running correctly

UXP DevTools Alternative (Experimental)

You can also use this project as a UXP panel in Premiere Pro (24.4+):

1. Open Adobe UXP DevTools
2. Click "Add Plugin" and select the uxp-plugin/ folder
3. Start the panel in DevTools and open it in Premiere Pro via Window > Plugins > MCP Bridge (UXP)

Note that UXP scripting in Premiere Pro is experimental and limited. Some features like timeline and sequence editing may not be available yet. For full automation capabilities, use the CEP (legacy) panel.

Connecting with AI Agents

After setting up the MCP server and Premiere Pro extension:

1. Configure Claude (or another AI agent) to use the MCP server as a tool endpoint
2. Ask Claude to perform editing tasks using the supported features

Supported Features

Project Management

• Create new Premiere Pro projects
• Open existing project files
• Save current projects
• Save projects with new names/locations

Media Management

• Import media files (video, audio, image)
• Import all media files from a folder
• Create new bins (folders) in the project panel

Sequence Management

• Create new sequences (timelines)
• Duplicate existing sequences
• Delete sequences

Timeline Operations

• Add media clips to sequence timelines
• Remove clips from timelines
• Move clips to different positions
• Trim clips by adjusting in/out points
• Split clips at specific time points

Effects & Transitions

• Apply visual or audio effects to clips
• Remove effects from clips
• Add transitions between clips
• Add transitions to the start or end of clips

Audio Operations

• Adjust the volume of audio clips
• Add keyframes to audio levels
• Mute or unmute entire audio tracks

Color Correction

• Apply basic color correction adjustments
• Apply Look-Up Tables (LUTs) to clips

Export & Rendering

• Render and export sequences to video files
• Export single frames as images

Advanced Features

• Create multicamera sequences from multiple video clips
• Generate proxy versions of media
• Automatically edit video to music beats
• Apply video stabilization
• Change playback speed of clips

Project/Media/Sequence Discovery

• List all media items, bins, and assets in the project
• List all sequences in the project
• List all tracks in a sequence
• Get comprehensive project information

Limitations

The following features are not supported due to Adobe scripting limitations:

• Text overlays (legacy titles) - deprecated/broken in modern Premiere Pro scripting
• Shape/graphics overlays - not supported by Premiere scripting
• Essential Graphics (MOGRTs) - not scriptable
• Direct pixel manipulation - not possible

Additionally, be aware of these known issues:

• Some scripting APIs are buggy or version-dependent
• CEP extensions are deprecated in the latest Adobe apps (but still work for now)
• UXP scripting is experimental and has limited functionality in Premiere Pro
• Error handling is robust, but some failures may be silent due to Premiere scripting quirks

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "adobe-premiere-pro" '{"command":"npm","args":["start"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "adobe-premiere-pro": {
            "command": "npm",
            "args": [
                "start"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "adobe-premiere-pro": {
            "command": "npm",
            "args": [
                "start"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect