MCP server for AI-driven image editing with Photopea
Connect Photopea to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server for AI-driven image editing with Photopea. The photopea mcp server is what makes that connection.
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.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
photopea_create_document — Create a new document with specified dimensions and settingsphotopea_open_file — Open an image from a URL or local file pathphotopea_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 documentphotopea_add_layer — Add a new empty art layerphotopea_add_fill_layer — Add a solid color fill layerphotopea_delete_layer — Delete a layer by name or indexphotopea_select_layer — Make a layer active by name or indexphotopea_set_layer_properties — Set opacity, blend mode, visibility, name, or lock statephotopea_move_layer — Translate a layer by x/y offsetphotopea_duplicate_layer — Duplicate a layer with optional new nameThe server ships on npm as photopea-mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Photopea's toolset — photopea_create_document, photopea_open_file, photopea_get_document_info and 11 more — is a fair guide to whether it matches your workflow. It is maintained by attalla1; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| 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 |
{
"mcpServers": {
"photopea": {
"command": "npx",
"args": ["-y", "photopea-mcp-server"]
}
}
}Configuration as documented by the project. Restart the client after saving.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.