# photoshop-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/alisaitteke/photoshop-mcp  
**GitHub Stars:** 503  
**Views:** 1  
**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
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "photoshop-mcp": {
    "command": "npx",
    "args": ["-y","-p","@alisaitteke/photoshop-mcp","photoshop-mcp-ui"]
  }
}
```

## Documentation & README

# Photoshop MCP

<p align="center">
  <a href="https://github.com/alisaitteke/photoshop-mcp">
    <img src="https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/readme-hero-v2.png" alt="Photoshop MCP — tell Photoshop what you want, AI does the clicking" width="100%" />
  </a>
</p>

**Languages:** English · [简体中文](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/README.zh-CN.md) · [Español](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/README.es.md) · [Deutsch](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/README.de.md) · [日本語](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/README.ja.md) · [Türkçe](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/README.tr.md) · **[Website](https://photoshop-mcp.com/)**

[![npm version](https://img.shields.io/npm/v/@alisaitteke/photoshop-mcp.svg)](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)
[![GitHub release](https://img.shields.io/github/v/release/alisaitteke/photoshop-mcp?include_prereleases)](https://github.com/alisaitteke/photoshop-mcp/releases)
[![Action Plan](https://img.shields.io/badge/Action%20Plan-beta-amber.svg)](docs/standalone-ui.md#action-plan-beta)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.alisaitteke%2Fphotoshop--mcp-purple.svg)](https://registry.modelcontextprotocol.io)
[![MCP Toplist](https://mcptoplist.com/badge/io.github.alisaitteke%2Fphotoshop-mcp.svg)](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)
[![Website](https://img.shields.io/badge/website-photoshop--mcp-cyan.svg)](https://photoshop-mcp.com/)

[![Photoshop MCP Server MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/alisaitteke/photoshop-mcp/badges/card.svg)](https://glama.ai/mcp/servers/alisaitteke/photoshop-mcp)

**Chat with Photoshop like a colleague.** Describe what you want in plain words —
"remove this background", "resize these for Instagram" — and your AI assistant
does the clicking for you. Works with Cursor, Claude, or the built-in chat
window. No code, no scripts, no IDE required.

> **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.

## What can it do?

- ✂️ **Remove backgrounds** — subject isolated with a clean, editable mask
- 👤 **Retouch portraits** — skin smoothing, tone fixes, dodge & burn setup
- 🌐 **Export for web & social** — sRGB, sharpened, correctly sized for Instagram, X, and more
- 🎞️ **Make carousels** — split one wide design into seamless, numbered slides
- 💧 **Watermark in bulk** — a whole folder of photos in one go, originals untouched
- 🎨 **Color grade & more** — film looks, sky replacement, generative fill (Adobe account required)
- ⏪ **Stay safe** — every multi-step "recipe" is a single undo step in Photoshop

Under the hood: 122 tools (106 atomic + 16 one-step recipes) — full list in
[`docs/available-tools.md`](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/available-tools.md).

## Try saying

```
Remove the background from this portrait — keep it editable with a mask.
```

<img src="https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/recipe-remove-bg.svg" alt="Remove background: subject isolated on transparency" width="640" />

```
Enhance this portrait — smooth the skin and fix the tones, medium intensity.
```

<img src="https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/recipe-enhance-portrait.svg" alt="Enhance portrait: skin smoothing + auto tone in one undoable step" width="640" />

```
Prepare this design for web, then export Instagram and X post variants.
```

<img src="https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/recipe-prepare-web.svg" alt="Prepare for web: sRGB, downscale, sharpen, optimized JPEG" width="640" />

```
Split this wide banner into a 5-slide seamless Instagram carousel.
```

<img src="https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/recipe-carousel.svg" alt="Split one wide document into numbered carousel slides" width="640" />

More recipes (batch watermark, passport photos, CSV-driven cards, mockups, …) and
pre-engineered prompt templates: [`docs/prompt-layer.md`](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/prompt-layer.md).

## Get started

You need **Photoshop running** (Windows or macOS, any version 2012+) and **Node.js 18+**.

### Option 1 — Easiest: the built-in chat window

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

A chat window opens in your browser. Sign in with an AI provider API key — or
reuse your existing **Claude Code** / **Gemini CLI** account, no key needed.

![Standalone UI Screenshot](https://raw.githubusercontent.com/alisaitteke/photoshop-mcp/HEAD/images/frame_generic_light.png)

Details, providers, Action Plan (API key or CLI account), and security notes:
[`docs/standalone-ui.md`](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/standalone-ui.md).

### Option 2 — Inside your AI app (Cursor, Claude, VS Code)

**Cursor (shows the Photoshop logo in the MCP list):** install the plugin from **Customize → Plugins**, or search the [Cursor Marketplace](https://cursor.com/marketplace) for `photoshop-mcp` once it is listed. That package still launches `npx -y @alisaitteke/photoshop-mcp`; the plugin manifest is what supplies the icon.

Until the Marketplace listing is live, copy `.cursor-plugin/`, `mcp.json`, and `assets/` into `~/.cursor/plugins/local/photoshop-mcp` and reload the window — details in [CONTRIBUTING.md](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/CONTRIBUTING.md#cursor-marketplace). The Install-in-Cursor button and a raw `mcp.json` entry still work, but they show a generic icon.

[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)
[![Install in VS Code](https://img.shields.io/badge/Install%20in-VS%20Code-0098FF)](https://vscode.dev/redirect/mcp/install?name=photoshop&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40alisaitteke%2Fphotoshop-mcp%22%5D%7D)

Claude Code:

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

Or add this to your MCP client's config (Cursor, Claude Desktop, …):

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

## How it works

1. **You type** what you want in plain language.
2. **The AI plans** the steps, checking the document state first.
3. **Photoshop executes** — each recipe lands as one undoable step.

Something went wrong? The AI reads the structured error and knows what to try
next. Common fixes: [`docs/troubleshooting.md`](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/troubleshooting.md).

## Documentation

- [Available tools](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/available-tools.md) — all 122 tools with parameters
- [Standalone UI](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/standalone-ui.md) — providers, auth modes, Action Plan, security
- [Prompt layer](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/prompt-layer.md) — prompt templates and recipes
- [Architecture](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/architecture.md) — how the bridge works under the hood
- [Development](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/development.md) — build from source, tests

## Contributing

Contributions are welcome! Please read [CONTRIBUTING.md](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/CONTRIBUTING.md) before opening a PR.

## ❤️ Contributors & Credits

Thanks to all our contributors!

<a href="https://github.com/alisaitteke/photoshop-mcp/graphs/contributors"><img src="https://contrib.rocks/image?repo=alisaitteke/photoshop-mcp" alt="Contributors" /></a>

## Maintainer

Built by **[Ali Sait Teke](https://alisait.com)** — [GitHub](https://github.com/alisaitteke) · [LinkedIn](https://www.linkedin.com/in/alisait/).

## License

MIT

Anonymous, aggregated usage analytics are collected by default and can be
disabled anytime — details in [`docs/anonymous-usage-analytics.md`](https://github.com/alisaitteke/photoshop-mcp/blob/HEAD/docs/anonymous-usage-analytics.md).