Editmamei logo

Editmamei

Drives local Photoshop through natural-language MCP tools for non-destructive edits, inspection, verification, and export.

Install Editmamei

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "editmamei": {
      "command": "npx",
      "args": [
        "-y",
        "editmamei"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 62 tools correctly (1d ago).

Overview

editmamei MCP server connects an AI client to desktop Adobe Photoshop through a Node.js stdio process. The client plans edits, while editmamei builds scripts that Photoshop executes through COM on Windows or AppleScript on macOS. Its tools cover document operations, layers, masks, selections, adjustments, filters, perception, verification, and export, with a separate beta namespace for headless GIMP. Reach for it when edits should happen in your own Photoshop installation without sending image data to a cloud vision service.

Use cases

  • Edit photos in Photoshop through conversational instructions
  • Inspect and verify layer, selection, and image changes
  • Apply local subject, sky, face, and scene selections
  • Automate Photoshop actions, templates, scripts, or batches
  • Export resized or processed images from Photoshop

Key features

  • 83 Photoshop tools across 16 capability groups
  • Native COM and AppleScript Photoshop automation
  • On-device ONNX perception for faces, objects, and scenes
  • Structured JSON results with output schemas
  • Non-destructive editing defaults
  • Separate beta headless GIMP tool namespace

Tools62

What Editmamei lets your agent do. Expand a tool for its parameters.

Verified live~40.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

10/10 checks healthy over the last 57d

What it can do

From the 62 tools this server returned when we ran it; 62 declare their own safety hints.

Can delete or modify data · 23Writes files · 1Makes network requests · 7Read-only tools · 39
Network at startup5 connections
Files written at startup1
Install scriptsNone
npm provenanceSigned build
Package age162 days
Maintainers1

Observed 2026-11-07 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · editmamei (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars18Stargazers on the source repository.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed62Callable tools this server registers over MCP.
Directory activity12 viewsConfig copies, upvotes, and views on AllMCPs.

How Editmamei works

What editmamei does

editmamei turns natural-language editing requests into operations performed by a local Adobe Photoshop installation. It is an MCP server rather than an image-generation system: the connected AI client interprets the request and selects tool calls, while Photoshop performs the actual pixel editing with its native engine.

The Photoshop surface includes 83 tools in 16 capability groups. These cover document and canvas operations, selections, adjustment layers, filters, retouching, layers, masks, paths, type, perception, AI-assisted selection, inspection, verification, and automation. Community tools are available in both editions; Pro adds selected Photoshop capabilities such as Camera Raw processing, warp, object editing, face landmarks, templates, actions, scripting, and batching.

A separate gimp_* namespace provides 29 Community tools for headless GIMP and is identified as beta. GIMP has no Pro tier.

How it works

The AI client launches the Node-based server as a subprocess and communicates with it over MCP stdio. Each tool call creates a small Photoshop script and sends it through the operating system's native automation mechanism. Windows uses the Photoshop.Application COM object; macOS uses AppleScript and OSA.

The normal discovery sequence starts with ps_ping to check liveness, followed by ps_overview for the working method and capability map. The client can then call tools/list to retrieve the typed tool inventory. Tool responses use structured JSON and declare output schemas. Operations that change the active document or layer report that state back to the client.

Local ONNX computer vision handles face, object, and scene detection on the device and returns document coordinates. Images are not uploaded for this perception step. Verification tools let an agent inspect previews, histograms, region comparisons, layer-bound differences, and selection previews before continuing.

Setup and configuration

The npm installation requires Node.js 22 or newer, Adobe Photoshop 2026 version 27.x, Windows 10 or 11 or macOS 13 or newer, and an MCP-compatible client. Install the package globally, then run the installation command to register it with supported clients:

Terminal
npm install -g editmamei
editmamei install
editmamei status

editmamei status checks the installation state and Photoshop detection. Restart the client after registration, then use a connection check such as “Is Photoshop connected?”. Claude Desktop users can alternatively install the provided .mcpb extension; that route uses Claude Desktop's bundled runtime and does not require system Node.js.

The server supplies no model. Token usage therefore comes from the AI client connected to it. Pro Photoshop tools require a license, while Community tools are available in both editions.

Tools and capabilities

  • Inspect documents and previews, and verify results with histograms or region comparisons.
  • Create, open, save, resize, crop, export, and transform Photoshop documents.
  • Work with layers, masks, paths, selections, adjustment layers, filters, text, and retouching.
  • Use local perception and selection tools for subjects, skies, objects, faces, and scene regions.
  • Automate repeatable work with sequences, templates, actions, scripts, and batch operations where available.
  • Drive headless GIMP through the separate beta gimp_* tool namespace.

Limitations and notes

Photoshop is required for the Photoshop tool surface, and the project targets Photoshop 2026's scripting descriptors. The server is an independent project and is not affiliated with or endorsed by Adobe. Image editing is performed by the local application; editmamei coordinates the work rather than rendering pixels itself. GIMP support is separate from Photoshop support and currently beta. Destructive pixel operations use an automatically created duplicate, while adjustments are generally represented as adjustment layers.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Editmamei

editmamei is an MCP server that connects AI clients to local Adobe Photoshop through Node.js, COM on Windows, or AppleScript on macOS. Its main tools cover documents, layers, masks, selections, adjustments, filters, perception, verification, export, and automation, with a separate beta namespace for headless GIMP.

Install it with `npm install -g editmamei`, then run `editmamei install` and `editmamei status`. The npm route requires Node.js 22 or newer. Claude Desktop users can instead install the provided `.mcpb` extension, which uses Claude Desktop's bundled runtime.

Yes, editmamei can register with Cursor through `editmamei install`. The server runs as a Node.js stdio subprocess, so restart Cursor after installation and make sure Adobe Photoshop is installed and detectable on the local Windows or macOS machine.

No, editmamei performs Photoshop editing locally and runs its face, object, and scene perception on-device with local ONNX computer vision. The server coordinates tool calls, while Photoshop performs the pixel work on the connected computer.

editmamei requires Adobe Photoshop 2026 version 27.x on Windows 10 or 11 or macOS 13 or newer. Windows automation uses the Photoshop COM interface, while macOS automation uses AppleScript and OSA.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEditmamei AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/editmamei?style=directory)](https://allmcps.com/mcp/editmamei)
HTML Embed
<a href="https://allmcps.com/mcp/editmamei"><img src="https://allmcps.com/api/badge/editmamei?style=directory" alt="Editmamei on AllMCPs" /></a>