# photoshop-mcp

MCP server that lets AI assistants control Adobe Photoshop. It automates background removal, photo retouching, batch watermarking, and asset exports via chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 725
- Author: alisaitteke
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alisaitteke/photoshop-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/photoshop-mcp

## What it does

The server exposes 128 Photoshop tools to an AI agent: 111 atomic actions alongside 17 multi-step recipes. You tell the assistant what to edit, and it handles layer masks, skin smoothing, batch watermarking across folders, or slicing wide graphics into social carousels. Each multi-step recipe registers as a single undo state in Photoshop. Mistakes take one step to revert.

You can drive edits directly from Claude Code or spin up a standalone browser chat with `npx -p @alisaitteke/photoshop-mcp ui`. The UI supports experimental intent routing through TypeSafe AI's Jev model. When enabled with `TYPESAFE_API_KEY`, safe commands execute straight in Photoshop without spending LLM tokens. Generative fill features require an Adobe account.

Photoshop must be actively running on Windows or macOS for the server to work. The package requires Node.js 18 or newer and supports Photoshop releases from 2012 onward.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add photoshop-mcp -- npx -y @alisaitteke/photoshop-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add photoshop-mcp -- npx -y @alisaitteke/photoshop-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "photoshop-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@alisaitteke/photoshop-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "photoshop-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@alisaitteke/photoshop-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add photoshop-mcp npx -y @alisaitteke/photoshop-mcp
```

## When to use it
- Remove backgrounds while preserving an editable layer mask
- Retouch skin and fix tonal balance on portraits
- Slice wide documents into sequential carousel slides
- Apply watermarks across an entire photo folder
- Prepare graphics with correct sizing and sRGB profiles for export

## Example prompts
- Remove the background on this layer and keep an editable mask
- Smooth the skin and adjust tones on this portrait with medium strength
- Slice this wide banner into 5 slides for a carousel

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36398
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7506
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6114
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md