PlugWiki
Photoshop MCP logo

Photoshop MCP by alisaitteke: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@alisaitteke/photoshop-mcpalisaitteke/photoshop-mcp

Lets Claude, Cursor and other assistants edit your open Photoshop files: remove backgrounds, retouch portraits, resize, export and batch-process folders.

This is a community server by Ali Sait Teke, not an Adobe product. It runs on your computer and controls the copy of Photoshop you already have open, on Windows or macOS. Photoshop must be running, and you need Node.js 18 or newer. The one thing to know first: it includes a tool that runs any script the assistant writes inside Photoshop, and there is no read-only mode, so keep a copy of important files.

Good for

  • Designers who want to describe an edit instead of clicking through menus
  • Social media and e-commerce teams exporting many sizes or watermarking whole folders
  • Photographers who want portrait retouch layers set up in one step
  • Developers who want Cursor or Claude Code to drive Photoshop

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Photoshop MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Photoshop MCP server to Claude Code. Run this command:
    
    claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Photoshop running.

Photoshop must be running (Windows or macOS), and you need Node.js 18 or newer. The README says it works with any Photoshop version from 2012; Generative Fill and some other tools need a newer one. The command matches the README. The project-file option is adapted by us.

From the project README. Source.

Tools

  • Cuts the subject out and removes the background

    Unlocks a locked Background layer and runs Photoshop's own Remove Background, falling back to Select Subject or Color Range if that is missing. One undo reverts it.

    Try: “Remove the background from this portrait and keep it editable.”

    Write · photoshop_recipe_remove_background

  • Smooths skin and fixes tones on a portrait

    Builds a non-destructive retouch group with a low and a high detail layer plus an auto-tone curve. You pick low, medium or high strength.

    Try: “Enhance this portrait with medium intensity.”

    Write · photoshop_recipe_enhance_portrait

  • Saves a web-sized copy of your document

    Makes a copy, converts it to sRGB, shrinks the longest side (2048 px by default), sharpens it and saves a JPEG or PNG. Your original file is not touched.

    Try: “Prepare this design for web as a JPEG.”

    Write · photoshop_recipe_prepare_for_web

  • Exports one cropped image per social platform

    Center-crops and resizes the open document to each platform's size and saves one JPEG per platform. Different aspect ratios are cropped, not padded.

    Try: “Export Instagram and X post versions of this design.”

    Write · photoshop_recipe_export_social_variants

  • Applies a named colour look to the whole image

    Adds a layer group with a hue and saturation adjustment and a brightness and contrast tweak for a preset such as cinematic. It works on RGB documents only.

    Try: “Give this photo a cinematic color grade.”

    Write · photoshop_recipe_apply_color_grade

  • Sets up layers for hand retouching

    Builds a low and a high detail layer pair above the active layer so you can paint on texture and colour separately. It applies no smoothing itself.

    Try: “Set up frequency separation on this product photo.”

    Write · photoshop_recipe_frequency_separation

  • Drops each design into a mockup and exports it

    Goes through a folder of images, swaps each one into a named Smart Object in the open mockup file and exports a flattened JPEG per image.

    Try: “Render this mockup once for every logo in my logos folder.”

    Write · photoshop_recipe_batch_mockup_replace

  • Renames and groups messy layers

    Renames top-level layers with a consistent scheme and can group them by kind. It does not delete, merge or rasterize anything.

    Try: “Clean up the layer names in this document and group them by type.”

    Write · photoshop_recipe_organize_layers

  • Fades a layer into the background with a mask

    Adds a reveal-all mask if needed and paints a black-to-white gradient on it so the layer's edge blends softly. It runs as one undo step.

    Try: “Fade this subject into the background from the bottom.”

    Write · photoshop_recipe_gradient_fade

  • Swaps in a new sky from an image file

    Places the sky image you point to, adds a mask and fades it along the horizon. You must give it the file path of the sky picture.

    Try: “Replace the sky with ~/Pictures/sunset.jpg.”

    Write · photoshop_recipe_sky_blend

  • Adds a layer for lightening and darkening

    Creates a 50 percent gray layer in Overlay or Soft Light mode. You then paint white to lighten and black to darken. It does no retouching on its own.

    Try: “Set up a dodge and burn layer above the portrait.”

    Write · photoshop_recipe_dodge_burn

  • Removes whatever you have selected

    Uses generative remove when your Photoshop has it and Content-Aware Fill otherwise, then clears the selection. You must make a selection first.

    Try: “Remove the person I selected from the background.”

    Write · photoshop_recipe_remove_distraction

