Skip to content

Photoshop MCP server

The Photoshop MCP server for your AI app

Editmamei connects Claude, ChatGPT, Cursor and other AI apps to Adobe Photoshop on your computer. Ask for an edit in the chat, and it happens in Photoshop with Photoshop's own tools, as layers and masks you can keep editing. Free to use.

Install it in Claude, ChatGPT, Cursor and Codex at once:

npx -y editmamei install

Needs Node.js 22 or later. Prefer one click? See every way to install.

What it is

Your AI decides. Photoshop edits.

MCP is the standard way AI apps plug into other software. Editmamei is an MCP server that runs on your computer and lets your AI app use Photoshop's own features: open a file, add a Curves layer, select the sky, mask a subject, retouch, add text, export.

You ask for an edit in plain words. Your AI plans the steps, Editmamei carries each one out in Photoshop, and a small preview comes back so the AI can check the result before the next step. When it's done, the document is still in layers, ready for you to keep editing.

See real requests and results on the Editmamei Desktop page

Set it up

Add it to your AI app.

Pick your app. After any of these, restart the app, open Photoshop and ask “Is Photoshop connected?”

For Claude Desktop: Settings, Desktop app, Manage next to Extensions, then Advanced settings and Install Extension, and choose the downloaded editmamei.mcpb. It brings its own Node.js.

ChatGPT desktop app, Claude Code, Codex

One command adds Editmamei to each of these it finds, and to Claude Desktop and Cursor:

npx -y editmamei install

In the ChatGPT desktop app, quit it fully from the system tray, reopen it, and use Work mode.

Any other MCP app

Windsurf, Gemini CLI, Cline, Warp, Kiro, JetBrains AI Assistant and most others take this entry in their MCP settings:

{
  "mcpServers": {
    "editmamei": { "command": "npx", "args": ["-y", "editmamei"] }
  }
}

Each app's file and quirks are in the client guide.

By hand: Claude Code

claude mcp add --scope user editmamei -- npx -y editmamei

By hand: ChatGPT desktop app and Codex

Add to ~/.codex/config.toml. The longer timeouts give the first start and the slower steps room to finish.

[mcp_servers.editmamei]
command = "npx"
args = ["-y", "editmamei"]
startup_timeout_sec = 60
tool_timeout_sec = 600

Photoshop only

Editmamei also drives GIMP. If your app caps how many MCP tools it loads, this package starts the same server for Photoshop only. In any config above, put this package after npx -y instead of editmamei:

npx -y @editmamei/photoshop-mcp

Requirements: Adobe Photoshop 2026 or later (earlier versions back to 2020 may also work) on Windows 10/11 or macOS 13+, and Node.js 22 or later (except with the Claude Desktop download). Full steps are in the install guide.

What it can do

More than 160 Photoshop features, free.

Your AI works with Photoshop's own adjustments, filters, selections and retouching, called by the same names you know from its menus.

  • Tone and color

    22

    Curves, Levels, Hue/Saturation, Brightness/Contrast, Black & White, Color Balance, Photo Filter, Vibrance, Channel Mixer, Selective Color, Gradient Map, Exposure, Color Lookup, Invert, Posterize, Threshold, Clarity and Dehaze, Grain, Shadows/Highlights, Equalize, Solid Color fill, Gradient fill

  • Filters

    42

    Gaussian Blur, Motion Blur, Lens Blur, Radial Blur, Surface Blur, Box Blur, Average, Unsharp Mask, Smart Sharpen, High Pass, Add Noise, Reduce Noise, Median, Dust & Scratches, Despeckle, Twirl, Ripple, Polar Coordinates, Wave, Pinch, Spherize, ZigZag, Displace, Color Halftone, Mosaic, Crystallize, Pointillize, Facet, Fragment, Emboss, Find Edges, Solarize, Wind, Trace Contour, Tiles, Oil Paint, Clouds, Difference Clouds, Fibers, Maximum, Minimum, Offset

  • Selections

    22

    Select Subject, Select Sky, Color Range, Focus Area, Magic Wand, Rectangular Marquee, Elliptical Marquee, Polygonal Lasso, Grow, Similar, Inverse, Select All, Deselect, Select and Mask, Feather, Expand, Contract, Border, Smooth, Transform Selection, Save Selection, Load Selection

  • Retouching

    4

    Content-Aware Fill, Content-Aware Move, Patch, Sky Replacement

  • Masks and channels

    5

    Layer Mask, Vector Mask, Clipping Mask, Apply Image, Calculations

  • Layer styles and blend modes

    33

    Drop Shadow, Inner Shadow, Outer Glow, Inner Glow, Stroke, Color Overlay, and all 27 blend modes, from Multiply to Luminosity

  • Layers and transforms

    14

    Smart Objects, Smart Filters, Layer Groups, Layer via Copy, Rasterize, Merge Down, Merge Visible, Stamp Visible, Flatten Image, Free Transform, Scale, Rotate, Skew, Flip

  • Image and canvas

    9

    Crop, Image Size, Image Rotation, Flip Canvas, Grayscale mode, RGB mode, CMYK mode, Lab mode, Bitmap mode

  • Type, shapes and paths

    8

    Type layers, Rectangle, Ellipse, Line, Work Path from selection, Stroke Path, Fill Path, Clipping Path

  • Files and checking

    9

    Open, New Document, Place Embedded, Save as PSD, Export as JPEG, Export as PNG, Guides, Histogram, History (undo and redo)

