What is the photoshop-mcp-windows-first MCP server?
photoshop-mcp-windows-first is a Node MCP server built for Windows that drives a running copy of Adobe Photoshop over ExtendScript. After cloning the repository and building it, an agent connects over stdio and gets more than 90 tools spanning document and layer management, filters, color adjustments, text, selections and history control.
This server gives an AI agent direct control of a running Adobe Photoshop install through ExtendScript, Adobe's own scripting layer for the app. It targets Windows first, while also noting support for Photoshop on macOS.
The project advertises structured state, meaning the agent can read back a document's current layers and settings rather than only sending one-way commands.
What it changes in your workflow
- An agent can open, edit and save a Photoshop document without a person clicking through menus.
- Layer creation, reordering, grouping and blend mode changes become tool calls instead of manual steps.
- Filters such as blur, sharpen and noise, plus color adjustments, run through the same tool interface as layer edits.
- History and undo stay available to the agent, so an edit that goes wrong can be reversed.
Supported Photoshop versions
| photoshop-mcp-windows-first | |
|---|---|
| Platform | Windows first; macOS also noted as supported |
| Photoshop versions | 2012 through 2025 and newer, via ExtendScript |
| Bridge | ExtendScript, not the newer UXP plugin system |
| Setup | Clone, npm install, npm run build, then point the config at dist/index.js |
Who it is for
Best for
- Windows users who want an agent driving Photoshop directly instead of exporting images back and forth between separate tools.
- Batch edits across many layers: color grading, filter passes or text updates run as repeatable tool calls.
- Workflows already scripting Photoshop with ExtendScript that want an agent in that same loop.
Not for
- Running a newer, differently built Photoshop control surface with its own tool set is what the Photoshop MCP Server offers for the same app.
- Operating Figma Desktop directly, rather than Photoshop, through an agent-driven canvas is the job Conduit Design MCP does instead.
- Letting an agent design directly inside Figma in real time, rather than editing an existing Photoshop document, is what the Figma AI Bridge MCP does instead.
Use it with UiChemy
This server edits raster artwork inside Photoshop itself. Once an image is ready, UiChemy Composer or AI to WordPress can place it into an editable Elementor or Gutenberg page. Click Get Started on uichemy.com.
Connect Photoshop MCP Server (Windows First): Setup and Tools to your AI client
node C:/path/to/photoshop-mcp-windows-first/dist/index.jsClone and build
Run git clone on the repository, then npm install and npm run build inside it to produce dist/index.js.
Set the Photoshop path
Point PHOTOSHOP_PATH at your local Photoshop executable, matching the version string in your install.
Add the server entry
Use the config above in your client, with command node and the built dist/index.js as the argument.
Open Photoshop and restart your client
Photoshop needs to already be running for ExtendScript calls to reach it; then restart your MCP client.
Client configuration
{
"mcpServers": {
"photoshop": {
"command": "node",
"args": ["C:/path/to/photoshop-mcp-windows-first/dist/index.js"],
"env": {
"PHOTOSHOP_PATH": "C:/Adobe/Adobe Photoshop 2024/Photoshop.exe",
"LOG_LEVEL": "1"
}
}
}
}What you can do with it
- Windows-first designSetup and the environment variable names assume a Windows path for Photoshop first, with macOS also documented as working.
- ExtendScript bridgeCommands run through ExtendScript, the same scripting layer Photoshop has exposed since the Creative Suite era, rather than a newer plugin API.
- Structured stateThe server tracks document and layer state, so an agent can ask what exists before deciding what to change.
- Broad version rangeThe README lists support from Photoshop 2012 through current 2025-plus builds.
- Over 90 toolsTools span documents, layers, filters, color adjustments, text, selections, history and custom script execution.
- Custom script escape hatchrun_script accepts a raw ExtendScript snippet for an edge case none of the named tools cover.
Tools it exposes
create_document
Opens a new Photoshop document with a given size, resolution and color mode.
open_document
Opens an existing image in Photoshop so the agent can read and edit it.
list_layers
Returns the current layer stack, including names, visibility and blend modes.
create_layer
Adds a new layer, optionally with a name and a starting blend mode.
apply_filter
Runs a named filter such as blur, sharpen or noise on the active layer.
adjust_color
Applies a color adjustment, such as levels, curves or hue and saturation, to a layer.
add_text_layer
Creates a text layer with given content, font and formatting.
make_selection
Creates a selection on the canvas by shape or by color range, for use by a later edit.
run_action
Plays back a saved Photoshop action by name.
save_document
Saves the active document, in its native format or an exported format.
undo_step
Steps back through Photoshop's own history, matching an undo in the app.
run_script
Executes a custom ExtendScript snippet for an operation with no dedicated tool.
Frequently asked questions
What is the photoshop-mcp-windows-first MCP server?
It is an MCP server that controls a running copy of Adobe Photoshop over ExtendScript. It gives an agent more than 90 tools for documents, layers, filters, color adjustments, text, selections and history.
How do I install photoshop-mcp-windows-first?
Clone the repository, run npm install and npm run build, then point an MCP client's config at the built dist/index.js with node as the command and your Photoshop executable path in an environment variable.
Does it work on macOS as well as Windows?
The project is built Windows first and names Windows paths in its setup example, while also documenting macOS as a supported platform for the same underlying ExtendScript bridge and tool set.
Which Photoshop versions does it support?
The README lists support from Photoshop 2012 through current 2025 and newer releases, since ExtendScript has stayed available in the app across that entire version range on both Windows and macOS.
Does Photoshop need to be open already?
Yes. The server sends ExtendScript commands to a running Photoshop process, so the app has to already be open on the same machine before the agent can act on it.
Can it run a saved Photoshop action?
Yes. The run_action tool plays back a named action already saved inside Photoshop, which is useful for a repeatable sequence a person already built by hand before the agent took over.
What happens if an edit needs to be undone?
The undo_step tool steps back through Photoshop's own history stack, the same mechanism as pressing undo in the app, so a bad edit from the agent can be reversed without reopening the document.


