How do I install the photopea mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Photopea MCP Server

MCP server for AI-driven image editing with Photopea

Local serverstdioTypeScript

What is the Photopea MCP Server?

MCP server for AI-driven image editing with Photopea

What the server does

Design posters, edit photos, and transform images directly from your terminal. Powered by Photopea -- a free, browser-based alternative to Photoshop -- connected to your AI agent via MCP.

Credentials and setup notes

Node.js >= 18 - A modern web browser (Chrome, Firefox, Edge, Safari)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
photopea_create_document	Create a new document with specified dimensions and settings
photopea_open_file	Open an image from a URL or local file path
photopea_get_document_info	Get active document info (name, dimensions, resolution, color mode)
photopea_resize_document	Resize the active document (resamples content to fit)
photopea_close_document	Close the active document
photopea_add_layer	Add a new empty art layer
photopea_add_fill_layer	Add a solid color fill layer
photopea_delete_layer	Delete a layer by name or index
photopea_select_layer	Make a layer active by name or index
photopea_set_layer_properties	Set opacity, blend mode, visibility, name, or lock state
photopea_move_layer	Translate a layer by x/y offset
photopea_duplicate_layer	Duplicate a layer with optional new name
photopea_reorder_layer	Move a layer in the stack (above, below, top, bottom)
photopea_group_layers	Group named layers into a layer group
photopea_ungroup_layers	Ungroup a layer group
photopea_get_layers	Get the full layer tree as JSON
photopea_add_text	Add a text layer at specified coordinates
photopea_edit_text	Edit content or style of an existing text layer
photopea_add_shape	Add a shape (rectangle or ellipse)
photopea_place_image	Place an image from URL or local path
photopea_apply_adjustment	Apply brightness/contrast, hue/saturation, levels, or curves
photopea_apply_filter	Apply gaussian blur, sharpen, unsharp mask, noise, or motion blur
photopea_transform_layer	Scale, rotate, or flip a layer
photopea_add_gradient	Apply a linear gradient fill
photopea_make_selection	Create a rectangular, elliptical, or full selection
photopea_modify_selection	Expand, contract, feather, or invert a selection
photopea_fill_selection	Fill the current selection with a color
photopea_clear_selection	Deselect the current selection
photopea_export_image	Export to PNG, JPG, WebP, PSD, or SVG
photopea_load_font	Load a custom font from a URL (TTF, OTF, WOFF2)
photopea_list_fonts	List available fonts, with optional search filter
photopea_run_script	Execute arbitrary Photopea JavaScript
photopea_undo	Undo one or more actions
photopea_redo	Redo one or more actions

How to install the Photopea MCP Server

{
  "mcpServers": {
    "photopea": {
      "command": "npx",
      "args": [
        "-y",
        "photopea-mcp-server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js >= 18 - A modern web browser (Chrome, Firefox, Edge, Safari)

Example prompts to try

“Use Photopea to photopea create document.”
“Use Photopea to photopea open file.”
“Use Photopea to photopea get document info.”

Frequently asked questions

MCP server for AI-driven image editing with Photopea Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.