# photoshop-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/alisaitteke/photoshop-mcp  
**GitHub Stars:** 928  
**Views:** 25  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/photoshop-mcp

## Description
MCP server for Adobe Photoshop automation - control Photoshop from AI assistants

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://github.com/alisaitteke/photoshop-mcp), copied verbatim. Run them in order; they are not an mcpServers config.

1. Start the server:

```sh
TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui
```

2. Start the server:

```sh
npx -p @alisaitteke/photoshop-mcp ui
```

3. Start the server:

```sh
npx -y @alisaitteke/photoshop-mcp
```

4. Add to Claude Code:

```sh
claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
```

## Documentation

## 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:

```bash
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:

```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.

_Full upstream README: https://allmcps.com/mcp/photoshop-mcp/readme_

