alisaitteke/photoshop-mcp

Photoshop MCP – AI‑driven Photoshop assistant

What it is – A Node‑based tool that lets you talk to Adobe Photoshop in plain English. You type a request such as “remove the background from this portrait” and an LLM (or the optional Jev router) turns the request into a series of Photoshop commands that are executed as a single, undo‑able step.

Key capabilities

• Background removal, portrait retouch, colour‑grading, sky replacement, generative fill (requires an Adobe account).
• Batch operations – watermark a folder, create Instagram carousel slides, export web‑ready JPEGs.
• 128 built‑in “tools” (111 atomic actions + 17 recipes) that the AI can combine.
• Optional Jev routing: for 26 safe commands the request bypasses the LLM and is sent straight to Photoshop, saving API tokens.

How you use it

1. Install Photoshop (Windows/macOS, 2012+). Install Node 18+.
2. Run the built‑in UI with a single command:

   npx -p @alisaitteke/photoshop-mcp ui
   

   A browser‑based chat window appears. Sign in with an API key for Claude, Gemini, or use the built‑in Jev model (requires a TypeSafe API key).
3. Type natural‑language prompts; the tool plans the steps, talks to Photoshop via a bridge, and performs the edits.
4. You can also invoke the same bridge from AI‑centric editors like Cursor, Claude Code, or VS Code via an MCP plugin.

Architecture snapshot – The package runs a small server (the “MCP server”) that talks to Photoshop through its scripting interface, while an LLM (or Jev) generates a structured plan. Errors are parsed and fed back to the model for automatic retries.

Status – Beta (action‑plan feature flag). Community‑maintained, not officially affiliated with Adobe.

Where to learn more – Docs cover the tool list, UI setup, prompt templates, troubleshooting, and how to contribute.

---

All information is taken directly from the repository’s README.