Six productsInstall one or all. One sign-in (Microsoft, Google or GitHub) works for all six.

Photoshop MCP · for Adobe Photoshop 2022 and later

Let AI work in your Photoshop documents.

Photoshop MCP is a free MCP server that lets AI assistants such as Claude, Codex and Cursor read and work with the documents open in Photoshop on your PC — layers, selections, text, adjustments, filters and export — with every change one step in the History panel.

FreeWindowsPhotoshop 2022 and laterNo plug-in inside PhotoshopDocuments stay on your PC

Illustrative session. The assistant works in the Photoshop already open on your PC.

WatchInstall Photoshop MCP and start using it · step by step, about 2 minutes
▶ Click to watch with sound
A
What it does

Photoshop, in plain words

Tools for everyday work, plus any Photoshop Action Manager command or ExtendScript when no tool fits — chained into multi-step workflows such as a presentation board or a batch export.

Documents and layers

Open, create and inspect documents; add, group, name, order and arrange layers, and place images.

Selections and masks

Make and refine selections, and add layer and vector masks.

Text

Set type with your fonts, sizes and colours, and edit the text already in the document.

Adjustments and filters

Adjustment layers for colour and tone, and Photoshop's filters, applied to the layers you name.

Layer styles and smart objects

Shadows, strokes and other layer styles; convert to, edit and replace smart objects.

Artboards and export

Artboards for layouts and sizes, and export to PNG, JPEG, PDF and more, from a copy, so your document stays as it was.

Generative features

Photoshop's generative and AI features, such as removing a background, only with your consent, as they use your Adobe credits.

Any Photoshop command

Any Action Manager command or ExtendScript, your recorded actions, and multi-step workflows built from all of these.

B
How it works

A program on your PC, talking to Photoshop

There is no plug-in inside Photoshop. Your AI assistant starts ps-mcp, which works with the Photoshop already open on your PC through Photoshop's own scripting.

AI assistant any MCP client MCP YOUR PC · WINDOWS Photoshop MCP ps-mcp · tools COM PHOTOSHOP 2022 AND LATER Scripting Action Manager · JSX Open documents read · change · export YOUR DOCUMENTS STAY ON THE PC · ONLY AI LEARNING IS SHARED

With several documents open, a change names the document it is for, so switching documents while the assistant works is safe. The assistant cannot see your screen: to look at a result it asks Photoshop for a small preview image.

C
Install

Install in three steps

One file, one sign-in, no administrator rights, and nothing to install inside Photoshop. Latest release: v0.1.2.

  1. 1

    Open the downloaded file

    Run PsMcp-Setup.exe from your desktop or Downloads folder, not from inside the Claude app. If Windows asks whether to run it, choose More info › Run anyway.

  2. 2

    Click Install

    Setup installs Photoshop MCP for your Windows user. It asks you to sign in once with Microsoft, Google or GitHub, then connects the AI apps it finds on your PC.

  3. 3

    Restart your AI assistant

    If the Claude app is open, let setup restart it (your chats are kept). Otherwise quit it from its icon by the clock, open it again and start a new chat.

Then open Photoshop and ask your assistant: “What is open in Photoshop?” It works with Photoshop 2022 or later on Windows, and there is no plug-in to load. Run the file again at any time to repair or update; uninstall from Windows Settings › Apps.
Command Prompt › ps-mcp --doctor checks Photoshop and your AI apps
Download the installer

All files are on the release page.

D
Connect your AI

Your AI assistants are connected for you

Setup connects every AI app it finds on your PC. Restart the assistant, or start a new chat, after it was connected.

On your PC

Connected automatically by setup:

  • Claude app
  • Claude Code
  • Codex
  • Cursor
  • VS Code
  • Gemini CLI

ChatGPT and claude.aiOptional · off by default

  1. On your PC, signed in: answer Yes when setup asks, or run ps-mcp --cloud on.
  2. Copy this address and add Photoshop MCP once to your online account:
https://aecomcps.com/mcp/photoshop
  • claude.ai (Pro, Max, Team, Enterprise): Settings › Connectors › Add custom connector › name Photoshop MCP › paste the address › Add › Connect. On Team or Enterprise plans your administrator may have added it already: then just click Connect.
  • ChatGPT (paid plans): Settings › Apps & Connectors › Advanced settings › switch Developer mode on › Create › paste the address › Create.

Sign in with the same Microsoft, Google or GitHub account as on your PC, start a new chat with Photoshop MCP switched on, and keep Photoshop open. What the AI reads from the document passes through the team gateway to the AI company; the gateway never stores or logs it.

E
Safety

Nothing changes without you knowing

The assistant checks the document first, previews larger changes and asks before anything that loses work.

One History step per change

Every change is one step “MCP: …” in Photoshop's History panel. A change that fails half-way is undone automatically.

Preview first

Nothing is deleted, flattened, merged, rasterized or closed without your yes: the assistant shows what would be lost first.

Your files are kept

Files are never overwritten unless you agree. Exports work on a copy, so your document stays as it was.

Generative features ask first

Generative and AI features use your Adobe credits, so the assistant asks before it uses them.

Settings you control

Read-only mode, scripts, and menu commands or recorded actions can each be switched off in the settings.

Stays on your PC

Your documents, layer names, text and files stay on the PC and with the AI you connected. Only privacy-filtered AI learning is shared with your team.

F
Versions

Which Photoshop

Photoshop 2022 and later

Photoshop MCP works with Adobe Photoshop 2022 or later on Windows, using the Photoshop installed on your PC. Nothing is installed inside Photoshop.

G
Questions

Questions and answers

What is Photoshop MCP?

Photoshop MCP is a free Model Context Protocol (MCP) server for Adobe Photoshop, so AI assistants such as Claude, Codex, Cursor and VS Code Copilot can read and work with the documents open in Photoshop on your PC.

Which Photoshop versions does it support?

Adobe Photoshop 2022 and later on Windows. Nothing is installed inside Photoshop: Photoshop MCP works with the Photoshop already on your PC.

What can the AI do in Photoshop?

Create and edit documents, layers and groups, selections and masks, text, adjustment layers, filters, layer styles, smart objects and artboards, and export files. When no tool fits, it can run any Photoshop Action Manager command or an ExtendScript, and it chains these into multi-step workflows. Every change is one step in the History panel.

Does it use Photoshop's generative features?

Only with your consent. Generative features use your Adobe credits, so the assistant asks you before it uses them.

Is Photoshop MCP free?

Yes. Photoshop MCP is free. You sign in once with a Microsoft, Google or GitHub account, the same account as for the other products.

Do I need administrator rights?

No. Setup installs Photoshop MCP for your Windows user only, and it updates itself the same way.

Which AI assistants work with Photoshop?

Claude app, Claude Code, Codex, Cursor, VS Code, Gemini CLI and other MCP clients on your PC, connected by setup. ChatGPT and claude.ai in the browser work too, once you switch Cloud AI access on (optional, off by default).

Do my documents leave my PC?

No. Your documents, layer names, text and files stay on your PC and with the AI assistant you connected (with ChatGPT or claude.ai, what the AI reads passes through the gateway, which never stores it). Only privacy-filtered AI-learning information (which tool failed and how it was fixed, in general words) is shared with your team.

How do I install it?

Download the installer on this page (PsMcp-Setup.exe) and run it from your desktop or Downloads folder, not from inside the Claude app. It installs Photoshop MCP without administrator rights, asks you to sign in once and connects your AI assistants. Nothing is installed inside Photoshop.

Guides: All guides