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 · 简体中文 · Español · Deutsch · 日本語 · Türkçe · Website

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.

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.

Get started

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

Option 1 — Easiest: the built-in chat window

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, Action Plan (API key or CLI account), and security notes: 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 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. The Install-in-Cursor button and a raw mcp.json entry still work, but they show a generic icon.

Claude Code:

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

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

{
  "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.

Documentation

• Available tools — all 122 tools with parameters
• Standalone UI — providers, auth modes, Action Plan, security
• Prompt layer — prompt templates and recipes
• Architecture — how the bridge works under the hood
• Development — build from source, tests

Contributing

Contributions are welcome! Please read 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 — GitHub · LinkedIn.

License

MIT

Anonymous, aggregated usage analytics are collected by default and can be disabled anytime — details in docs/anonymous-usage-analytics.md.