Editmamei

Unlock Photoshop with natural-language photo editing. AI orchestration, not generation.

Independent project, not affiliated with or endorsed by Adobe Inc.

Editmamei is a Model Context Protocol (MCP) server that drives the Adobe Photoshop you already have. You describe the edit in plain words, your AI assistant plans the steps, and your own copy of Photoshop carries them out with its standard adjustment layers, masks, selections, and filters. The AI directs and Photoshop edits. No generative model touches your pixels, and no image is uploaded to perform an edit.

It serves photographers and retouchers who want to edit by conversation just as much as developers wiring Photoshop into an AI pipeline. To learn more or get started, visit editmamei.com.

editmamei.com · Docs · Report a bug

How it works

Editmamei is a pure MCP stdio server written in Node. Your AI client launches it as a subprocess and calls its tools over stdio. Each tool builds a small Photoshop script and runs it in your local Photoshop over the platform's native automation channel:

AI client  ──stdio──▶  Editmamei (Node MCP server)
                              │  builds a Photoshop script per tool call
                              ▼
                    COM (Windows) / AppleScript (macOS)
                              │
                              ▼
                     Your local Adobe Photoshop

• Windows drives Photoshop through COM (the Photoshop.Application object).
• macOS drives it through AppleScript / OSA.
• Perception (face, object, and scene detection) runs on-device with local ONNX computer vision, so the model gets real document coordinates without your image leaving the machine.

Photoshop does the pixel work with its own engine. Editmamei is the conductor, not a renderer.

Install

npm install -g editmamei
editmamei install   # registers with Claude Desktop, Cursor, Claude Code
editmamei status    # confirms install state + Photoshop detection

Then restart your AI client and ask it: "Is Photoshop connected?"

Prefer not to use a terminal? Claude Desktop users can install the one-click .mcpb extension directly (no system Node required, Claude Desktop ships its own runtime). Full walkthrough in the install guide.

Requirements: Adobe Photoshop 2026 (v27.x), Windows 10/11 or macOS 12+, Node.js 22+ (for the npm path), and an MCP-compatible AI client (Claude Desktop, Cursor, Claude Code).

A session, end to end

The discovery chain is ps_ping (liveness), then ps_overview (the working method and capability map), then tools/list (the full schema-typed inventory). After that you just talk to your assistant:

"Open my vacation photo." "Make the sky more dramatic but keep the foreground natural." "Sharpen the eyes, soften the skin, leave everything else alone." "Isolate the subject onto its own layer with a clean mask." "Export a 2048px web JPEG."

Your assistant composes those into tool calls, checks the result with previews and measurements, and iterates.

Design principles

These are the choices that shape the surface, and the reason an AI assistant can drive it reliably rather than hopefully.

• Structured results, not prose. Every tool declares an outputSchema and

... View full README on GitHub