/premiere-pro-mcp

name: premiere-pro-mcp
description: Install, verify, troubleshoot, and operate the Adobe Premiere Pro MCP server. Use when a user wants an agent to set up Premiere MCP, connect Claude Code/Codex/Claude Desktop, control Premiere, import media, build sequences, edit timelines, apply effects, or diagnose bridge issues.

Adobe Premiere Pro MCP

Use this skill when working with the Adobe Premiere Pro MCP server from `hetpatel-11/Adobe_Premiere_Pro_MCP`.

Core Rules

• Use the MCP tools for Premiere operations; do not invent ExtendScript unless the MCP tool surface is missing the needed operation.
• Prefer read-only discovery first: `get_project_info`, `list_sequences`, `list_project_items`, `get_active_sequence`, and relevant resource reads.
• Use real imported media. If the user asks to edit with assets, verify file paths exist, import them with `import_media`, then place the imported project item IDs on a sequence.
• Keep the temp directory consistent across the MCP server and CEP panel: `/tmp/premiere-mcp-bridge` unless the user explicitly configured another path.
• Ask before destructive or externally visible actions: deleting clips/media, overwriting exports, closing projects, saving over important project files, or sending files elsewhere.
• For generated/demo edits, prefer creating a new clearly named sequence instead of modifying the user's active sequence.
• If a tool returns `success: false`, report the exact error and run diagnostics before retrying blindly.

Install Workflow

If the user asks you to install or set up the MCP:

1. Check the OS. The automated installer is macOS-focused. 2. Clone or open the repo:

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

3. On macOS, run:

npm run setup:mac

4. For non-macOS or manual client setup, run:

npm install
npm run build

5. Register the MCP server in the user's client with:

command: node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js
env: PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge

For Codex, prefer:

codex mcp add premiere_pro --env PREMIERE_TEMP_DIR=/tmp/premiere-mcp-bridge -- node /absolute/path/to/Adobe_Premiere_Pro_MCP/dist/index.js

Premiere Bridge Startup

After installing:

1. Restart the MCP client if it reads config only at startup. 2. Restart Premiere Pro. 3. Open `Window > Extensions > MCP Bridge (CEP)`. 4. Set `Temp Directory` to `/tmp/premiere-mcp-bridge`. 5. Click `Save Configuration`. 6. Click `Start Bridge`. 7. Confirm the bridge panel says Premiere is ready before running editing tools.

If Premiere is not running, you can install/build/register the MCP, but tell the user live tool verification requires Premiere and the CEP bridge panel.

Verification

Run local checks:

npm run setup:doctor

If Premiere is running and the bridge is started, verify with safe read-only calls:

• `get_project_info`
• `list_sequences`
• `list_project_items`

For deeper validation in a disposable project, create a test sequence with `create_sequence_from_clips` or `create_sequence` plus a real `.sqpreset` path, then call `list_sequences` and confirm it exists. Do not call blank sequence creation without a preset because newer Premiere versions can open a native dialog that blocks CEP.

Editing Strategy

• Start by understanding the project: project info, active sequence, existing media, tracks, markers, and selected sequence.
• Build a plan in concrete Premiere operations before changing anything.
• For rough cuts, import media first, then use `create_sequence_from_clips` so Premiere derives settings without a native dialog. Use `create_sequence` only with a real `.sqpreset`; use `duplicate_sequence` with `clearContents=true` when an existing sequence defines the intended settings.
• For product or brand spots, prefer `assemble_product_spot` or `build_brand_spot_from_mogrt_and_assets` when the user's request fits those workflows.
• For black-and-white looks, use `apply_effect` with `Black & White` rather than generic saturation-only changes.
• For timeline cuts, prefer sequence-aware tools and include `sequenceId` when available.
• Export only after confirming output path, format/preset, and overwrite behavior.

Troubleshooting

If commands time out or report bridge errors:

1. Confirm Premiere is open. 2. Confirm `Window > Extensions > MCP Bridge (CEP)` is open and bridge is started. 3. Confirm both sides use the same temp directory. 4. Run:

npm run setup:doctor

5. Ask the user to click `Run Diagnostics` in the CEP panel. 6. Read `/tmp/premiere-mcp-bridge/premiere-mcp-diagnostics-latest.json` if it exists. 7. Remove stale command/response files only if they are clearly old and the bridge is stopped or idle.

Common fixes:

• `ENOENT` on temp directory: create `/tmp/premiere-mcp-bridge`, save config again, restart bridge.
• Tool succeeds in Premiere but reports failure: run `list_sequences` or the relevant list tool to confirm state before retrying.
• Empty or malformed temp directory config: set the field to the path only, not JSON or an env assignment.