mcpField
A
Adobe MCP Suite

Adobe MCP Suite

Local
github.com/zachshallbetterMedia & Design28Updated 1w ago

About Adobe MCP Suite

A local MCP server that brings Adobe InDesign, Illustrator, Photoshop, After Effects, and Premiere Pro into one coordinator. It is intended for workflows spanning multiple Adobe applications and includes tools for transferring artwork and swatches between apps.

Key features

  1. 01Tools for five Adobe applications
  2. 02Optional selection of loaded apps
  3. 03Application-prefixed tool names
  4. 04Illustrator artwork placement in InDesign
  5. 05Swatch copying from Illustrator to InDesign

Use cases

  1. 01Coordinating tasks across Adobe applications
  2. 02Placing Illustrator artwork into InDesign layouts
  3. 03Copying colour swatches between Illustrator and InDesign

MCP support

The server speaks MCP over stdio and exposes the tools of the selected Adobe applications, using app-prefixed names. It also provides cross-application tools when the relevant applications are loaded.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"zachshallbetter-adobe-mcp-suite": {
"command": "npx",
"args": [
"-y",
"adobe-mcp-suite"
],
"env": {
"ADOBE_MCP_APPS": "<ADOBE_MCP_APPS>",
"ADOBE_TARGET": "<ADOBE_TARGET>",
"ADOBE_BACKEND": "<ADOBE_BACKEND>",
"TARGET": "<TARGET>",
"BACKEND": "<BACKEND>",
"ARTCRAFT_ENABLED": "<ARTCRAFT_ENABLED>",
"ARTCRAFT_CONTROL_PORT": "<ARTCRAFT_CONTROL_PORT>",
"ARTCRAFT_CONTROL_TOKEN": "<ARTCRAFT_CONTROL_TOKEN>",
"ARTCRAFT_CONTROL_TOKEN_FILE": "<ARTCRAFT_CONTROL_TOKEN_FILE>",
"INDESIGN_ALLOWED_DIRS": "<INDESIGN_ALLOWED_DIRS>",
"ILLUSTRATOR_ALLOWED_DIRS": "<ILLUSTRATOR_ALLOWED_DIRS>",
"PHOTOSHOP_ALLOWED_DIRS": "<PHOTOSHOP_ALLOWED_DIRS>",
"AFTEREFFECTS_ALLOWED_DIRS": "<AFTEREFFECTS_ALLOWED_DIRS>",
"PREMIERE_ALLOWED_DIRS": "<PREMIERE_ALLOWED_DIRS>",
"PREMIERE_WS_PORT": "<PREMIERE_WS_PORT>",
"UXP_BRIDGE_URL": "<UXP_BRIDGE_URL>",
"BRIDGE_TOKEN": "<BRIDGE_TOKEN>"
}
}
}
}
Run commandnpx -y adobe-mcp-suite
Environment variables to set
ADOBE_MCP_APPSApplications to load, comma-separated: indesign, illustrator, photoshop, aftereffects, premiere. Defaults to InDesign and Illustrator
ADOBE_TARGETOptional shared execution target, including adobe, craft, artcraft, or auto
ADOBE_BACKENDOptional shared execution backend, including extendscript, uxp, craft, or auto
TARGETAlias for ADOBE_TARGET when choosing the shared execution target
BACKENDAlias for ADOBE_BACKEND when choosing the shared execution backend
ARTCRAFT_ENABLEDProbe a compatible local ArtCraft app when the selected backend is auto
ARTCRAFT_CONTROL_PORTFallback loopback port for local ArtCraft control connections
ARTCRAFT_CONTROL_TOKENSecretFallback authentication token for local ArtCraft control connections
ARTCRAFT_CONTROL_TOKEN_FILESecretFile containing the fallback ArtCraft control token
INDESIGN_ALLOWED_DIRSExtra directories InDesign tools may read and write (':' on macOS, ';' on Windows)
ILLUSTRATOR_ALLOWED_DIRSExtra directories Illustrator tools may read and write (':' on macOS, ';' on Windows)
PHOTOSHOP_ALLOWED_DIRSExtra directories Photoshop tools may read and write (':' on macOS, ';' on Windows)
AFTEREFFECTS_ALLOWED_DIRSExtra directories After Effects tools may read and write (':' on macOS, ';' on Windows)
PREMIERE_ALLOWED_DIRSExtra directories Premiere Pro tools may read and write (':' on macOS, ';' on Windows)
PREMIERE_WS_PORTLoopback port used to connect the Premiere Pro UXP plugin; defaults to 3011
UXP_BRIDGE_URLInDesign UXP bridge URL; defaults to http://127.0.0.1:3000
BRIDGE_TOKENSecretOptional shared secret for the local InDesign or Premiere Pro UXP bridge

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmadobe-mcp-suite0.3.0

