← Back to directory
P

Photoshop MCP

Community
An MCP server that lets you control Adobe Photoshop in plain language, with 116 tools.
GitHub source repository ↗
★ 475 Stars Category · Other Very popular
60FMRS · C

Photoshop MCP turns Photoshop into something you can talk to: describe what you want, and the AI plans the steps while Photoshop executes them, with each multi-step recipe counting as a single undo. It exposes 116 tools covering everyday design work such as background removal, portrait retouching, export, carousels, bulk watermarking, color grading, and generative fill, and it plugs into Cursor, Claude Code, Claude Desktop, and VS Code over stdio, with a built-in web chat UI as an alternative. As an unofficial community project under the MIT license, it suits designers who want AI to simplify repetitive image work, but not environments without Photoshop or users with strict concerns about cloud AI and anonymous analytics; back up originals and stay mindful of batch operations and supply-chain risk.

Reliability
10/20
Security and permissions
9/20
Maintenance
13/20
Documentation
14/20
Setup experience
14/20
Read the FMRS scoring method →

Photoshop MCP is a community-maintained, open-source MCP server that lets AI assistants — such as Cursor, Claude, or its own built-in chat window — drive Adobe Photoshop through natural language. You describe what you want (for example, "remove the background from this portrait and keep it editable with a mask"), and the AI first checks the document state, then plans and executes the steps. Every multi-step "recipe" lands as a single undoable step in Photoshop. The project states it ships 116 tools (100 atomic tools plus 16 one-step recipes) covering background removal, portrait retouching (skin smoothing, tone fixes, dodge & burn), web and social export (sRGB, resizing, sharpening), carousel splitting, batch watermarking, color grading, sky replacement, and generative fill (Adobe account required). It requires Photoshop to be installed and running locally (Windows or macOS, version 2012+) plus Node.js 18+. It connects to MCP clients over stdio via the npm package @alisaitteke/photoshop-mcp, and can also launch a standalone web chat UI from the command line. Licensed under MIT, it is an unofficial project not affiliated with or endorsed by Adobe Inc., and it collects anonymous aggregated usage analytics by default, which can be disabled.

Setup

  1. Make sure Photoshop is installed and running locally (Windows or macOS, version 2012+), and install Node.js 18+.
  2. Option 1 (standalone chat window): run 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.
  3. Option 2 (inside your AI app): in Claude Code run claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp; or add this to your MCP client config (Cursor, Claude Desktop, VS Code, …): {"mcpServers":{"photoshop":{"command":"npx","args":["-y","@alisaitteke/photoshop-mcp"]}}}.
  4. To get the Photoshop icon in Cursor's MCP list, manually copy the plugin files into the local plugins directory as described in the README and reload the window.
claude_desktop_config.json
{"mcpServers":{"photoshop":{"command":"npx","args":["-y","@alisaitteke/photoshop-mcp"]}}}

Fit and risk

Best for

  • Designers and creators who want to drive Photoshop conversationally without writing scripts or code
  • Teams with repetitive or batch image work (watermarking, multi-platform export variants)
  • Users already working inside MCP clients such as Cursor or Claude Code
  • Workflows that need reversible, single-undo multi-step image operations

Not for

  • Environments without Photoshop installed or running (the project depends on local Photoshop)
  • Enterprises expecting official Adobe support or endorsement (this is an unofficial community project)
  • Sensitive scenarios where prompts or document content must never be sent to an AI provider
  • Environments that cannot install Node.js 18+ or fetch software via npm/npx

Required permissions

  • Read and modify documents open in local Photoshop (layers, masks, color, exports, etc.)
  • Run a local Node.js process that communicates with the MCP client over stdio
  • Access specified local image folders for batch processing
  • Use an AI provider API key, or reuse Claude Code / Gemini CLI account credentials, in standalone UI mode
  • Collect anonymous aggregated usage analytics by default (can be disabled)

Risks and side effects

  • AI-planned steps modify Photoshop documents directly; although recipes are single-undo, batch or broad operations can still cause unwanted changes, so keep backups of originals.
  • Generative AI features (generative fill, Firefly, etc.) require an Adobe account and may incur extra cost or be subject to service terms.
  • Using a cloud AI provider means prompt text and document information read by the AI may leave your machine.
  • It relies on a third-party npm package fetched and executed via npx, which carries supply-chain risk; pin versions and verify the package source.
  • Anonymous usage analytics are collected by default and should be turned off if privacy matters to you.
  • Batch operations modify or overwrite files in target folders, and misconfiguration can affect many files at once.

Troubleshooting

  1. If tools stop responding, first confirm Photoshop is running and is version 2012 or later.
  2. Check that Node.js 18+ is installed.
  3. Verify the MCP client config uses command npx with args -y @alisaitteke/photoshop-mcp, and restart the client if needed.
  4. Let the AI read the structured error and retry; common fixes are in docs/troubleshooting.md.
  5. For generative features, confirm a working Adobe account is signed in.
  6. To rule out network or proxy issues, verify npx can fetch @alisaitteke/photoshop-mcp.

Use cases

Background removal and subject isolation with a clean, editable mask
Portrait retouching: skin smoothing, tone fixes, dodge & burn setup
Web and social export: sRGB, sharpened, correctly sized for Instagram, X, and more
Carousel creation: split one wide design into seamless, numbered slides
Bulk watermarking: a whole folder of photos in one go, originals untouched
Color grading, sky replacement, and generative fill (Adobe account required)

Supported clients

CursorFull support
Claude CodeFull support
Claude DesktopFull support
VS CodeFull support