MCP server for Adobe Photoshop — 128 tools (generative AI + recipes), standalone web UI. Control Ph…
io.github.alisaitteke/photoshop-mcp — Model Context Protocol (MCP) Server
This MCP server targets Adobe Photoshop. It provides a standalone web UI and exposes 118 tools combining generative AI and “recipes,” enabling programmatic control of Photoshop actions (including Photoshop scripting via ExtendScript/automation). It is distributed as an npm package and is associated with topics such as image editing, creative automation, and model-context-protocol.
🛠️ Key Features
MCP server for Adobe Photoshop
Standalone web UI
118 tools (generative AI + recipes)
Tooling focused on Photoshop scripting/automation
🚀 Use Cases
Automate Photoshop image-editing workflows
Use generative AI to drive Photoshop operations
Apply predefined “recipes” for repeatable edits
⚡ Developer Benefits
Integrates with Model Context Protocol (MCP)
Package available on npm (@alisaitteke/photoshop-mcp)
Repository includes multi-language documentation and a dedicated website
⚠️ Limitations
Scope is limited to Adobe Photoshop control; no other applications are indicated in the provided data
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
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.
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
🌐 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
code
Remove the background from this portrait — keep it editable with a mask.
code
Enhance this portrait — smooth the skin and fix the tones, medium intensity.
code
Prepare this design for web, then export Instagram and X post variants.
code
Split this wide banner into a 5-slide seamless Instagram carousel.
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
bash
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.
Standalone UI Screenshot
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:
bash
claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
Or add this to your MCP client's config (Cursor, Claude Desktop, …):