Pro adds Camera Raw as a re-editable filter, raw files developed before they open, Warp, your recorded Actions, selections of a named object or a face, saved looks, and batch runs across a whole folder. See Pro · How Editmamei reaches each one

Choosing one

What to look for in a Photoshop MCP server.

  • Edits you can keep working on

    Editmamei works the way a careful retoucher does: adjustment layers, masks and named groups, not baked-in pixels. Open the file afterwards and every step is still there to change by hand.

  • An AI that checks its own work

    After each step your AI can look at a small preview and read histograms, so it sees what changed and corrects course instead of guessing.

  • Photoshop’s own tools, not a redraw

    Editmamei doesn’t generate or redraw your photo. Every change is made by Photoshop on your full-size photo, and Photoshop’s own AI features, like Relight, run only when you ask for them.

  • Nothing added to Photoshop

    Editmamei talks to Photoshop through its built-in scripting interface. There is no plugin or panel to install, and it never moves your mouse or reads your screen.

  • Your photos stay on your computer

    Your AI sees small previews and details it reads, like layer names, so it can check its work. You can switch previews off. Editmamei never sends your photos or previews to us.

  • Works in the AI app you already use

    One server for Claude Desktop, the ChatGPT desktop app, Cursor, VS Code, Codex and any other app that runs local MCP servers, with one-click and one-command installs.

Questions

Common questions.

What is a Photoshop MCP server?
MCP (Model Context Protocol) is the standard way AI apps plug into other software. A Photoshop MCP server lets an AI app use Photoshop’s own features, so when you ask for an edit in a chat, the AI can open your photo, add adjustment layers, make selections and export the result in Photoshop itself.
Is Editmamei free?
Yes. The free edition uses more than 160 of Photoshop's features, from Curves and Select Subject to Content-Aware Fill, enough for a full edit of any photo. Pro adds Camera Raw, Warp, your recorded Actions, saved looks and batch editing across a folder.
Does it work with ChatGPT?
Yes, in the ChatGPT desktop app, in Work mode. Run npx -y editmamei install, then quit and reopen the app. ChatGPT in a browser cannot start a server on your computer; for that, use Editmamei Connect, the hosted version.
Which versions of Photoshop does it support?
Adobe Photoshop 2026 or later, on Windows 10 or 11 and macOS 13 or later. It may also work with earlier versions, back to Photoshop 2020. It does not work with Photoshop Elements, which lacks the scripting interface it uses, and it does not drive Lightroom.
Is it generative AI?
No. Editmamei generates no images. Your AI app decides the steps, and Photoshop carries them out with its ordinary editing tools on your own photo.
Do my photos get uploaded?
No. The edit happens in Photoshop on your computer. Your AI app sees small previews so it can check its work, and you can switch previews off. Editmamei never sends your photos or previews to us.
Is it made by Adobe?
No. Editmamei is an independent product. It connects to Adobe Photoshop but is not made by, affiliated with, or endorsed by Adobe.

More in the FAQ.