editmamei

Editmamei

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

(Pronounced like edamame. Yes, the snack.)

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 & wiki · 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 from the latest release (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 20+ (for the npm path), and an MCP-compatible AI client (Claude Desktop, Cursor, Claude Code).

A session, end to end

The discovery chain is photoshop_ping (liveness), then photoshop_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 returns a typed JSON payload. Any tool that changes what is active reports the current document and layer back, so the model keeps an accurate picture of Photoshop's state between calls instead of re-deriving it.
• Guidance lives in the surface. photoshop_overview returns the working method (assess, plan, enact, check, iterate) and photoshop_list_capabilities returns a live map of what exists. The model orients itself from the server rather than from guesswork or a stale prompt.
• Measure, don't eyeball. A dedicated set of verification tools (histogram, region compare, layer-bounds diff, selection preview) lets the model check its own work numerically instead of trusting a thumbnail.
• On-device perception. Local computer vision (ONNX) detects faces, objects, and scene regions and returns real document coordinates. The image stays on your machine for this step and is never sent to a cloud vision model.
• Non-destructive by default. Adjustments are adjustment layers, and destructive pixel operations run on an auto-created duplicate. An edit is reversible by construction.
• Verified against real Photoshop. Every tool is built on Photoshop's own native scripting functions and verified in live Photoshop sessions before it ships. A new tool stays disabled until it has passed live verification, so the shipped surface is the verified surface.
• Built for modern Photoshop. Editmamei targets Photoshop 2026 (v27.x) so it can rely on current, stable scripting descriptors rather than carrying a decade of drifted behavior.

Tool surface

75 tools across 16 capability groups (58 Community, 17 Pro). Every tool is namespaced photoshop_* and discoverable at runtime via tools/list. Community tools ship in both editions; Pro tools unlock with a license.

Group	Edition	Tools
Core	Community	ping · overview · list_capabilities · undo · redo
Inspect	Community	inspect · get_preview
Verify	Community	get_histogram · compare_regions · get_layer_bounds_diff · get_selection_preview
Document & canvas	Community	create_document · open_document · close_document · save_psd · export · place_image · resize_image · crop_document · convert_image_mode · transform_canvas · guides
Selection	Community	select · modify_selection · selection_channel
Adjustments	Community	add_adjustment_layer · apply_adjustment
Filters	Community	apply_filter
Retouch	Community	retouch
Layers	Community	create_layer · delete_layer · fill_layer · add_fill_layer · select_layer · move_layer_to_position · duplicate_layer · layer_via_copy · convert_to_smart_object · rasterize_layer · set_layer · merge · bake_layer · add_layer_style · transform_layer · create_group · move_layer_to_group · set_group_blend_mode · ungroup · delete_group
Masks & paths	Community	layer_mask · create_clipping_mask · path · vector_mask
Type	Community	create_text_layer · set_text
Perception	Community	detect · scene · select_by_reference
AI selection	Pro	select_subject · select_sky · select_subject_instance
Layers (warp)	Pro	warp_layer · warp_layer_mesh
Face mesh	Pro	detect_landmarks · select_face_feature
Templates	Pro	template_create_evidence · template_save · template_list · template_apply · template_verify · template_recall · template_delete
Automation	Pro	list_actions · play_action · execute_script

Editions

• Community is free and covers the everyday editing surface: documents, layers, selections, non-destructive adjustments, filters, masks, type, retouching, on-device perception, and the inspect/verify primitives.
• Pro adds AI selection (Sensei-backed Select Subject and Select Sky), face-mesh perception, the reproducible-template system, custom mesh warp, and Photoshop Actions plus the scripting escape hatch.

The split is detailed in pro-features.md. Pricing is at editmamei.com.

Configuration

Settings live in ~/.editmamei/settings.json, managed by the editmamei config CLI:

editmamei config list
editmamei config set telemetry.usage false      # turn off anonymous usage telemetry
editmamei config set photoshop_path "/path/to/Photoshop"

PHOTOSHOP_PATH (env var) overrides Photoshop auto-detection for a single run.

Privacy

Editmamei runs on your computer and edits in your own Photoshop. No image content, document data, or file paths are sent to Editmamei's servers. It reports anonymous, content-free usage telemetry (on by default, turn it off with editmamei config set telemetry.usage false). When your AI assistant needs to see a result, Editmamei sends it a downscaled preview, the same as dropping a photo into a chat with that assistant. Every field is documented in privacy.md.

Docs and support

• Features and pricing: editmamei.com
• Install, getting started, FAQ, Pro features: the wiki
• Bugs and feature requests: the issue tracker. If something's broken, ask your assistant to "report a problem" (or run editmamei report) to drop an anonymized diagnostic bundle in your Downloads folder, then attach it to the issue.
• Security: see editmamei.com/security (don't file security issues publicly)

License

Proprietary, free to install and use. See the license. Third-party dependencies keep their own licenses, listed in the bundled NOTICES.md.

---

Pairs well with: a layered PSD, a willing AI, and a small bowl of edamame.