Read from the source code

Permissions

high risk · 8 things to watch

High risk

The assistant can run any script inside Photoshop and delete layers or pixels, and there is no read-only mode. Save a copy of anything important and watch the first few actions before you let it run a long job.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can run any script inside Photoshop

    One tool executes ExtendScript code the assistant writes, with no limits, so it can change or delete anything Photoshop can reach, including files on disk. There is no read-only mode, so keep a backup of important files. github.com

  • It can delete layers, masks and pixels

    Tools for deleting layers and masks, cropping, flattening and baking in a mask remove content. Our advice: save a copy before a long session, and use Photoshop history to step back. github.com

  • It can play recorded actions

    Playing an action runs whatever steps were recorded, which may delete layers or save files. Undo only reverts the history steps the action left behind. github.com

  • Anonymous analytics are on by default

    The server sends usage events (OS, CPU model, MCP client name, tool names) to hey.sideguard.io by default. Set ANALYTICS_DISABLED=1 (or the older alias POSTHOG_DISABLED=1) to turn it off; the provider code returns a no-op sender when either is set or when a stored opt-out exists. github.com

  • It writes files to paths you or the assistant name

    Save, export, batch and recipe tools write images to disk, and the font tool copies a font into your user font folder. Check the output folder in each prompt. github.com

  • Generative tools use Adobe Firefly and credits

    Generative fill, expand, upscale and image creation run through Photoshop and may use your Adobe generative credits. They need Photoshop 24 or newer. github.com

  • It checks npm for updates in the background

    The server looks up the latest release on the npm registry and can add an update notice to a reply. The tool descriptions name PSMCP_UPDATE_CHECK=0 to turn it off. github.com

  • Tool descriptions tell the assistant what to prefer

    The remove-background description says to call it once and stop, and lists tools not to use instead. This steers the assistant but does not limit what it can call. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks tonpm registry, for a background update check. Anonymous usage analytics server (hey.sideguard.io by default). Adobe Firefly through Photoshop, for the generative tools
Sign-in and keysNo account or API key for the MCP server. The generative tools use your Adobe account inside Photoshop.
Data retentionNot documented beyond the analytics page, which lists what is sent.

Questions

Is Photoshop MCP by alisaitteke official?

No. It is a community project by Ali Sait Teke, and its README says it is not affiliated with or endorsed by Adobe.

Which apps and Photoshop versions does it work with?

It runs in Claude Code, Claude Desktop, Cursor, VS Code and other apps that run local servers. You need Photoshop open on Windows or macOS (the README says any version from 2012) and Node.js 18 or newer. Some tools, such as Generative Fill, need a newer Photoshop.

Does it need an API key or an Adobe account?

No key is needed for the server itself. The generative tools use your own Adobe account in Photoshop and may use your generative credits.

Can it delete my work or run in read-only mode?

It can delete layers, masks and pixels, and it has no read-only mode. It can also run any script inside Photoshop, so save a copy of important files first.

Does it collect usage data?

Yes, anonymous usage analytics are on by default. They include your OS, CPU model, MCP client name and tool names, but not tool arguments or results, says the project. Set ANALYTICS_DISABLED=1 to turn it off.

Is it free?

Yes. The server is open source under the MIT license. You still need your own Photoshop subscription, and generative tools may use Adobe credits.

Does it work without Photoshop running?

No. Photoshop must be open, because the server controls the running app. If a call fails, ask the assistant to check the connection first.

How do I add it to Claude or Cursor?

Pick your app in the install box above and copy the command or config. Restart the app afterwards so it loads the tools.

Is the list of 128 tools complete?

Yes for the published 1.7.37 package: 111 single-step tools and 17 recipes that do a whole job in one call.

Information

updated Nov 2, 2026

Publisher
Community
Package
@alisaitteke/photoshop-mcp
Registry
npm
Transport
stdio
Auth
None
Version
1.7.37
License
MIT
Last commit
Oct 31, 2026
Open issues
5
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Other Adobe Photoshop MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 8
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com
  5. www.npmjs.com · npmjs.com
  6. github.com · github.com
  7. github.com · github.com
  8. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.