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.
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
22Curves, 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
42Gaussian 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
22Select 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
4Content-Aware Fill, Content-Aware Move, Patch, Sky Replacement
Masks and channels
5Layer Mask, Vector Mask, Clipping Mask, Apply Image, Calculations
Layer styles and blend modes
33Drop Shadow, Inner Shadow, Outer Glow, Inner Glow, Stroke, Color Overlay, and all 27 blend modes, from Multiply to Luminosity
Layers and transforms
14Smart 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
9Crop, Image Size, Image Rotation, Flip Canvas, Grayscale mode, RGB mode, CMYK mode, Lab mode, Bitmap mode
Type, shapes and paths
8Type layers, Rectangle, Ellipse, Line, Work Path from selection, Stroke Path, Fill Path, Clipping Path
Files and checking
9Open, 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.