Photoshop MCP

Languages: English · 한국어 / Korean · 简体中文 · 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: 116 tools (100 atomic + 16 one-step recipes) — full list in docs/available-tools.md.

Related MCP server: Photoshop MCP Server

Try saying

Remove the background from this portrait — keep it editable with a mask.

Enhance this portrait — smooth the skin and fix the tones, medium intensity.

Prepare this design for web, then export Instagram and X post variants.

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+.

Free, no-API-key mode (this fork)

This fork adds an Ollama (local, free) provider to the standalone chat. It runs the model on your own computer, needs neither an API key nor a cloud account, and sends no prompts or images to an AI provider. Install Ollama, run ollama pull qwen3:8b, start the UI, then select Ollama (local, free). See the detailed bilingual guide: English · 한국어.

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, and security notes: docs/standalone-ui.md.

Option 2 — Inside your AI app (Cursor, Claude, VS Code)

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 116 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.

Maintainer

Built by Ali Sait Teke — GitHub · LinkedIn.

License

MIT

This privacy-focused fork disables anonymous usage analytics by default. See docs/anonymous-usage-analytics.md for details.