What is the Photoshop Control MCP server?
Photoshop Control is a local MCP server that bridges an AI coding agent to Adobe Photoshop on Windows through PowerShell COM automation and ExtendScript. It exposes fourteen tools for canvas creation, layer management, text, paths, color adjustment and batch export, so an agent edits a live Photoshop document instead of generating a flat image.
Photoshop Control is a local automation bridge, not an official Adobe plugin, that lets an AI coding agent drive a running copy of Photoshop or Photoshop Beta on Windows. It calls Photoshop through PowerShell COM automation and ExtendScript, so the agent edits a real document rather than describing one.
The server covers document setup, layer work, text, paths, color and export in one tool set. A batch tool chains several of those steps into one call, which keeps multi-step edits inside a single agent turn.
What it changes in your workflow
- The agent creates a canvas, places images, and adds editable text layers directly in Photoshop instead of producing a flat generated image.
- Color and texture adjustments run against the real pixels in the open document, so the result reflects the document's current state.
- A single photoshop_batch call can execute a sequence of the other tools, useful for repeated export or layout steps.
- An escape hatch tool runs custom ExtendScript for edits the built-in tools do not cover.
Requirements
| Photoshop Control MCP server | |
|---|---|
| OS | Windows only |
| App | Adobe Photoshop or Photoshop Beta, with COM registered |
| Transport | Local, started by the agent |
| Config | PHOTOSHOP_PROG_ID environment variable if the default ProgID does not connect |
Who it is for
Best for
- Windows users who want an agent to build or edit a Photoshop document directly, layer by layer.
- Batch image work such as cropping, scaling, brightness and export across several files in one session.
- Teams already scripting Photoshop with ExtendScript who want an agent-callable wrapper around it.
Not for
- If your job is mostly Photoshop work beyond the fourteen tools here, such as background removal or carousel recipes, the community Photoshop MCP server covers a wider tool set.
- When the job is mostly generating a color palette rather than editing a Photoshop document, the Tailwind Shades MCP server builds OKLCH palettes directly.
- When the output needed is an editable figure in PowerPoint or draw.io rather than a Photoshop canvas, the Scientific Illustrator MCP server redraws a reference image into those editable objects instead.
- When the output needed is an architecture diagram with vendor cloud icons rather than a Photoshop canvas, the Excalidraw Icons MCP server draws AWS, Azure and GCP icons on a live canvas.
Use it with UiChemy
UiChemy Composer edits WordPress pages visually inside Elementor or Gutenberg. For graphics built in Photoshop first, export the layers from this server, then bring the finished images into a Composer page instead of recreating them by hand.
Connect Photoshop Control MCP Server for AI Coding Agents to your AI client
git clone https://github.com/kiki348/photoshop-beta-control.gitClone into the plugin folder
Run
cd $env:USERPROFILE\.codex\pluginsthengit clone https://github.com/kiki348/photoshop-beta-control.git.Find the ProgID
With Photoshop open, run the bundled
photoshop_bridge.ps1 -Action find_progidsscript to list the COM ProgIDs registered on the machine.Set the ProgID if needed
If the default does not connect, set
PHOTOSHOP_PROG_IDto a value such as Photoshop.Application, Photoshop.Application.2026 or Photoshop.Application.BETA.Enable the plugin
Codex reads the repository's
.codex-plugin/plugin.jsonand.mcp.jsonautomatically; restart Codex or enable the plugin from its plugin manager.Check the connection
Call the photoshop_status tool and confirm it reports the open document's name and size.
Client configuration
{
"PHOTOSHOP_PROG_ID": "Photoshop.Application"
}Endpoints and ports
photoshop_bridge.ps1 -Action find_progidsLists registered Photoshop COM ProgIDs on the machine.PHOTOSHOP_PROG_IDEnvironment variable to pin the exact Photoshop COM ProgID.photoshop_statusReports whether Photoshop is reachable and which document is active.What you can do with it
- Live document editingEvery tool call acts on the open Photoshop document, so layers stay editable instead of becoming a flattened export.
- Canvas and layer creationphotoshop_create_document and photoshop_place_image build a canvas and add image layers in one pass.
- Editable text and pathsphotoshop_add_text_layer and photoshop_draw_paths add real text and vector path objects, not rendered pixels.
- Texture-preserving recolorphotoshop_texture_recolor changes color on a layer while keeping its existing highlights and texture detail.
- Batch executionphotoshop_batch runs several tool calls as one sequence, useful for repeated crop, adjust and export steps.
- ExtendScript escape hatchphotoshop_run_jsx runs custom ExtendScript for edits the fixed tool set does not cover.
- Layer managementphotoshop_layer_ops lists, renames, hides and deletes layers without leaving the agent conversation.
- COM ProgID detectionphotoshop_find_progids locates the exact registered Photoshop ProgID so the PHOTOSHOP_PROG_ID variable can be set correctly.
Tools it exposes
photoshop_status
Checks Photoshop availability and reports the active document's name, size and layer count.
photoshop_find_progids
Lists the Photoshop COM ProgIDs registered on the Windows machine.
photoshop_open_image
Opens a local image file as a new Photoshop document.
photoshop_create_document
Creates a new canvas at a given width, height and resolution.
photoshop_place_image
Places an image file as a new layer with position, size and opacity set.
photoshop_add_text_layer
Adds an editable text layer with font, size and color.
photoshop_layer_ops
Lists, selects, renames, hides or deletes layers in the active document.
photoshop_draw_paths
Creates editable vector paths, with an option to stroke them.
photoshop_adjust_image
Crops, scales, and adjusts brightness, contrast or sharpness on a layer.
photoshop_texture_recolor
Recolors a layer locally while preserving its existing texture and highlights.
photoshop_apply_overlay
Places a transparent overlay layer at an exact position over the canvas.
photoshop_export_active
Exports the active document to a chosen image format and path.
photoshop_batch
Runs a sequence of the other tools as one combined call.
photoshop_run_jsx
Runs a custom Photoshop ExtendScript for edits outside the built-in tools.
Frequently asked questions
What is the Photoshop Control MCP server?
It is a local MCP server that connects an AI coding agent to a running copy of Photoshop on Windows through COM automation and ExtendScript. The agent calls tools to create documents, place images, add text and paths, adjust color, and export, acting on the real open document.
How do I set up the Photoshop Control MCP server?
Clone the repository into your agent's plugin folder, open Photoshop, then run the bundled script with the find_progids action to list the registered COM ProgIDs. Set the PHOTOSHOP_PROG_ID environment variable if the default does not connect, then restart the agent.
Does it work on macOS?
No. The server depends on Windows COM automation to reach Photoshop, so it only runs on Windows. There is no equivalent bridge in this project for macOS or Linux machines right now.
What can the fourteen tools do?
They cover document and canvas creation, opening images, placing and managing layers, adding text and paths, color and texture adjustment, overlay placement, export, running several steps as a batch, and running custom ExtendScript for anything else.
Do I need Photoshop open already?
Yes. The tools act on a running Photoshop or Photoshop Beta session, so the application needs to be open with the agent able to reach it through the registered ProgID before calling any tool.
What happens if the ProgID is wrong?
Calls fail to reach Photoshop. Run the photoshop_find_progids tool or the bundled PowerShell script to list the ProgIDs actually registered on the machine, then set PHOTOSHOP_PROG_ID to the matching value.
Can it do generative fill or complex selections?
The built-in tools handle layers, text, paths, color, and export. For generative fill or more complex selections, the project points to the photoshop_run_jsx tool to run a custom ExtendScript instead.


