
Photoshop MCP by alisaitteke: Setup for Claude, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Photoshop MCP
Claude Code
- 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
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_backgroundSmooths 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_portraitSaves 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_webExports 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_variantsApplies 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_gradeSets 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_separationDrops 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_replaceRenames 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_layersFades 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_fadeSwaps 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_blendAdds 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_burnRemoves 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_distractionCuts a wide image into carousel slides
Splits the open document into equal vertical slices and saves them as numbered files for a swipeable Instagram or TikTok carousel.
Try: “Split this banner into a 5-slide carousel.”
Write ·
photoshop_recipe_split_carouselAdds a watermark to every photo in a folder
Applies your text or logo to each image in a folder (no subfolders) and saves watermarked JPEGs. The source files are never changed.
Try: “Watermark every photo in ~/Photos/shoot with my studio name.”
Write ·
photoshop_recipe_batch_watermarkTurns a portrait into a passport or ID photo
Removes the background, makes it white, crops with headroom and resizes to a US, EU or Turkish size at 300 DPI. Official acceptance is not guaranteed.
Try: “Make a US 2x2 passport photo from this portrait.”
Write ·
photoshop_recipe_passport_photoMakes one image per row of a spreadsheet
Turns a CSV file into Photoshop data sets, fills your template with each row and exports one image per row, like mail merge for name cards or certificates.
Try: “Make a badge for every row in attendees.csv using this template.”
Write ·
photoshop_recipe_csv_to_cardsAdds a sticker-style white border
Applies a solid stroke and an optional shadow to the active layer, or a double die-cut outline made from two stroked copies. It runs as one undo step.
Try: “Give this logo a die-cut sticker outline.”
Write ·
photoshop_recipe_sticker_outlineLists the files open in Photoshop
Returns each open document with its size, whether it is saved, how many artboards it has and which tab is active.
Try: “Which documents do I have open in Photoshop?”
Read ·
photoshop_list_documentsShows size, resolution and colour mode
Reads the active document's name, dimensions, resolution and colour mode without changing anything.
Try: “What size and resolution is the open document?”
Read ·
photoshop_get_document_infoLists the layers in the document
Returns every layer with its type, visibility and opacity, including layers inside groups.
Try: “Show me all the layers in this file.”
Read ·
photoshop_get_layersShows the assistant a picture of your work
Exports the active document as a JPEG preview so the assistant can check the result. It uses a temporary file that it deletes again.
Try: “Show me what the document looks like now.”
Read ·
photoshop_get_previewLists the undo history
Reads the history stack of the active document and marks the current state.
Try: “What steps have I done in this document so far?”
Read ·
photoshop_get_historyReports where the current selection is
Reads the edges of the active selection in pixels without changing it.
Try: “Where is my current selection?”
Read ·
photoshop_get_selection_boundsLists fonts Photoshop can use
Returns the installed fonts available to Photoshop.
Try: “Is Futura available in Photoshop?”
Read ·
photoshop_list_fontsLists the artboards in the document
Returns each artboard with its id, name and pixel bounds, and which one holds the active layer.
Try: “List the artboards in this file.”
Read ·
photoshop_list_artboardsLists the data sets in the document
Reads the variable data sets defined on the active document.
Try: “What data sets does this template have?”
Read ·
photoshop_list_datasetsCreates a new blank document
Makes an empty document with the width, height and colour mode you give.
Try: “Create a 1080 by 1080 RGB document.”
Write ·
photoshop_create_documentOpens an image file in Photoshop
Opens a file from disk as a new document and makes it the active one.
Try: “Open ~/Desktop/photo.jpg in Photoshop.”
Files ·
photoshop_open_imageSwitches to another open document
Brings a tab to the front by its id, position or name so later edits go to it.
Try: “Switch to the poster document.”
Write ·
photoshop_set_active_documentSaves the document as PSD, JPEG or PNG
Writes the active document to the path and format you give.
Try: “Save this as ~/Desktop/final.psd.”
Write ·
photoshop_save_documentCloses a document tab
Closes the active document or the one you name. Unsaved changes are written first only if the call asks to save.
Try: “Close the mockup document.”
Write ·
photoshop_close_documentExports a copy as PNG, JPEG, WebP or AVIF
Writes a copy of the document, or of one artboard, to a path without changing the open file. WebP and AVIF need a recent Photoshop.
Try: “Export this as a WebP to my desktop.”
Write ·
photoshop_export_asExports every artboard to a folder
Duplicates and crops each artboard, then saves one file per board in the format you choose. The original document is unchanged.
Try: “Export all artboards as PNGs into ~/Desktop/screens.”
Write ·
photoshop_export_artboardsAdds an empty layer
Creates a new empty layer above the active layer.
Try: “Add a new layer called Highlights.”
Write ·
photoshop_create_layerAdds a text layer
Creates a text layer with your wording, position, font and optional spacing, alignment and colour.
Try: “Add the title "Summer Sale" in bold white text at the top.”
Write ·
photoshop_create_text_layerDeletes the active layer
Removes the active layer with its pixels, mask and effects.
Try: “Delete the selected layer.”
Delete ·
photoshop_delete_layerSelects a layer by its name
Makes the layer with that exact name active, including layers inside groups.
Try: “Select the layer called Logo.”
Write ·
photoshop_select_layer_by_nameDuplicates the active layer
Copies the active layer and makes the copy active.
Try: “Duplicate this layer.”
Write ·
photoshop_duplicate_layerRenames the active layer
Changes the layer's name only. Pixels, order and visibility stay the same.
Try: “Rename this layer to Background copy.”
Write ·
photoshop_rename_layerShows or hides a layer
Turns the active layer on or off in the canvas.
Try: “Hide the watermark layer.”
Write ·
photoshop_set_layer_visibilitySets how see-through a layer is
Sets the active layer's opacity to a value from 0 to 100, replacing the current one.
Try: “Set this layer to 60 percent opacity.”
Write ·
photoshop_set_layer_opacityChanges a layer's blend mode
Sets the active layer's blend mode, such as Multiply or Overlay.
Try: “Set this layer to Multiply.”
Write ·
photoshop_set_layer_blend_modeLocks or unlocks a layer
Turns the all-lock flag on the active layer so it cannot be edited, or clears it.
Try: “Lock the background layer.”
Write ·
photoshop_set_layer_lockedTurns a text or smart object layer into pixels
Converts the active layer into an ordinary pixel layer. Text stops being editable afterwards.
Try: “Rasterize this text layer.”
Write ·
photoshop_rasterize_layerMerges all visible layers into one
Combines every visible layer. Hidden layers stay in the stack.
Try: “Merge all visible layers.”
Write ·
photoshop_merge_visible_layersFlattens the document to one layer
Merges everything into a single Background layer and discards hidden layers.
Try: “Flatten the image.”
Delete ·
photoshop_flatten_imageFills a layer with a solid colour
Paints the active layer, or only the current selection, with an RGB colour.
Try: “Fill the selection with red.”
Write ·
photoshop_fill_layerPaints a two-colour gradient
Draws a linear gradient between two colours on the active layer's pixels.
Try: “Fill this layer with a blue to white gradient.”
Write ·
photoshop_fill_gradientMoves a layer by an offset
Shifts the active layer by the number of pixels you give.
Try: “Move this layer 50 pixels to the right.”
Write ·
photoshop_move_layerMoves a layer to the top
Puts the active layer above all others.
Try: “Bring this layer to the front.”
Write ·
photoshop_move_layer_to_topMoves a layer to the bottom
Puts the active layer below all others.
Try: “Send this layer to the back.”
Write ·
photoshop_move_layer_to_bottomMoves a layer up one step
Raises the active layer by one position in the stack.
Try: “Move this layer up one.”
Write ·
photoshop_move_layer_upMoves a layer down one step
Lowers the active layer by one position in the stack.
Try: “Move this layer down one.”
Write ·
photoshop_move_layer_downPlaces a layer above or below another
Reorders the active layer relative to a layer you name: above, below, top or bottom.
Try: “Put this layer just below the Logo layer.”
Write ·
photoshop_move_layer_to_positionResizes a layer by a percentage
Scales the active layer from its centre or its corner. 100 leaves it unchanged.
Try: “Scale this layer to 50 percent.”
Write ·
photoshop_scale_layerRotates a layer
Turns the active layer around its centre by the degrees you give, clockwise when positive.
Try: “Rotate this layer 15 degrees.”
Write ·
photoshop_rotate_layerFits a layer to the canvas
Scales the active layer to the canvas size while keeping its proportions. It can fit inside or fill the whole canvas.
Try: “Make this layer fill the canvas.”
Write ·
photoshop_fit_layer_to_documentAdds a shadow, glow, stroke or bevel
Applies a layer effect such as drop shadow, outer glow, stroke or bevel and emboss to the active layer.
Try: “Add a soft drop shadow to this layer.”
Write ·
photoshop_apply_layer_stylePlaces an image file as a new layer
Adds a file from disk as a layer at the exact top-left position you give.
Try: “Place logo.png in the top-left corner.”
Write ·
photoshop_place_imageResamples the whole document
Changes the document to a new pixel width and height, scaling every layer.
Try: “Resize this image to 1200 by 800 pixels.”
Write ·
photoshop_resize_imageCrops the document to a rectangle
Cuts the canvas to the pixel box you give. Pixels outside it are deleted.
Try: “Crop to the top-left 1000 by 1000 pixels.”
Delete ·
photoshop_crop_documentBlends several photos into one
Loads two or more image files, turns them into a Smart Object and applies a stack mode such as median. Good for removing passers-by from aligned shots.
Try: “Median-stack these five photos to remove the tourists.”
Write ·
photoshop_image_stackSelects the main subject
Runs Select Subject on the active layer. It only makes a selection and adds no mask.
Try: “Select the person in this photo.”
Write ·
photoshop_select_subjectSelects a rectangle
Makes a rectangular selection from corner coordinates.
Try: “Select the box from 100,100 to 500,400.”
Write ·
photoshop_select_rectangleSelects an oval
Makes an anti-aliased elliptical selection inside the bounding box you give.
Try: “Select a circle in the middle of the canvas.”
Write ·
photoshop_select_ellipseSelects the whole canvas
Selects every pixel of the active document without changing layers.
Try: “Select everything.”
Write ·
photoshop_select_allClears the selection
Removes the current selection. Pixels stay as they are.
Try: “Deselect.”
Write ·
photoshop_deselectFlips the selection
Swaps what is selected with what is not.
Try: “Invert the selection.”
Write ·
photoshop_invert_selectionGrows the selection
Expands the current selection outward by a number of pixels.
Try: “Expand the selection by 10 pixels.”
Write ·
photoshop_expand_selectionShrinks the selection
Pulls the current selection inward by a number of pixels.
Try: “Shrink the selection by 5 pixels.”
Write ·
photoshop_contract_selectionSoftens the selection edge
Feathers the edge of the current selection by a radius.
Try: “Feather the selection by 8 pixels.”
Write ·
photoshop_feather_selectionSaves the selection as a channel
Stores the active selection in a new alpha channel so you can load it later.
Try: “Save this selection as a channel.”
Write ·
photoshop_save_selectionFills the selection from its surroundings
Runs Content-Aware Fill on the current selection.
Try: “Fill the selected area using content-aware fill.”
Write ·
photoshop_content_aware_fillAdds a mask from the selection
Creates a layer mask on the active layer that reveals the current selection.
Try: “Mask the layer to my selection.”
Write ·
photoshop_create_layer_maskRemoves the layer mask
Deletes the mask from the active layer without baking it in.
Try: “Remove the mask from this layer.”
Delete ·
photoshop_delete_layer_maskBakes the mask into the pixels
Applies the active layer's mask and removes it. Pixels the mask hid are deleted.
Try: “Apply the layer mask.”
Delete ·
photoshop_apply_layer_maskFades a layer with a gradient mask
Paints a linear black-to-white gradient on the layer mask channel for a soft blend.
Try: “Add a gradient mask so this layer fades out.”
Write ·
photoshop_apply_gradient_maskClips a layer to the one below
Creates a clipping mask on the active layer or one you name.
Try: “Clip this layer to the shape below it.”
Write ·
photoshop_create_clipping_maskReleases a clipping mask
Removes the clipping mask from the active layer or one you name.
Try: “Release the clipping mask on this layer.”
Write ·
photoshop_release_clipping_maskBlurs the active layer
Applies a Gaussian blur of the radius you give.
Try: “Blur this layer by 10 pixels.”
Write ·
photoshop_apply_gaussian_blurAdds motion blur
Blurs the active raster layer along an angle and distance.
Try: “Add a horizontal motion blur.”
Write ·
photoshop_apply_motion_blurBlurs while keeping edges
Applies Smart Blur to the active raster layer, useful for smoothing skin or simplifying backgrounds.
Try: “Smooth the background with a smart blur.”
Write ·
photoshop_apply_smart_blurSharpens the active layer
Applies Unsharp Mask with the amount, radius and threshold you set. It works on one layer.
Try: “Sharpen this layer a little.”
Write ·
photoshop_apply_sharpenExtracts edge detail
Applies the High Pass filter to the active raster layer, for sharpening or frequency separation.
Try: “Apply a high pass filter of 3 pixels.”
Write ·
photoshop_apply_high_passAdds grain
Applies Add Noise by percent, uniform or Gaussian, optionally in mono.
Try: “Add subtle film grain.”
Write ·
photoshop_apply_noiseChanges brightness and contrast
Applies Brightness and Contrast once to the pixels of the active layer. It does not make an adjustment layer.
Try: “Brighten this layer by 20.”
Write ·
photoshop_adjust_brightness_contrastShifts hue, saturation and lightness
Applies Hue and Saturation once to the pixels of the active layer.
Try: “Boost saturation by 15.”
Write ·
photoshop_adjust_hue_saturationRuns Auto Levels
Lets Photoshop set the black, white and gray points of the active layer. It has no strength setting.
Try: “Run auto levels on this layer.”
Write ·
photoshop_auto_levelsRuns Auto Contrast
Lets Photoshop choose the contrast of the active layer. It has no strength setting.
Try: “Run auto contrast.”
Write ·
photoshop_auto_contrastAdds a Curves adjustment layer
Creates a Curves layer on the document so you can reshape tones without touching pixels.
Try: “Add a curves layer to lift the shadows.”
Write ·
photoshop_adjust_curvesTurns the layer black and white
Removes the colour from the active layer.
Try: “Make this layer grayscale.”
Write ·
photoshop_desaturateInverts the colours
Flips every colour on the active layer to its opposite.
Try: “Invert this layer.”
Write ·
photoshop_invertApplies a colour lookup grade
Adds a Color Lookup layer using a built-in LUT name such as a film stock for a cinematic grade.
Try: “Apply a warm film LUT.”
Write ·
photoshop_apply_lutAdds a Vibrance layer
Boosts muted colours while protecting skin tones, as an adjustment layer.
Try: “Add vibrance to make colours pop.”
Write ·
photoshop_adjust_vibranceAdds an Exposure layer
Creates an Exposure adjustment layer with stops, offset and gamma.
Try: “Brighten the exposure by one stop.”
Write ·
photoshop_adjust_exposureAdds a warming or cooling filter
Creates a Photo Filter layer with a tint and density.
Try: “Add a warming filter at 25 percent.”
Write ·
photoshop_apply_photo_filterAdds a Gradient Map layer
Remaps tones to a gradient, black to white by default, for duotone or black-and-white looks.
Try: “Add a gradient map for a duotone look.”
Write ·
photoshop_apply_gradient_mapReplaces the words in a text layer
Swaps the text of the active text layer and keeps its font, colour and alignment.
Try: “Change the headline to "Winter Sale".”
Write ·
photoshop_update_text_contentSets the font and size
Changes the font family and size of the active text layer.
Try: “Make this text Helvetica Bold 48 pt.”
Write ·
photoshop_set_text_fontSets the text colour
Sets one RGB colour on the whole active text layer.
Try: “Make this text red.”
Write ·
photoshop_set_text_colorAligns the text
Sets left, centre, right or justified alignment on the whole text layer.
Try: “Center this text.”
Write ·
photoshop_set_text_alignmentSets spacing, size and colour together
Changes layer-wide typography: tracking, leading, point or paragraph box, alignment, font, size and colour.
Try: “Add more letter spacing to this heading.”
Write ·
photoshop_set_text_styleMixes styles inside one text layer
Applies different fonts, sizes and colours to parts of a single text layer.
Try: “Make the word Sale red and larger.”
Write ·
photoshop_set_text_rangesInstalls a font file for your user
Copies a .ttf, .otf, .ttc or .otc you already have into your user font folder and refreshes Photoshop's list. It does not download fonts.
Try: “Install ~/Downloads/Fredoka.ttf.”
Write ·
photoshop_install_fontConverts a layer to a Smart Object
Turns the active layer, or one you name, into an embedded Smart Object.
Try: “Convert this layer to a smart object.”
Write ·
photoshop_convert_to_smart_objectSwaps the picture inside a Smart Object
Replaces the embedded contents from an image file and keeps transforms, warps and smart filters.
Try: “Replace the screen in the mockup with screenshot.png.”
Write ·
photoshop_replace_smart_object_contentsOpens a Smart Object for editing
Opens the embedded file as the active document until you save and close it.
Try: “Open the smart object to edit it.”
Write ·
photoshop_edit_smart_object_contentsCopies a Smart Object independently
Creates an unlinked duplicate with its own embedded contents.
Try: “Duplicate this smart object as an independent copy.”
Write ·
photoshop_create_smart_object_via_copyAdds an artboard
Creates an artboard at a position you give or to the right of the existing ones.
Try: “Add a 1080 by 1920 artboard next to the others.”
Write ·
photoshop_create_artboardSelects an artboard
Targets an artboard by id or name so later edits apply to it.
Try: “Switch to the Mobile artboard.”
Write ·
photoshop_set_active_artboardLoads variable data sets from an XML file
Imports a Photoshop variables XML file into the open template so rows can be applied.
Try: “Import dataset.xml into this template.”
Write ·
photoshop_import_datasetsExports one file per data set
Applies each data set to the open document in turn and saves a copy of each into an output folder.
Try: “Generate every variant from the data sets into ~/Desktop/out.”
Write ·
photoshop_generate_from_datasetsFills a selection with AI from a prompt
Sends a text prompt to Adobe Firefly through Photoshop's Generative Fill to fill the selection. It may use your Adobe generative credits.
Try: “Fill the selected area with a wooden table.”
Write ·
photoshop_generative_fillRemoves selected content with AI
Uses Photoshop's AI Remove, or generative fill as a fallback, on the selection.
Try: “Remove the selected object.”
Write ·
photoshop_generative_removeExtends the canvas with AI
Grows the canvas past its edges and fills the new area with Generative Expand.
Try: “Expand this image 500 pixels to the right.”
Write ·
photoshop_generative_expandUpscales the document with AI
Enlarges the active document with Generative Upscale, which needs Photoshop 27 or later.
Try: “Upscale this image.”
Write ·
photoshop_generative_upscaleReplaces the sky with Photoshop's own tool
Runs Photoshop's native Sky Replacement when your version has it.
Try: “Replace the sky with a sunset.”
Write ·
photoshop_sky_replacementGenerates an image from a prompt
Uses Photoshop's Generate Image (Firefly) to create a picture from text.
Try: “Generate an image of a red bicycle on a beach.”
Write ·
photoshop_generate_imageApplies a Neural Filter
Runs a Photoshop Neural Filter such as skin smoothing, depth blur or colorize through a companion Photoshop plugin you install separately.
Try: “Colorize this black and white photo.”
Write ·
photoshop_neural_filterSteps back in history
Moves the active document back one or more history states.
Try: “Undo the last two steps.”
Write ·
photoshop_undoRe-does an undone step
Moves forward through history states you undid.
Try: “Redo that.”
Write ·
photoshop_redoPlays a recorded Photoshop action
Runs a named action from a named action set in the Actions panel. It runs whatever steps were recorded, which may delete layers or save files.
Try: “Play the action Vintage from the Default set.”
Delete ·
photoshop_play_actionRuns custom ExtendScript in Photoshop
Executes any ExtendScript (JSX) the assistant writes inside Photoshop, with no limits on what the script does. It is meant as a last resort when no other tool fits.
Try: “Run a script that lists every font used in this document.”
Delete ·
photoshop_execute_scriptUsed by the assistant behind the scenes
Gives a quick snapshot of Photoshop
Returns the active document, layer and selection in one cheap call. The assistant uses it to check where things stand.
Read ·
photoshop_get_stateReports which features your Photoshop has
Returns feature flags for the installed version, such as Generative Fill or Select Subject v2.
Try: “Does my Photoshop support Generative Fill?”
Read ·
photoshop_get_capabilitiesShows the Photoshop version
Returns the detected Photoshop version string.
Read ·
photoshop_get_versionChecks that Photoshop is reachable
Runs a tiny script to confirm Photoshop is installed, running and answering. It can add a feedback question or an update notice to the reply.
Read ·
photoshop_pingRecords your answer to a feedback question
Saves your answer to the product-feedback prompt that ping can show, locally, and may send an anonymous analytics event.
Write ·
photoshop_submit_feedback
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 to | npm 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 keys | No account or API key for the MCP server. The generative tools use your Adobe account inside Photoshop. |
| Data retention | Not 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
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 8Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- www.npmjs.com · npmjs.com
- github.com · github.com
- github.com · github.com
- github.com · github.com