Photoshop MCP logo

Photoshop MCP

Control Adobe Photoshop from AI assistants with 128 MCP tools for editing, retouching, exports, and batch workflows.

Install Photoshop MCP

Run the project’s own setup commands, in order.

Setup steps from the project

photoshop-mcp installs with its own commands rather than a config we can generate, so these are copied as-is. Run them in order in a terminal. Source: github.com

  1. 1. Start the server
    TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui
    
  2. 2. Start the server
    npx -p @alisaitteke/photoshop-mcp ui
    
  3. 3. Start the server
    npx -y @alisaitteke/photoshop-mcp
    
  4. 4. Add to Claude Code
    claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
    

Overview

photoshop-mcp connects AI assistants to Adobe Photoshop so plain-language requests can trigger document edits and exports. It exposes 128 tools, including 111 atomic operations and 17 one-step recipes for tasks such as background removal, portrait enhancement, carousel creation, and batch watermarking. Run it through the standalone browser chat or configure it as a standard stdio MCP server in supported AI clients. Reach for it when Photoshop is part of a repeatable multimedia workflow and you want edits planned and executed through conversational commands.

Use cases

  • Remove backgrounds while preserving editable masks
  • Retouch portraits with repeatable editing recipes
  • Prepare Photoshop designs for web and social exports
  • Split wide artwork into numbered carousel slides
  • Watermark folders without changing original photos

Key features

  • 128 Photoshop tools
  • 111 atomic operations and 17 recipes
  • One-step undo for multi-operation recipes
  • Standalone browser chat
  • Optional Jev command routing
  • Windows and macOS support

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

23/26 checks healthy over the last 103d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars928Stargazers on the source repository.
Last commit8d agoMost recent push to the default branch.
Directory activity25 viewsConfig copies, upvotes, and views on AllMCPs.

How Photoshop MCP works

What photoshop-mcp does

photoshop-mcp lets an AI assistant operate Adobe Photoshop through the Model Context Protocol. You can describe an editing task in natural language, such as isolating a subject, preparing social-media exports, or splitting a wide design into carousel slides. Photoshop performs the resulting operations while the assistant checks document state and responds to structured errors.

The project targets both Windows and macOS. It is an unofficial, community-maintained project and is not affiliated with Adobe. Photoshop must be running, and the project supports Photoshop versions from 2012 onward.

How it works

The normal flow has three stages:

  1. You describe the desired result in an AI chat.
  2. The assistant plans the required Photoshop operations and checks the document state.
  3. Photoshop executes the operations through the MCP connection.

Multi-step recipes are grouped into one undoable Photoshop step. This includes workflows such as background removal, portrait enhancement, web preparation, and carousel generation. If an operation produces an error, the assistant receives structured error information that can guide a correction.

The package also includes an optional standalone browser chat. Its experimental Jev routing can send recognized safe commands directly to Photoshop without an LLM call; other requests, including hard-to-undo operations such as merge or flatten, are sent to the Action Plan. Enabling Jev requires a TypeSafe API key and sends prompts to TypeSafe's API.

Setup and configuration

Install and launch the standalone interface with Node.js 18 or newer:

Terminal
npx -p @alisaitteke/photoshop-mcp ui

This opens a browser chat window. You can authenticate with an AI provider API key or reuse an existing Claude Code or Gemini CLI account. Photoshop needs to be open on the same computer.

For an MCP client, use the package as a stdio server:

config.json
{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"]
    }
  }
}

Claude Code can register the same command with claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp. Cursor and VS Code provide installation paths for this package. The optional Jev router uses TYPESAFE_API_KEY; without that key, the standalone UI operates without Jev routing.

Tools and capabilities

The server provides 128 tools in total: 111 lower-level operations and 17 recipes. Supported workflows include:

  • Removing backgrounds while retaining an editable mask
  • Retouching portraits with skin smoothing, tone correction, and dodge-and-burn setup
  • Preparing web and social exports with color-space, sizing, sharpening, and JPEG steps
  • Dividing a wide design into numbered, seamless carousel slides
  • Applying a watermark to a folder while leaving originals untouched
  • Applying color grades, sky replacement, and generative fill workflows when an Adobe account is available
  • Creating additional recipe-based workflows such as passport photos, CSV-driven cards, and mockups

The available-tools documentation defines the individual tool parameters. Prompt templates and recipes are also included for common editing requests.

Limitations and notes

Photoshop must be installed and running on Windows or macOS. Node.js 18 or later is required for the package. Adobe-account access is required for workflows that use generative fill. Jev routing is experimental and opt-in rather than a prerequisite for using the MCP server.

Anonymous, aggregated usage analytics are enabled by default and can be disabled. Because the project is community-maintained and unofficial, it should not be treated as an Adobe-supported integration.

Written by AllMCPs with AI assistance from the project’s README and listing data. How we build listings

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Photoshop MCP

photoshop-mcp is an MCP server that connects AI assistants to Adobe Photoshop through a local Node.js bridge. Its main tools cover 111 atomic operations and 17 one-step recipes, including background removal, portrait retouching, web exports, carousel creation, batch watermarking, and color work on Windows or macOS.

Install it with `npx` and Node.js 18 or newer. Run `npx -p @alisaitteke/photoshop-mcp ui` for the browser chat, or add `npx -y @alisaitteke/photoshop-mcp` as a stdio server in an MCP client configuration. Photoshop must be installed and running.

Yes, photoshop-mcp works with Cursor. Install its plugin when available, use the provided Cursor installation link, or add the package command to Cursor's MCP configuration. The server runs with `npx -y @alisaitteke/photoshop-mcp`.

Yes, photoshop-mcp can be added to Claude Desktop as a standard stdio MCP server. Configure the server with command `npx` and argument `-y @alisaitteke/photoshop-mcp`, then keep Photoshop running while using the assistant.

Set `TYPESAFE_API_KEY` when launching the standalone UI to enable the experimental Jev router. For example, run `TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui`. Without the key, the UI works without Jev and does not send prompts to TypeSafe.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPhotoshop MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/photoshop-mcp?style=directory)](https://allmcps.com/mcp/photoshop-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/photoshop-mcp"><img src="https://allmcps.com/api/badge/photoshop-mcp?style=directory" alt="Photoshop MCP on AllMCPs" /></a>