@alisaitteke/photoshop-mcp weekly downloads statistics

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.

New: instant edits with Jev

<p align="center"> <a href="docs/standalone-ui.md#jev-intent-routing-experimental-opt-in"> <img src="./images/readme-hero-jev.png" alt="Jev routes each prompt before any LLM runs: one safe command goes straight to Photoshop with no LLM call; plans, visual checks and vague requests go to the LLM" width="100%" /> </a> </p>

Not every prompt needs a language model. The built-in chat window can now ask Jev, TypeSafe AI's System One model, where each message should go before any LLM runs. When Jev is confident you asked for one of 26 safe commands and recipes (undo, opacity, blend mode, remove background, color grade, split carousel, …), or a short chain of them like "black and white, then opacity 50", it runs in Photoshop straight away: no LLM call, no LLM tokens. Anything else, and hard-to-undo steps like merge or flatten, goes to the Action Plan.

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

Experimental and opt-in. Without the key the UI works exactly as before and nothing is sent to TypeSafe; with it, prompts also go to api.typesafe.ai. Routes, thresholds and the off switch: docs/standalone-ui.md.

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: 128 tools (111 atomic + 17 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 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)…