Tools

447

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
positionenumNoWhere to add the page: AT_END, AT_BEGINNING, or BEFORE/AFTER referencePageAT_END | AT_BEGINNING | BEFORE | AFTER
referencePageintegerNo0-based reference page index (required for BEFORE/AFTER)

Details

From the project README

Adobe MCP Suite

One MCP server for Adobe InDesign, Illustrator, Photoshop, After Effects and Premiere Pro together, with tools that work across them. Use it when you work in both applications; to drive only one, install that application's server instead (adobe-mcp-indesign, adobe-mcp-illustrator, adobe-mcp-photoshop, adobe-mcp-aftereffects, adobe-mcp-premiere).

Requires Node.js 18 or later, and InDesign, Illustrator, Photoshop and/or After Effects 2023 or later, or Premiere Pro 25.6 or later with its plugin loaded (see adobe-mcp-premiere), on macOS or Windows.

Install

Install the published suite with npm:

npm install --global adobe-mcp-suite

Or use the pinned Homebrew formula (macOS and Linux):

brew install --formula https://raw.githubusercontent.com/zachshallbetter/adobe-mcp/main/Formula/adobe-mcp-suite.rb

The curl installer installs the current npm release globally:

curl -fsSL https://raw.githubusercontent.com/zachshallbetter/adobe-mcp/main/scripts/install.sh | sh

All three methods install the same suite package. It runs locally and still requires Node.js 18 or later and the Adobe apps you plan to use.

Claude Code:

claude mcp add adobe -- npx -y adobe-mcp-suite

Any client that reads an mcpServers block:

{
  "mcpServers": {
    "adobe": { "command": "npx", "args": ["-y", "adobe-mcp-suite"] }
  }
}

Load only some applications with --apps (or ADOBE_MCP_APPS):

{ "command": "npx", "args": ["-y", "adobe-mcp-suite", "--apps", "illustrator"] }

Tools

Every tool of each application is included, unchanged, with the application's name in front: indesign_create_text_frame, illustrator_create_rectangle, indesign_export_pdf. A tool that already names its application keeps it once: indesign_status, illustrator_execute_code. Each application keeps its own units and conventions (InDesign: millimetres from the page's top-left; Illustrator: points from the artboard's top-left; Photoshop: pixels from the document's top-left; After Effects: pixels from the composition's top-left and seconds; Premiere Pro: seconds, with clips chosen by track and clip index), and the server's instructions describe each. Premiere Pro's plugin port opens on the first Premiere Pro call.

Tools across applications, offered when both are loaded:

ToolWhat it does
place_illustrator_artwork_in_indesignPlaces an artboard of the active Illustrator document on an InDesign page, linked to the .ai file, so later edits in Illustrator reach the layout when the link is updated. Saves the Illustrator document first unless you say not to.
copy_swatches_illustrator_to_indesignCopies colour swatches with their exact values: CMYK and RGB process colours, spot colours as spot inks, grays as CMYK black. Gradients and patterns are listed, not copied; InDesign's built-in swatches are never changed.

Configuration

Each application's variables apply as they do in its own server. The allowed-path variables are INDESIGN_ALLOWED_DIRS, ILLUSTRATOR_ALLOWED_DIRS, PHOTOSHOP_ALLOWED_DIRS, AFTEREFFECTS_ALLOWED_DIRS and PREMIERE_ALLOWED_DIRS. App names, timeouts and backend variables are also supported; see each app's README for their exact behavior. Premiere Pro additionally needs its UXP plugin loaded and uses PREMIERE_WS_PORT and the optional BRIDGE_TOKEN. ADOBE_MCP_APPS chooses the applications.

Development

npm test -w packages/suite

The tests check tool naming, that each application's argument aliases stay with its own tools, that each application's help accepts the suite's names, and that the cross-application tools generate valid scripts for both applications' object models, with both applications stubbed. Nothing here has been run against InDesign or Illustrator.

Licence

MIT. See LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.