io.github.alisaitteke/photoshop-mcp
MCP server for Adobe Photoshop — 118 tools (generative AI + recipes), standalone web UI. Control Ph…
Open source Open in the app JSON README (API)
About
MCP server for Adobe Photoshop — 118 tools (generative AI + recipes), standalone web UI. Control Ph…
Details
- Kind
- MCP servers
- Topic
- Media, design & games
- Publisher
- alisaitteke
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.7.5
- Stars
- 439
- Forks
- 49
- Last push
- 2026-09-12T19:01:30Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:24
- Updated
- 2026-09-08 01:01:06
- Origin id
io.github.alisaitteke/photoshop-mcp
README
# Photoshop MCP
<p align="center">
<a href="https://github.com/alisaitteke/photoshop-mcp">
<img src="./images/readme-hero-v2.png" alt="Photoshop MCP — tell Photoshop what you want, AI does the clicking" width="100%" />
</a>
</p>
**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://photoshop-mcp.com/)**
[](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)
[](https://github.com/alisaitteke/photoshop-mcp/releases)
[](docs/standalone-ui.md#action-plan-beta)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[]()
[](https://registry.modelcontextprotocol.io)
[](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)
[](https://photoshop-mcp.com/)
**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: 118 tools (102 atomic + 16 one-step recipes) — full list in
[`docs/available-tools.md`](docs/available-tools.md).
## Try saying
```
Remove the background from this portrait — keep it editable with a mask.
```
<img src="./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="./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="./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="./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`](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.
Details, providers, and security notes: [`docs/standalone-ui.md`](docs/standalone-ui.md).
### Option 2 — Inside your AI app (Cursor, Claude, VS Code)
[](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)
[](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`](docs/troubleshooting.md).
## Documentation
- [Available tools](docs/available-tools.md) — all 118 tools with parameters
- [Standalone UI](docs/standalone-ui.md) — providers, auth modes, Action Plan, security
- [Prompt layer](docs/prompt-layer.md) — prompt templates and recipes
- [Architecture](docs/architecture.md) — how the bridge works under the hood
- [Development](docs/development.md) — build from source, tests
## Contributing
Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
## 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`](docs/anonymous-usage-analytics.md).