attalla1/photopea-mcp-server

Overview

An MCP server that exposes Photopea's image editing capabilities to AI agents via the Model Context Protocol. It allows AI tools to programmatically edit images using Photopea's browser-based editor.

Best for

Best for
Developers who want to add image editing to AI agent workflows using a free browser-based editor

Use cases

• Automating batch image edits like resizing or cropping
• Integrating AI-driven image manipulation into workflows
• Building custom image processing pipelines with Photopea

How to use

Install

npm install -g photopea-mcp-server

Tools exposed

• photopea_create_document
• photopea_open_file
• photopea_get_document_info
• photopea_resize_document
• photopea_close_document
• photopea_add_layer
• photopea_add_fill_layer
• photopea_delete_layer
• photopea_select_layer
• photopea_set_layer_properties
• photopea_move_layer
• photopea_duplicate_layer
• photopea_reorder_layer
• photopea_group_layers
• photopea_ungroup_layers
• photopea_get_layers
• photopea_add_text
• photopea_edit_text
• photopea_add_shape
• photopea_place_image

Tested with

Claude Desktop, Claude Code, Cursor, Windsurf, VS Code

Notes

An MCP server that exposes Photopea’s image editing capabilities to AI agents via the Model Context Protocol. It allows AI tools to programmatically edit images using Photopea’s browser-based editor.

15 stars on GitHub. Last updated 2026-04-05. Licensed MIT.

Use cases

• Automating batch image edits like resizing or cropping
• Integrating AI-driven image manipulation into workflows
• Building custom image processing pipelines with Photopea

Pros

• Leverages Photopea’s powerful free editor without local installs
• Simple MCP interface for AI agent integration
• TypeScript codebase for easy extension

Cons

• Low community adoption with only 15 stars
• Depends on Photopea’s web service availability
• Limited documentation and examples

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.