Photopea MCP Server
An MCP server that edits images through Photopea: layers, text, effects and export, 46 tools for Claude Code and Cursor.
- 53 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server runs JavaScript commands in the Photopea editor in your browser.
- Images pass through a third party web editor.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/photopea-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server runs JavaScript commands in the Photopea editor in your browser.
- Images pass through a third party web editor.
This is third-party code. Review the repository files before installing.
What it does
Photopea MCP Server passes agent commands to the Photopea browser editor, a free Photoshop alternative. The server talks to the agent over stdio, turns calls into Photopea JavaScript commands and runs them through a WebSocket and `postMessage` bridge. A browser tab opens automatically on the first tool call, which is expected because the editor runs only there. There are 46 tools grouped by task: document (9), layer (16), text and shape (3), image and effects (10), export and utility (8). The agent can build a poster or album cover, retouch a photo, add text and effects and export the result. The repository includes the demo prompt `examples/album-cover-demo.md` and a Docker image.
Who it is for. Designers and developers whose agent should edit images and make covers and posters without manual editor work.
Good fit when
- The agent builds an album cover from a description: background, layers and text.
- Images are cropped and exported in one format in bulk.
- A photo is retouched with filters and effects from a text command.
- A layout is edited right from the terminal without opening the editor by hand.
Not a fit when
- You need an offline editor without a browser.
- Files cannot be opened in a third party web editor.
- You need precise work in Photoshop itself or with complex PSD plugins.
Example request
Make a 3000x3000 album cover titled "Nightfall" with a dark background and a gradient, then export it as PNG.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The server depends on an open Photopea tab: if you close it, the next call opens it again. Images are processed in the Photopea browser editor, so do not load confidential material without checking the service policy. Some features depend on the Photopea API and individual tools may behave differently from desktop Photoshop. Node.js and `npx` are required to run it, and no API keys are needed.
How to disable. Remove the entry with `claude mcp remove photopea` or delete it from the client configuration, then close the Photopea tab.
FAQ
How do I connect Photopea MCP to Claude Code?
Run `claude mcp add -s user photopea -- npx -y photopea-mcp-server`. Then start a new session.
Why does a browser open?
Photopea runs only in the browser, so the server opens a tab on the first tool call. If you close it, it opens again.
Which clients are supported?
Claude Code, Claude Desktop, Cursor, VS Code with Copilot and Windsurf. The README has a config snippet for each.
How many tools does the server have?
46: document, layer, text and shape, image and effects, export and utility.
How do I install it globally?
Run `npm install -g photopea-mcp-server`, then `claude mcp add -s user photopea -- photopea-mcp-server`.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for Adobe Photoshop: background removal, retouch, social export and batch jobs by chat
An MCP server for Windows that drives an installed Photoshop: documents, layers and arbitrary JSX scripts
The MCP server gives agents GIMP image editing with visual previews, layers, filters and file export operations.
A local MCP server for editing and analyzing images: the agent crops frames, finds objects and reads text from photos
An MCP server giving an agent 123 Aseprite tools for pixel art and animation, plus previews to check its own drawing
An MCP server linking an agent to a Lightroom Classic catalog: photo search, ratings, develop settings, collections, export.
README in short
How it works: agent, MCP server, WebSocket bridge, browser and Photopea. The README has a demo, a quick start, a tool list and example prompts.