Photoshop MCP Server
Drive Adobe Photoshop from any MCP client: layers, selections, adjustments, type and export.
Connector by zachshallbetter · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/zachshallbetter-adobe-mcp-photoshop
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: ui-design
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 32 read · 144 write · 29 delete
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 205
Read from the source code; the running server may list different tools.
Read 32 · Look things up without changing anything.
activate_toolcalculate_channelschange_modeconvert_background_layerconvert_profileconvert_to_smart_objectconvert_type_layerfind_replace_layer_textget_artboardsget_document_infoget_document_metadataget_histogram
Show 20 more tools
get_layer_effectsget_photoshop_infoget_photoshop_preferencesget_print_optionsget_smart_object_infoget_timelinehelplist_action_setslist_channelslist_documentslist_fontslist_historylist_layerslist_pathsopen_documentopen_raw_filephotoshop_statuspick_colorsample_colorshow_photoshop_panels
Write 144 · Create, change, send or run things.
add_video_layeradd_video_transitionalign_layersapply_camera_raw_settingsapply_imageapply_neural_filterapply_transformapply_traparrange_layersarrange_photoshop_windowsassign_profileauto_align_layers
Show 132 more tools
auto_blend_layersclipboardclose_documentclose_documentscombine_imagescopy_layer_codecopy_layer_stylecreate_adjustment_layercreate_artboardcreate_channelcreate_documentcreate_dropletcreate_fill_layercreate_framecreate_layercreate_text_layercreate_timelinecrop_imagedefine_patterndraw_gradientdraw_vector_shapeduplicate_documentduplicate_layersedit_adjustment_layeredit_artboardsedit_fill_layeredit_photoshop_guidesedit_smart_objectexport_artboardsexport_imageexport_layer_compsexport_layersexport_paths_to_illustratorfade_filterfill_at_pointfill_contentsfill_pathfill_selectionfill_type_with_imageflatten_imagegenerate_imagegenerate_image_assetsgo_to_bridgegroup_layersharmonize_layerimport_video_frameslink_layerslock_layersmake_pdf_presentationmake_snapshotmanage_data_setsmanage_layer_stylemanage_recent_filesmanage_script_optionsmanage_style_presetsmask_by_color_rangemerge_channelsmerge_layersmodify_selectionnew_layer_viaplace_fileprint_imagequick_exportrasterize_layersrecord_measurementsrefine_maskrefine_selectionrender_videorepeat_last_filterreplace_skyresize_canvasresize_imageretouch_selectionreveal_allreverse_layer_orderrotate_canvasrun_action_batchrun_photoshop_menu_itemrun_type_menu_commandsave_documentsave_selectionscale_content_awareselect_allselect_areaselect_color_rangeselect_contentselect_layer_pixelsselect_view_toolset_action_optionsset_active_documentset_active_layerset_blending_optionsset_brush_settingsset_channelset_clip_timingset_clipping_maskset_clone_source_optionsset_color_preferencesset_color_tableset_colorsset_document_metadataset_file_handling_preferencesset_history_optionsset_layer_effectsset_layer_link_enabledset_layer_propertiesset_layer_selectionset_mask_propertiesset_measurement_scaleset_photoshop_preferencesset_pixel_aspect_ratioset_print_optionsset_proof_viewset_quick_maskset_smart_filter_visibilityset_textset_timelineset_tool_optionsset_type_optionsset_zoom_and_screen_modesplit_channelsstroke_pathstroke_selectionswap_colorstoggle_type_panelstoggle_view_extrastransform_layerstransform_selectiontrim_imageundowarp_layerswarp_perspective
Delete 29 · Delete, drop, revoke or wipe things.
apply_mattingdelete_layersedit_actionsedit_frame_animationedit_historyedit_layer_maskedit_path_pointsedit_vector_maskexecute_photoshop_codegenerative_filllayer_compsmanage_brushes
Show 17 more tools
manage_channelsmanage_count_itemsmanage_document_notesmanage_measurement_logmanage_pathsmanage_script_eventsplay_actionprocess_all_layerspurge_photoshop_cachesquit_photoshopremove_backgroundrun_automate_commandrun_photoshop_commandrun_timeline_commandset_layers_panel_viewset_stack_modeungroup_layers
Secrets and settings it asks for
Other settings (environment variables or headers).
PHOTOSHOP_ALLOWED_DIRSPHOTOSHOP_APP_NAMEPHOTOSHOP_SCRIPT_TIMEOUT_MS
Network hosts it talks to 2
github.com· found in codens.adobe.com· found in code
Files it touches
- Your home directory (~)
- Any path the agent passes to its tools
Tools (205)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
activate_toolChoose a tool in the Tools panel, such as a marquee, lasso, Quick Selection, Magic Wand, Crop, Perspective Crop, Eyedropper, Color Sampler, Ruler or Count tool, so it is ready for the user. Using a tool on the canvas is the user's; select_area, crop_image and manage_count_items do the same work by numbers
add_video_layerAdd a blank video layer above the active layer, for frame-by-frame painting (Layer > Video Layers > New Blank Video Layer)
add_video_transitionAdd a transition (Fade, Cross Fade, Fade With Black or Fade With White) where two adjacent clips meet in the video timeline (Timeline panel transitions)
align_layersAlign layers by their top, vertical centre, bottom, left, horizontal centre or right edges (Layer > Align), or distribute them evenly by those edges (Layer > Distribute; three or more layers). With toSelection, align them to the selection (Layer > Align Layers To Selection)
apply_camera_raw_settingsApply Filter > Camera Raw Filter to layers without its dialog, with the settings of its panels: Basic (white balance, exposure, contrast, highlights, shadows, whites, blacks, texture, clarity, dehaze, vibrance, saturation), Curve (parametric regions and splits, point curves, refine saturation), Detail (sharpening, noise reduction), Color Mixer (HSL), Color Grading (wheels, blending, balance), Optics (lens vignetting, defringe), Effects (vignette, grain) and Masking (local corrections through linear gradient, radial gradient and luminance range masks; these replace any local corrections the fil…
apply_imageBlend a source layer and channel, from this or another open document of the same pixel size, into the active layer (Image > Apply Image), with a blending mode, opacity, invert and preserve transparency; add and subtract take scale and offset. Works inside the selection when there is one
apply_mattingClean the edge pixels of a pixel layer (Layer > Matting): Defringe (replace fringe colours over a width in pixels), Remove Black Matte, Remove White Matte, or Color Decontaminate
apply_neural_filterRun a Neural Filter (Filter > Neural Filters) on the active layer without its workspace: Depth Blur, Style Transfer or Photo Restoration. The filter must already be downloaded in the Neural Filters panel; some filters process in the cloud and need a signed-in Adobe account
apply_transformTransform layers or a path numerically, as Free Transform's options bar does: move, scale, rotate and skew (Edit > Transform > Skew) around a reference point; repeat the last transform (Edit > Transform > Again); or transform a duplicate, keeping the original. With path, transforms the path's points (Edit > Transform Path)
apply_trapAdd trapping to a CMYK document (Image > Trap): overlaps between adjacent colours that hide misregistration on press. The document must be in CMYK mode
arrange_layersChange the stacking order: bring to front, bring forward, send backward, send to back, or place above, below or inside another layer or group
arrange_photoshop_windowsArrange document windows (Window > Arrange): tile, 2-up to 6-up, consolidate to tabs, cascade, float, open a new window for the active document, or match zoom, location or rotation across windows
assign_profileAssign a colour profile to the active document without converting its colour values (Edit > Assign Profile): a profile name, the working space, or none (Don't Color Manage). Use convert_profile to keep the appearance instead
auto_align_layersLine up overlapping photos of the same scene (Edit > Auto-Align Layers) by their content, with the Auto or Perspective projection, optionally removing vignetting and correcting geometric distortion. Pixel layers only: not adjustment, vector or Smart Object layers
auto_blend_layersBlend aligned layers into one seamless image (Edit > Auto-Blend Layers): a panorama, or a focus stack that keeps the sharpest areas of each layer, with Seamless Tones and Colors. RGB or Grayscale; not for Smart Objects, video, 3D or the background layer
Show 190 more tools
calculate_channelsBlend two source channels into a new alpha channel (Image > Calculations): each source is a layer (or merged) and channel, from this or another open document of the same pixel size, optionally inverted; with a blending mode and opacity
change_modeConvert the image to another colour mode (Image > Mode): RGB, CMYK, Grayscale, Lab, Bitmap, Indexed Color or Multichannel, and/or another bit depth. Indexed Color takes the palette, colours, forced colours, transparency, matte and dither of its dialog; Bitmap (from Grayscale) takes the method, output resolution and halftone screen. Returns the document with its mode. Converting can flatten or discard information
clipboardCopy, copy merged, cut or clear the selection on the active layer, or paste as a new layer: paste, paste_into the selection, paste_in_place (Edit > Paste Special > Paste in Place: at the copied pixels' original position) or paste_outside the selection (Paste Outside: the selection is masked out)
close_documentClose the active document. Unsaved changes are discarded unless save is true
close_documentsClose every open document (File > Close All). Unsaved changes are discarded unless save is true; with save, documents that have never been saved are refused before anything closes
combine_imagesCombine image files into a new document with one of Photoshop's multi-file commands, without its dialog: stack (File > Scripts > Load Files into Stack), photomerge (File > Automate > Photomerge panorama), hdr (File > Automate > Merge to HDR Pro, with its last-used settings) or statistics (File > Scripts > Statistics stack mode). Large merges can outlast the script timeout
convert_background_layerTurn the background layer into a normal layer that can move and hold transparency, or make a layer the background
convert_profileConvert the image to another colour profile (Edit > Convert to Profile) with a rendering intent, black point compensation and dither
convert_to_smart_objectBundle layers into one embedded smart object (Layer > Smart Objects > Convert to Smart Object), or convert a layer so filters applied to it stay editable as Smart Filters (Filter > Convert for Smart Filters)
convert_type_layerConvert type layers (Type menu): to paragraph or point type, to a shape layer (Convert to Shape), to a work path (Create Work Path, which replaces the current work path), or to a selection shaped like the text, as the Type Mask tools make
copy_layer_codeCopy CSS for shape and type layers (size, position, colours, gradients, shadows, type settings), or SVG markup for a shape layer, to the clipboard (Layers panel context menu: Copy CSS, Copy SVG)
copy_layer_styleCopy one layer's style to other layers (Layer > Layer Style > Copy Layer Style, then Paste Layer Style, which replaces their styles), or copy only some effects, added to their own styles as Option/Alt-dragging an effect does
create_adjustment_layerDescription is built at runtime.
create_artboardCreate an artboard: new at a position and size (Layer > New > Artboard), from layers (Artboard from Layers), from a group (Artboard from Group), or a new document of type Artboard (File > New). The steps in the document form one history state
create_channelAdd an alpha channel (Channels panel > New Channel) whose colour shows masked or selected areas, or a spot colour channel (New Spot Channel) with its ink colour and solidity; optionally filled from the selection (Save Selection as Channel)
create_documentCreate a document (File > New, Preset Details) with a size in pixels, resolution, colour mode, bit depth, background fill, pixel aspect ratio and optional colour profile, optionally as an artboard document
create_dropletSave an action as a droplet: an application that plays the action on files dropped onto it, with Batch's open, save and naming options (File > Automate > Create Droplet)
create_fill_layerDescription is built at runtime.
create_framePut layers inside a frame (Add Frame to Layers) or turn a group into a frame (Add Frame To Layer Group); the frame clips its contents to its shape
create_layerAdd a new empty pixel layer or a group above the active layer, or inside a group
create_text_layerAdd a type layer: point type at a position, or paragraph type in a box (width and height), with its font, size, colour and formatting. Line breaks in text start new paragraphs
create_timelineCreate a video timeline or a frame animation for the document, or convert between the two (Timeline panel: Create Video Timeline, Create Frame Animation, Convert to Frame Animation, Convert to Video Timeline)
crop_imageCrop the image to a rectangle (Image > Crop, or the Crop tool), optionally rotating the crop and resampling the result to a size. Bounds reaching outside the canvas extend it, as dragging the Crop tool past the edge does
define_patternSave the selection, an area or the whole image as a pattern (Edit > Define Pattern), for pattern fill layers and fills. The area must be a plain rectangle; without one, the selection is used, or the whole image when nothing is selected
delete_layersDelete layers or groups (with everything inside them)
draw_gradientDraw a classic gradient on the active layer, inside the selection if there is one, from one point to another (Gradient tool in Classic gradient mode): linear, radial, angle, reflected or diamond, with colour and opacity stops, reverse, dither, transparency and interpolation. Without colours it runs from the foreground to the background colour
draw_vector_shapeDraw with the shape and pen tools: rectangles (with rounded corners), ellipses, triangles, polygons, stars, lines, custom shape presets and pen points, combined with path operations. Mode shape makes a shape layer filled with a colour; path adds a path to the Paths panel; pixels fills the shape on the active layer
duplicate_documentDuplicate the active document (Image > Duplicate), optionally merged into one layer
duplicate_layersDuplicate layers or groups (Layer > Duplicate Layer), placed above each original, optionally renamed
edit_actionsChange the Actions panel: create an empty set, delete a set, an action or one of its steps, clear every set, reset to Default Actions, load an .atn file or one of Photoshop's bundled sets, or save a set as an .atn file (Actions panel menu)
edit_adjustment_layerDescription is built at runtime.
edit_artboardsChange artboards: set name, position, size, background colour and auto-nesting (Properties panel), duplicate one, ungroup them back to layers (Layer > Ungroup Artboards), clear their guides (View > Guides > Clear Selected Artboard Guides), add guides from a shape (New Artboard Guides From Shape), or pick the Artboard or Frame tool
edit_fill_layerDescription is built at runtime.
edit_frame_animationEdit a frame animation (Timeline panel in frame mode): new, delete, copy, paste, reverse or tween frames, select a frame, make frames from layers, flatten frames into layers, match a layer across frames, delete the animation, and the New Layers options. Tween and Paste Frames use the dialog's last settings
edit_historyChange the history: revert to the last save (File > Revert), delete a state or snapshot, clear the history, make a new document from a state, set the history brush source or pick the History Brush tool (History panel), or purge every document's history (Edit > Purge > Histories). Clearing and purging cannot be undone
edit_layer_maskWork with layer masks (Layer > Layer Mask and the Layers panel): add a mask (Reveal All, Hide All, Reveal Selection or Hide Selection), apply it to the pixels, delete it, disable or enable it, link or unlink it from the layer, invert it, target the mask or the layer content for editing, load the mask as a selection, or copy or move it to another layer
edit_path_pointsEdit a path's anchor points, as the Add Anchor Point, Delete Anchor Point, Convert Point and Direct Selection tools do: add a point (splitting a segment in half without changing its shape, or at a position), delete one, move a point or its direction handles, convert it between smooth and corner, or change a component's path operation. The path is rebuilt under its name; a work path becomes a saved path
edit_photoshop_guidesWork with guides in the active document (View > Guides): add guides at pixel positions, lay out columns, rows and margins (New Guide Layout), make guides from the selected shape layer (New Guides From Shape), clear all guides or only canvas guides, or clear slices (View > Clear Slices). Returns the guides afterwards
edit_smart_objectSmart object commands (Layer > Smart Objects): New Smart Object via Copy, Edit Contents (opens the source as the active document; save and close it to update the layer), Replace Contents, Export Contents, Relink to File (also resolves a broken link), Update Modified Content, Update All Modified Content, Embed Linked, Embed All Linked, Convert to Linked, Reset Transform, Convert to Layers, and choosing which layer comp of the placed document shows (Properties panel)
edit_vector_maskWork with vector masks (Layer > Vector Mask): make one from a path (Current Path), disable or enable it, or delete it. Rasterize a vector mask with rasterize_layers
execute_photoshop_codeRun your own ExtendScript in Photoshop and return its last expression. It runs unrestricted: it can change or delete anything and read or write files. Prefer the specific tools
export_artboardsSave each artboard as its own file, cropped to the artboard with its background, as PNG, JPEG, PSD, TIFF or PDF (File > Export > Artboards to Files), or all of them as one multi-page PDF (Artboards to PDF). The document is not changed
export_imageExport the document as one PNG, PNG-8, JPEG or GIF file (Save for Web), optionally resized. Works on a temporary copy, so the document is unchanged
export_layer_compsExport layer comps, each to its own file (File > Export > Layer Comps to Files) or as the pages of one PDF (Layer Comps to PDF). The document is returned to its state before the export
export_layersExport each top-level layer or group (or the ones chosen) to its own file, named <prefix><layer name>.<ext>, by showing one at a time on a temporary copy (File > Export > Layers to Files)
export_paths_to_illustratorExport paths as an Adobe Illustrator file (File > Export > Paths to Illustrator): all paths, one named path, or just the document bounds
fade_filterFade the filter, adjustment or paint stroke just applied: blend it with what was there before at an opacity and blend mode (Edit > Fade). Only works directly after that edit
fill_at_pointFill (Paint Bucket tool) or erase (Magic Eraser tool) the area of similar colour around a point on the active layer, within the selection if there is one. Erasing on the Background layer turns it into an ordinary layer, as the Magic Eraser does
fill_contentsFill the selection (or the whole layer when nothing is selected) on the active layer with the foreground or background colour, black, 50% gray, white, a pattern, a History state, or Content-Aware fill (Edit > Fill). A pattern fill can run one of the scripted patterns Photoshop ships (Edit > Fill > Pattern > Script: Brick Fill, Cross Weave, Place Along Path, Random Fill, Symmetry Fill) with its settings given here instead of in its dialog. Content-Aware needs a selection and fills it directly, without the Content-Aware Fill workspace. For a specific colour use fill_selection
fill_pathFill the area inside a path on the active layer with a colour (Paths panel > Fill Path), with blend mode, opacity, feather and anti-aliasing. Give a path from the Paths panel or points for a temporary one
fill_selectionFill the selection on the active layer with a colour (Edit > Fill), with a blend mode, opacity and optionally preserving transparency
fill_type_with_imageFill type with an image: move an image layer directly above a type layer and clip it to the type (Layer > Create Clipping Mask), so the image shows only through the letters
find_replace_layer_textFind and replace text in type layers (Edit > Find and Replace Text), keeping each layer's formatting. Searches every visible, unlocked type layer, or one layer. Line breaks in the replacement start new paragraphs
flatten_imageFlatten every layer into a background layer (Layer > Flatten Image), or merge only the visible layers (Merge Visible)
generate_imageGenerate Image (Edit > Generate Image): create an image from a text prompt as a new layer filling the active document. Needs Photoshop signed in to an Adobe account and an internet connection; uses generative credits
generate_image_assetsSet up Generator image assets (File > Generate > Image Assets): name layers with asset specs such as "icon.png", "200% hero@2x.png24" or "50x50 thumb.jpg80%" so Generator writes them to a folder next to the PSD, set the document-wide defaults layer ("default 200% @2x/"), and turn Image Assets on or off for the document
generative_fillGenerative Fill (Edit > Generative Fill) inside the current selection: generate content from a prompt, or with an empty prompt remove what is selected and fill from the surroundings. Results go to a new Generative Layer. Needs a selection, Photoshop signed in to an Adobe account and an internet connection; uses generative credits
get_artboardsList the active document's artboards with id, name, position and size in pixels, layer count and background (Artboard properties in the Properties panel)
get_document_infoDescribe the active document: size in pixels, resolution, mode, bit depth, colour profile, layer count, active layer, channels, guides, selection bounds and history
get_document_metadataRead the active document's File Info metadata: title, author, description, keywords, copyright, IPTC origin, categories, the camera data (Exif), and optionally the raw XMP packet
get_histogramRead the histogram (Histogram panel) of the composite image or of one channel: the pixel count at each of the 256 levels, with the total, mean and median
get_layer_effectsDescribe layers' styles: whether effects are shown, and each effect and instance with whether it is on and, with detail, all its settings
get_photoshop_infoDescribe the running Photoshop (About Photoshop, System Info): version, build, locale, free memory, the preferences folder, the file types it opens, the script dialog mode, and optionally the full System Info report or whether named features are enabled
get_photoshop_preferencesRead Photoshop's preferences (Photoshop > Settings, or Edit > Preferences on Windows) that scripts can reach: general, interface, file handling, performance, cursors, transparency, units and rulers, guides and grid, plug-ins, type, and the script dialog mode
get_print_optionsRead the active document's print settings (File > Print): the printer and the printers available, copies, colour handling, print space, rendering intent, position and scale, printing marks, functions and PostScript options
get_smart_object_infoDescribe smart object layers: whether they are linked or embedded, their source file, the layer comps of the placed document and which one shows, and their Smart Filters in order with whether each is on
get_timelineDescribe the document's timeline (Timeline panel): frame rate, playhead time, duration and work area when Photoshop reports them, the frame count in frame animation mode, and the video layers
go_to_bridgeOpen Adobe Bridge (File > Browse in Bridge), or close the active document and switch to Bridge (File > Close and Go to Bridge). Needs Bridge installed
group_layersPut layers into a new group (Layer > Group Layers), placed where the first of them was; they keep the order given
harmonize_layerHarmonize a layer with the image beneath it (the Properties panel's Harmonize): match its light, colour and shadows to the background. Results go to a new layer. Needs Photoshop signed in to an Adobe account and an internet connection; uses generative credits
helpList the tools by area, or describe one tool's parameters
import_video_framesImport a video file's frames as layers of a new document, optionally as a frame animation (File > Import > Video Frames to Layers)
layer_compsWork with layer comps (Layer Comps panel): list, create, apply, update (recapture) or delete one; apply the previous or next comp; change a comp's options (Layer Comp Options); duplicate a comp; go back to the Last Document State; or clear a comp's warning (Clear Layer Comp Warning; every comp when no name is given)
link_layersLink layers together so they move and transform as one, or unlink them
list_action_setsList the Actions panel's action sets and the actions in each, optionally with each action's recorded steps (Window > Actions)
list_channelsList the Channels panel: each channel's name, kind (component, alpha masked or selected areas, spot colour), visibility, opacity or spot solidity, colour, and whether it is targeted
list_documentsList open documents with their size in pixels, resolution, colour mode, bit depth, file and whether they have unsaved changes
list_fontsList installed fonts with their PostScript name, family and style, filtered by a search string
list_historyList the History panel's states and snapshots, and which one is current
list_layersList the layers and groups, top to bottom, with id, name, kind (pixel, text, smart object, adjustment, shape...), visibility, opacity, blend mode, lock, bounds in pixels and parent group. Ids are what other tools take in target.ids
list_pathsList the Paths panel: each path's index, name and kind (saved path, work path, clipping path, vector or type mask) and its number of components; optionally every component's anchor points and direction handles, in pixels
lock_layersApply locks to layers, optionally to every layer inside the target groups (Layer > Lock Layers, Lock All Layers in Group). Locks not listed are turned off; an empty list unlocks
make_pdf_presentationCombine image files into one multi-page PDF or a full-screen PDF slideshow (File > Automate > PDF Presentation), in the order given (a file may repeat), optionally adding the open documents, with slideshow timing, looping and transitions, file names on the pages, and Photoshop PDF save options
make_snapshotSave the current state as a History snapshot, so it can be returned to later
manage_brushesBrush presets and files (Brushes panel and its menu): load a brush file (.abr) as the current tool's brush (Import Brushes), save the current tool's brush to a file (Export Selected Brushes), define a preset from the selection, or the whole image when nothing is selected (Edit > Define Brush Preset), save the current brush and its settings as a new preset (New Brush Preset), rename or delete a preset, or restore the default brushes (Reset Brushes), replacing the current set or appending to it
manage_channelsTarget channels for editing (clicking them in the Channels panel), duplicate a channel (into this or another open document), delete alpha or spot channels, or merge spot channels into the colour channels (Merge Spot Channel, which flattens the image)
manage_count_itemsList, add, remove or clear the Count tool's numbered markers (count items) in the document. Positions are pixels from the top-left corner; indexes start at 0
manage_data_setsWork with variable data sets on the active document: import them from a text file (File > Import > Variable Data Sets), apply one (Image > Apply Data Set), or save a PSD per data set into a folder (File > Export > Data Sets as Files). Variables themselves are defined in Image > Variables > Define
manage_document_notesWork with notes (non-printing annotations): import the notes from a PDF or FDF file into the active document (File > Import > Notes), delete all of its notes (Note tool: Clear All), choose the Note tool, or show or hide the Notes panel (Window > Notes). Writing a note's text is done by hand with the Note tool
manage_layer_styleLayer style commands (Layer > Layer Style): Clear Layer Style, Rasterize Layer Style (bake the effects into pixels), Scale Effects by a percentage, or hide or show all of a layer's effects
manage_measurement_logWork with the Measurement Log panel (Window > Measurement Log): export all or the selected measurements to a tab-delimited text file, delete them, select or deselect all rows, toggle Auto Display Panel, or show or hide the panel
manage_pathsPaths panel commands: rename, duplicate or delete a path; select or deselect it (Path Selection); load it as a selection (Make Selection); make a work path from the selection (Make Work Path); make it the clipping path; fill or stroke it on the active layer; save it as a custom shape preset (Edit > Define Custom Shape); or show/hide the Paths panel
manage_recent_filesList the files in File > Open Recent, open one of them by its index, or clear the list (Clear Recent File List)
manage_script_eventsList, add or remove the scripts and actions Photoshop runs when an event happens, and turn them on or off (File > Scripts > Script Events Manager)
manage_script_optionsStore, read or erase named values that persist in Photoshop between sessions (Application.putCustomOptions, getCustomOptions and eraseCustomOptions), for keeping settings across calls
manage_style_presetsUse the Styles panel: apply a loaded style preset to layers by name (replacing their styles), load a style library (.asl) into the panel, or save the panel's styles as a library (Styles panel menu: Load Styles, Save Styles)
mask_by_color_rangeMake a layer's mask from a colour range (Properties panel, masks: Color Range): a sampled colour with a fuzziness, or a preset range such as reds, highlights or skin tones. Replaces the layer's existing mask
merge_channelsCombine open grayscale documents of the same pixel size into one image (Channels panel > Merge Channels): three into RGB or Lab, four into CMYK, or two or more into Multichannel, in channel order (e.g. red, green, blue)
merge_layersMerge a layer into the one below (Merge Down), or merge a group into one layer (Merge Group)
modify_selectionModify the selection (Select > Modify): expand, contract, feather, smooth or border by pixels; grow or select similar colours by tolerance
new_layer_viaMake a new layer from existing pixels (Layer > New): Layer via Copy copies the selected pixels (or the whole layer when nothing is selected) to a new layer; Layer via Cut moves the selected pixels to a new layer; Stamp Visible merges a copy of every visible layer into a new layer above the target and keeps the originals
open_documentOpen a file (File > Open, Open As): PSD, PSB, TIFF, JPEG, PNG, GIF, BMP, PDF, EPS, DCS, camera raw and DNG, HEIF, WebP, AVIF, JPEG XL, JPEG 2000, OpenEXR, Radiance, Cineon, DICOM, IFF, PCX, PICT, Pixar, PBM, Scitex CT, Targa, WBMP, Photoshop 2.0, Photoshop Raw, video and audio (as video layers), or a .psdt template (which opens as a new untitled document). openAs reads the file as PDF, EPS, Photoshop Raw or DICOM with that format's options, also when the extension does not match the contents
open_raw_fileOpen a camera raw file through Camera Raw without its dialog, with the camera's defaults, the settings last used, or custom Basic, Detail, Lens and Calibration values and Workflow Options (colour space, bit depth, size, resolution). These are the object model's older Camera Raw controls
photoshop_statusCheck that Photoshop is reachable: platform, how the server addresses Photoshop, whether it is running, its version and open documents. Use this first when a call fails to connect
pick_colorWork with a colour the way the Color Picker and Color panel do: give a colour in any model (or read the current foreground or background colour) and get its HSB, RGB, Lab, CMYK, grayscale and hex values, whether it is web-safe and the nearest web-safe colour (Only Web Colors); optionally snap it to web-safe and make it the foreground or background colour
place_filePlace an image, PDF, vector or other file in the active document as a smart object (File > Place Embedded), or as a smart object linked to the file (File > Place Linked), positioned, scaled and rotated
play_actionPlay an action from the Actions panel by its name and set. Dialogs in the action stay closed and use their recorded settings
print_imagePrint the active document with its print settings and no Print dialog (File > Print), or print one copy with the current settings (File > Print One Copy). Set the printer and options first with set_print_options
process_all_layersRun a command on every layer of the document: Delete Hidden Layers (Layers panel menu) or Rasterize All Layers (Layer > Rasterize > All Layers)
purge_photoshop_cachesFree memory with Edit > Purge: the undo buffer, the clipboard, the histories of open documents, or all of them. It cannot be undone
quick_exportQuick Export the whole document, or chosen layers, groups or artboards, as PNG, JPG or GIF into a folder in one step (File > Export > Quick Export As; Layers panel > Quick Export As). Files are named after the document or each layer
quit_photoshopQuit Photoshop (File > Exit, or Photoshop > Quit Photoshop on macOS). Refuses while documents have unsaved changes unless discardUnsaved is true, which closes them without saving first
rasterize_layersRasterize type, shape, smart object or fill layers into pixels (Layer > Rasterize), or only one part of them
record_measurementsRecord measurements to the Measurement Log (Image > Analysis > Record Measurements) from the selection, the Ruler tool's line or the Count tool's items, with a chosen set of data points. The ruler source needs a line drawn with the Ruler tool
refine_maskRefine a layer mask's edges as Select and Mask does, writing the result back to the layer mask. Without a mask, the current selection is refined into a new mask
refine_selectionRefine the selection's edge as Select and Mask does, without opening the workspace: edge detection radius (optionally smart), smooth, feather, contrast, shift edge and colour decontamination, output to the selection, a layer mask, a new layer or a new document
remove_backgroundRemove the background of layers (the Properties panel's Remove Background quick action): Photoshop finds the subject and adds a layer mask hiding the rest. It uses the Select Subject model, which may process in the cloud depending on Preferences > Image Processing
render_videoRender the timeline to a video file through Adobe Media Encoder (File > Export > Render Video), at the document size
repeat_last_filterApply the last filter again, with the same settings, to layers (Filter > Last Filter). A filter must have been applied in this Photoshop session
replace_skyReplace the sky in the active document (Edit > Sky Replacement) with an image file, without the dialog. Photoshop finds the sky, adds a Sky Replacement group with the new sky and lighting and colour layers, and returns it. Edge, brightness, temperature, lighting and colour settings match the dialog's
resize_canvasChange the canvas size (Image > Canvas Size) in pixels, keeping the image anchored at a side or corner. New areas take the Canvas Extension Color on a background layer (the background colour unless extensionColor is given) and stay transparent elsewhere
resize_imageResize the image (Image > Image Size): width and/or height in pixels (the other follows the aspect ratio when omitted), resolution, and the resampling method, with noise reduction for Preserve Details and optionally scaling layer styles (Scale Styles). With resample "none", only the resolution changes and the pixels stay as they are
retouch_selectionRepair or move the selected area on the active pixel layer by an offset: patch it from nearby pixels (Patch tool, Normal or Content-Aware), or move or extend it and fill the gap (Content-Aware Move tool). Needs a selection; dx and dy are the drag in pixels
reveal_allEnlarge the canvas to show every pixel that extends beyond it (Image > Reveal All)
reverse_layer_orderReverse the stacking order of two or more layers (Layer > Arrange > Reverse)
rotate_canvasRotate the whole image by an angle in degrees (Image > Image Rotation); positive is clockwise. Or flip the canvas horizontally or vertically
run_action_batchPlay an action on every file in a folder, a list of files, or the open documents, and leave, save over, or save them to a folder (File > Automate > Batch). Long batches can outlast the script timeout (PHOTOSHOP_SCRIPT_TIMEOUT_MS)
run_automate_commandRun a File > Automate or File > Scripts command on the active document without its dialog: crop_and_straighten (Crop and Straighten Photos: each scanned photo into its own document), fit_image (Fit Image: resize to fit a box), conditional_mode_change (Conditional Mode Change), lens_correction (Automate > Lens Correction's automatic profile correction), delete_empty_layers (Delete All Empty Layers), flatten_layer_effects (Flatten All Layer Effects), flatten_masks (Flatten All Masks)
run_photoshop_commandRun an application command: beep, bring Photoshop to the front, redraw the screen, hide Photoshop or the other applications or show them all again (Photoshop menu, macOS only), open Help > Photoshop Help, or open the Creative Cloud account page in the browser
run_photoshop_menu_itemRun any Photoshop menu command by its string id (e.g. "toggleRulers") or four-character id (e.g. "TglR"), as Application.runMenuItem does. A command that opens a dialog shows it and waits; prefer the specific tools
run_timeline_commandRun a video timeline command on the selected clips, keyframes or video layer at the playhead (Timeline panel menu: Move & Trim, Split at Playhead, Work Area, Keyframes, Convert Frames, Enable Onion Skins, Show; Layer > Video Layers: Insert, Delete, Duplicate, Reload or Restore Frame, Hide Altered Video). Toggles switch the setting each time
run_type_menu_commandRun a Type menu command: Update All Text Layers (also updates legacy and Asian text layers for vector output), Replace All Missing Fonts, Save Default Type Styles or Load Default Type Styles
sample_colorRead pixel colours of the composite image at points (Color Sampler tool and Info panel), optionally making the first the foreground or background colour (Eyedropper tool) and keeping the samplers in the document
save_documentSave the active document in place, or at filePath in the format its extension names, with that format's options (File > Save As): PSD, PSB (Large Document Format), TIFF, PNG, JPEG, Photoshop PDF, GIF, Photoshop EPS, DCS 1.0 and 2.0 (.eps with epsType), BMP, Targa (.tga), Pixar (.pxr) or Photoshop Raw (.raw). With asCopy the document keeps referring to its own file
save_selectionStore the selection in an alpha channel (Select > Save Selection), or load a channel as the selection (Select > Load Selection), combined with the current one
scale_content_awareResize a layer while keeping important content such as people and buildings unchanged (Edit > Content-Aware Scale): width and height in percent, the Amount of content-aware against normal scaling, Protect Skin Tones, and an alpha channel to protect
select_allSelect the whole canvas (Select > All), deselect (Select > Deselect), or invert the selection (Select > Inverse)
select_areaSelect a rectangle, an ellipse, a polygon or freehand outline (the Polygonal Lasso and Lasso tools), or a one-pixel row or column (Single Row and Single Column Marquee tools), in pixels from the document's top-left corner, combined with the current selection. The ellipse is a fine polygon, so its edge is close to but not exactly the Elliptical Marquee's
select_color_rangeSelect by colour (Select > Color Range): pixels near a sampled colour within a fuzziness, or a preset range (reds ... magentas, highlights, midtones, shadows, out of gamut), optionally inverted. Works inside the current selection when there is one, and samples the active layer
select_contentSelect automatically: the main subject (Select > Subject), the sky (Select > Sky), or the in-focus areas with Focus Area's automatic settings (Select > Focus Area). Subject uses the device or cloud processing chosen in Preferences > Image Processing
select_layer_pixelsLoad layers' transparency as the selection, as Cmd/Ctrl-clicking a layer thumbnail does: replace, add to, subtract from or intersect with the current selection. With several layers, replace selects all of their pixels together
select_view_toolMake a view tool current in the Tools panel: Hand, Zoom, Rotate View (needs the graphics processor), Slice or Slice Select. Using the tool on the canvas stays with the user
set_action_optionsSet how actions play back (Actions panel menu > Playback Options: accelerated, step by step, or pause between steps), and toggle Button Mode or Allow Tool Recording
set_active_documentBring an open document to the front by name or index
set_active_layerMake a layer the active one; many commands work on the active layer
set_blending_optionsSet a layer's Blending Options (Layer Style dialog): blend mode, opacity and fill opacity; Advanced Blending knockout, the channels it blends into and the group options (Blend Interior Effects as Group, Blend Clipped Layers as Group, Transparency Shapes Layer, Layer Mask Hides Effects, Vector Mask Hides Effects); and Blend If ranges for this layer and the underlying layer
set_brush_settingsSet the current tool's brush in the Brush Settings panel (Window > Brush Settings): Brush Tip Shape (size, hardness, angle, roundness, spacing, flip), Shape Dynamics, Scattering, Texture, Dual Brush, Color Dynamics, Transfer and Brush Pose, each section's on/off switch, the jitters and their Control (fade, pen pressure, tilt, stylus wheel, direction, rotation), and the Noise, Wet Edges, Build-up, Smoothing and Protect Texture checkboxes; clearControls first turns every dynamics option off (Clear Brush Controls). Only the settings given change; one the tool lacks is an error. stroke_path paints…
set_channelChange a channel's options (Channels panel > Channel Options): name, kind (converting an alpha channel to a spot channel or back), colour, opacity or solidity, and show or hide it (the eye icon). Colour channels such as Red can only be shown or hidden
set_clip_timingMove the in or out point of clips (layer duration bars) in the video timeline, or set their duration
set_clipping_maskClip layers to the layer below them (Layer > Create Clipping Mask), so they show only where it has pixels, or release them (Layer > Release Clipping Mask)
set_clone_source_optionsUse the Clone Source panel (Window > Clone Source) and its menu: choose which of the five clone sources the Clone Stamp and Healing Brush use, reset the active source's scale and rotation (Reset Transform), and toggle the overlay options Show Overlay, Auto Hide, Clip to Brush Tip and Invert. The overlay toggles flip the current state, which Photoshop does not report to scripts. Set a source's sample point with stroke_path cloneSource; show the panel with show_photoshop_panels
set_color_preferencesChoose the colour settings file (Edit > Color Settings, e.g. "North America General Purpose 2"), Dynamic Color Sliders (Color panel) and the Gamut Warning opacity (Preferences > Transparency & Gamut); returns the current values. With no arguments it only reads them
set_color_tableReplace the colour table of an Indexed Color image (Image > Mode > Color Table) with a list of colours, in table order
set_colorsSet the foreground and background colours used by fills, strokes, brushes and new documents
set_document_metadataSet the active document's File Info metadata: title, author, description, keywords, copyright, IPTC origin and categories, or replace its whole XMP packet. Only the fields given change. Camera data (Exif) is read-only
set_file_handling_preferencesSet and read file-handling preferences: image previews saved with files (macOS icon and full-size previews, Mac and Windows thumbnails), the length of File > Open Recent, and the History Log (on or off, saved to the file's metadata or a text file, and its detail). Call with no settings to read them
set_history_optionsRead or set the history preferences: History Options (Automatically Create First Snapshot, Allow Non-Linear History, number of history states) and the History Log (Preferences > History & Content Credentials: on or off, saved to metadata, a text file or both, and how much it records)
set_layer_effectsDescription is built at runtime.
set_layer_link_enabledSuspend a linked layer's link (the red X Shift-clicking the link icon shows) or restore it, without unlinking
set_layer_propertiesRename layers and set their opacity, fill opacity, blend mode, visibility and locks
set_layer_selectionSelect several layers at once in the Layers panel, for commands that act on the selected layers: set or add to the selection, select All Layers, Deselect Layers, Select Linked Layers, Similar Layers (same kind as the target), or find layers whose names contain some text (Select menu). Returns the selected layers
set_layers_panel_viewChange what the Layers panel shows, without changing the document: Isolate Layers (show only the target layers), Remove from Isolation, or Collapse All Groups
set_mask_propertiesSet the Density (opacity) and Feather of a layer's layer mask, vector mask or smart-filter mask (Properties panel, masks)
set_measurement_scaleSet the document's measurement scale (Image > Analysis > Set Measurement Scale): how many pixels make a length in logical units, e.g. 100 pixels = 2 millimeters. Without arguments, returns the current scale
set_photoshop_preferencesChange Photoshop's preferences (Photoshop > Settings, or Edit > Preferences on Windows). Give only the settings to change; the result lists every preference afterwards. Some take effect after a restart
set_pixel_aspect_ratioSet the document's pixel aspect ratio (View > Pixel Aspect Ratio), for video work with non-square pixels, and/or toggle View > Pixel Aspect Ratio Correction, which previews the image with those pixels
set_print_optionsChange the active document's print settings (File > Print) without the dialog: printer, copies, colour handling (including separations), print space, rendering intent, black point compensation, hard proof, position and scale, printing marks, functions (emulsion down, negative, background, border, bleed) and PostScript options. Only the settings given change
set_proof_viewSoft-proof the active document: choose a Proof Setup preset (View > Proof Setup: working CMYK or one plate, legacy Mac RGB, sRGB, monitor RGB, colour-blindness types), and toggle View > Proof Colors and View > Gamut Warning. The toggles switch the current state, which scripts cannot read
set_quick_maskTurn Quick Mask Mode on (the selection becomes a red overlay that painting edits) or off (the overlay becomes the selection again)
set_smart_filter_visibilityTurn one Smart Filter on a smart object, or all of them, off or on (the eye icons under the layer in the Layers panel)
set_stack_modeRender a multi-layer smart object with a statistical stack mode (Layer > Smart Objects > Stack Mode), for example median to remove moving objects or mean to reduce noise. Give several aligned layers and they are first converted into one smart object (an image stack)
set_textChange a type layer's text and/or formatting (applied to the whole layer), its position, and its warp (Type > Warp Text)
set_timelineSet the timeline: show or hide the Timeline panel, set the frame rate (Set Timeline Frame Rate), move the playhead to a time or Go To a frame or the work area, and choose the Layers panel's Animation Options
set_tool_optionsChoose the active tool and set its options bar: a brush preset (Brushes panel or the Brush Preset picker), size, hardness, opacity, flow, blend mode, the tablet pressure buttons for size and opacity, Smoothing and its options (Pulled String Mode, Stroke Catch-up, Catch-up on Stroke End, Adjust for Zoom), the Mixer Brush's Wet, Mix and Sample All Layers, Tolerance and Contiguous (Color Replacement, Paint Bucket, Magic Eraser), and the painting cursor style (Preferences > Cursors). The Mixer Brush, Spot Healing Brush and Red Eye tools can be made active here; painting with them stays on the canv…
set_type_optionsSet Character and Paragraph panel options on type layers: anti-aliasing, text and warp orientation (vertical type), kerning, language, No Break, OpenType ligatures and oldstyle figures, the paragraph type box size, indents, paragraph spacing, hyphenation, justification spacing, hanging punctuation and the composer
set_zoom_and_screen_modeZoom the active document (View > Zoom In, Zoom Out, Fit on Screen, 100%, 200%, Print Size) and choose the screen mode (View > Screen Mode: standard, full screen with menu bar, full screen)
show_photoshop_panelsShow or hide panels (Window menu), hide or show all panels at once (Tab), reset to the Essentials workspace, and use the Histogram panel menu (compact, expanded or all-channels view, statistics, channels in colour, uncached refresh) and the Info panel's Color Samplers item
split_channelsSplit the image into one grayscale document per channel (Channels panel > Split Channels). The original closes; the image must be flattened first (flatten_image)
stroke_pathPaint along a path on the active layer with a painting or retouching tool, using that tool's current brush and options (Paths panel > Stroke Path). Give a path from the Paths panel or points for a temporary one. Set the brush first with set_tool_options. Clone Stamp and Healing Brush need cloneSource
stroke_selectionStroke the selection's edge on the active layer (Edit > Stroke): colour, width in pixels, inside, centre or outside, blend mode and opacity
swap_colorsSwitch the foreground and background colours (Switch Foreground and Background Colors, X), or with reset: true return them to black and white (Default Foreground and Background Colors, D)
toggle_type_panelsShow or hide a type panel (Window > Character, Paragraph, Character Styles or Paragraph Styles). Each call switches the panel between shown and hidden
toggle_view_extrasToggle View menu items for the active document: Extras, each View > Show item (layer and selection edges, target path, grid, guides, count, smart guides, slices, notes, pixel grid, brush preview), Rulers, Lock Guides, Lock Slices, Snap and each Snap To item. show_all, show_none, snap_to_all and snap_to_none set rather than toggle. Photoshop does not tell scripts whether an item is on
transform_layersMove layers by dx, dy pixels, scale them by a percentage, rotate them by degrees, or flip them, around an anchor point; optionally transform a copy of each, keeping the original. Video layers transform the same way once they are Smart Objects
transform_selectionMove, scale or rotate the selection outline (Select > Transform Selection), or the selected pixels themselves
trim_imageTrim away transparent pixels, or pixels the colour of the top-left or bottom-right corner, from any of the four sides (Image > Trim)
undoStep back (undo) or forward (redo) through the history, or go to a state by index. Undone steps stay available until something new is done
ungroup_layersMove a group's layers out to where the group was and remove the empty group (Layer > Ungroup Layers)
warp_layersWarp layers with a preset style (Edit > Transform > Warp): arc, arch, bulge, flag, wave, fisheye, twist and the rest, with bend and horizontal and vertical distortion in percent, horizontal or vertical. Warping a Smart Object stays editable
warp_perspectiveCorrect or change a layer's perspective (Edit > Perspective Warp) with one quad: four corners in the image move to four new positions, e.g. to square up a photographed sign. Corners go top-left, top-right, bottom-right, bottom-left, in pixels. Needs the graphics processor enabled
Signals
- Stars
- 26
- Forks
- 10
- Open issues
- 22
- Contributors
- 1
- Last commit (this folder)
- Oct 20, 2026 (8 days ago)
- Last release
- Oct 20, 2026 (9 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.zachshallbetter/adobe-mcp-photoshop- Version
- 0.1.0
- Auth
- No auth
- Packages
- npm adobe-mcp-photoshop
- License
- MIT
- Repository
- github.com/zachshallbetter/adobe-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from zachshallbetter
- 0.661score
After Effects MCP Server
zachshallbetter
Drive Adobe After Effects from any MCP client: compositions, layers, animation and rendering.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
Illustrator MCP Server
zachshallbetter
Drive Adobe Illustrator from any MCP client: artwork, type, colour, effects, data and export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
InDesign MCP Server
zachshallbetter
Drive Adobe InDesign from any MCP client: 135+ tools for layout, styles, books and PDF export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
Premiere Pro MCP Server
zachshallbetter
Drive Adobe Premiere Pro from any MCP client: projects, sequences, timeline edits, effects, export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.658score
Adobe MCP Suite
zachshallbetter
Local MCP coordinator for cross-app Adobe workflows.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.513score
github-projects
zachshallbetter
Govern GitHub Issues, ProjectsV2, pull requests, claims, evidence, and status transitions through ACP.
SkillBFreshness: BClaude Code +9
Cite this page
Photoshop MCP Server. Agent Mart. https://agentmart.dev/connectors/zachshallbetter-adobe-mcp-photoshop (last updated 2026-10-24)