Photoshop Mcp

io.github.alisaittekePublished by GitHub account alisaittekev1.7.38Updated Nov 11, 2026

MCP server for Adobe Photoshop — 128 tools (generative AI + recipes), standalone web UI. Control Ph…

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

Local MCP server that lets an AI assistant drive Adobe Photoshop to edit images: remove backgrounds, retouch, export, watermark and more.

What you can do
  • Edit images in Photoshop: remove backgrounds with editable masks, retouch portraits, color grade, replace skies and generative fill
  • Export for web and social: sRGB, sharpened, correctly sized for Instagram and X
  • Produce multi-slide carousels from one wide design and batch-watermark whole folders
  • Run 128 tools (111 atomic plus 17 one-step recipes), each recipe landing as a single undo step
  • Optionally use a built-in browser chat window instead of an MCP client
When to use it
Use it when you want to describe image edits in plain language and have an assistant carry them out in a running Photoshop session, for example batch retouching, social-media export variants, or carousel splitting.
Requirements
Photoshop running on Windows or macOS (version 2012 or later) and Node.js 18+, launched via npx as a local stdio process. The optional standalone chat window needs an AI provider API key or an existing Claude Code or Gemini CLI account; the opt-in Jev routing needs TYPESAFE_API_KEY.
Before you install
The server performs write operations on Photoshop documents, including bulk watermarking of folders; recipes are undoable but merge and flatten are treated as hard to undo. With TYPESAFE_API_KEY set, prompts are sent to an external service; without it nothing is sent. It is an unofficial community project, not affiliated with Adobe, and generative fill requires an Adobe account.

Installation

In SourceWeft

  1. Open Photoshop Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Photoshop MCP

[Photoshop MCP — tell Photoshop what you want, AI does the clicking]

Languages: English · 简体中文 · Español · Deutsch · 日本語 · Türkçe · Website

[npm version] [GitHub release] [Action Plan] [Jev routing] [License: MIT] [TypeScript] [Platform] [MCP Registry] [MCP Toplist] [Website]

[Photoshop MCP Server MCP server – quality and maintenance score on Glama]

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

[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]

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.

bash
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.
[Remove background: subject isolated on transparency]
Enhance this portrait — smooth the skin and fix the tones, medium intensity.
[Enhance portrait: skin smoothing + auto tone in one undoable step]
Prepare this design for web, then export Instagram and X post variants.
[Prepare for web: sRGB, downscale, sharpen, optimized JPEG]
Split this wide banner into a 5-slide seamless Instagram carousel.
[Split one wide document into numbered carousel slides]

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.

[Install in Cursor] [Install in VS Code]

Claude Code:

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

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

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

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a PR.

❤️ Contributors & Credits

Thanks to all our contributors!

[Contributors]

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.

Source: README.md at commit d25cba0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

17
  1. v1.7.38LatestNov 11, 2026
  2. v1.7.37Oct 15, 2026
  3. v1.7.34Oct 8, 2026
  4. v1.7.33Oct 5, 2026
  5. v1.7.32Oct 1, 2026
  6. v1.7.30Oct 1, 2026
  7. v1.7.28Oct 1, 2026
  8. v1.7.27Sep 30, 2026
  9. v1.7.25Sep 30, 2026
  10. v1.7.24Sep 28, 2026
  11. v1.7.22Sep 27, 2026
  12. v1.7.21Sep 25, 2026
  13. v1.7.20Sep 22, 2026
  14. v1.7.19Sep 22, 2026
  15. v1.7.18Sep 21, 2026
  16. v1.7.15Sep 16, 2026
  17. v1.7.14Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts