Photoshop MCP Server

How to use

You will connect an MCP client to the Photoshop MCP server to send commands and receive context about the current document and layers. Start by running the server with a simple, supported method, then configure your client to point at the server endpoint. Use tools to create documents, modify layers, apply filters, adjust colors, manage selections, run actions, and automate complex workflows. Each operation returns context information about the active document and layer to help your AI or automation layer stay in sync with Photoshop.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Install or run the MCP server using NPX (no local installation required). This is the recommended method.

npx @alisaitteke/photoshop-mcp

If you prefer to run from source, clone the repository, install dependencies, and build the project.

git clone https://github.com/yourusername/photoshop-mcp.git
cd photoshop-mcp
npm install
npm run build

Configuration

Configure your MCP client to connect to the server. The project provides example configurations for popular clients. The configuration enables you to specify the command to run the server, arguments, and any environment variables.

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"],
      "env": {
        "LOG_LEVEL": "1"
      }
    }
  }
}

Environment variables

Two environment variables are commonly used with the server. You can set these to tailor logging and Photoshop path behavior.

{
  "env": {
    "PHOTOSHOP_PATH": "C:\\Custom\\Path\\Adobe Photoshop 2025\\Photoshop.exe",
    "LOG_LEVEL": "1"
  }
}

photoshop_ping

Test the connection to Photoshop to ensure the MCP server can reach an active Photoshop session.

photoshop_get_version

Retrieve version information for the installed Photoshop application.

photoshop_create_document

Create a new Photoshop document with specified width, height, and optional parameters like resolution and color mode.

photoshop_get_document_info

Return details about the active document, such as size, color mode, and layer count.

photoshop_save_document

Save the active document to a file path with a chosen format and quality.

photoshop_close_document

Close the active document, with an option to save changes.

photoshop_create_layer

Create a new layer, with an optional name.

photoshop_delete_layer

Delete the currently active layer.

photoshop_create_text_layer

Create a new text layer with content, position, and font size.

photoshop_fill_layer

Fill the active layer with a solid color defined by RGB values.

photoshop_get_layers

List all layers in the active document.

photoshop_set_layer_opacity

Set the opacity of the active layer.

photoshop_set_layer_blend_mode

Change the blend mode of the active layer.

photoshop_set_layer_visibility

Show or hide the active layer.

photoshop_set_layer_locked

Lock or unlock the active layer.

photoshop_rename_layer

Rename the active layer.

photoshop_duplicate_layer

Duplicate the active layer, with an optional new name.

photoshop_merge_visible_layers

Merge all visible layers into a single layer.

photoshop_flatten_image

Flatten all layers into a single background layer.

photoshop_rasterize_layer

Rasterize the active layer to convert vector or text to a raster layer.

photoshop_move_layer_to_position

Move the active layer relative to another layer with a specified position.

photoshop_move_layer_to_top

Move the active layer to the top of the layer stack.

photoshop_move_layer_to_bottom

Move the active layer to the bottom of the layer stack.

photoshop_move_layer_up

Move the active layer up one position.

photoshop_move_layer_down

Move the active layer down one position.

photoshop_fit_layer_to_document

Scale the active layer to fit the document canvas, with an option to fill.

photoshop_scale_layer

Scale the active layer by a given percentage and anchor point.

photoshop_move_layer

Move the active layer by a specified delta in X and Y.

photoshop_rotate_layer

Rotate the active layer by a number of degrees.

photoshop_apply_gaussian_blur

Apply Gaussian Blur to the active layer with a specified radius.

photoshop_apply_sharpen

Apply sharpening to the active layer using amount, radius, and threshold.

photoshop_apply_noise

Add noise to the active layer with configurable amount and distribution.

photoshop_apply_motion_blur

Apply motion blur with angle and radius.

photoshop_adjust_brightness_contrast

Adjust brightness and contrast of the active layer.

photoshop_adjust_hue_saturation

Adjust hue, saturation, and lightness of the active layer.

photoshop_auto_levels

Apply auto levels to the active layer.

photoshop_auto_contrast

Apply auto contrast to the active layer.

photoshop_desaturate

Desaturate the active layer to grayscale.

photoshop_invert

Invert colors on the active layer.

photoshop_set_text_font

Set font family and size for the active text layer.

photoshop_set_text_color

Set color for the active text layer.

photoshop_set_text_alignment

Set alignment for the active text layer.

photoshop_update_text_content

Update the text content of the active text layer.

photoshop_select_rectangle

Create a rectangular selection with specified bounds.

photoshop_select_all

Select the entire document.

photoshop_deselect

Clear all selections.

photoshop_invert_selection

Invert the current selection.

photoshop_create_layer_mask

Create a layer mask from the current selection.

photoshop_delete_layer_mask

Delete the layer mask from the active layer.

photoshop_apply_layer_mask

Apply the layer mask to the layer.

photoshop_undo

Undo previous operations with an optional step count.

photoshop_redo

Redo previously undone operations with an optional step count.

photoshop_get_history

Retrieve the history states of the active document.

photoshop_play_action

Play a recorded action from an Actions set.

photoshop_execute_script

Execute extended script code in Photoshop.

photoshop_resize_image

Resize the active image with new width and height.

photoshop_crop_document

Crop the document to specified bounds.

photoshop_place_image

Place an external image file as a layer in the active document.

photoshop_open_image

Open an image file as a new document.