Photoshop MCP
An MCP server for Adobe Photoshop: background removal, retouch, social export and batch jobs by chat
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Runs operations inside Photoshop and changes your files
- Collects anonymous usage analytics by default
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/photoshop-mcpDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal
claude mcp add --transport stdio photoshop-mcp -- npx -y @alisaitteke/photoshop-mcp@1.7.21Or add to the file .mcp.json, in the project
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"photoshop-mcp","type":"stdio","command":"npx","args":["-y","@alisaitteke/photoshop-mcp@1.7.21"]}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"photoshop-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the servers key.
Run in a terminal
codex mcp add photoshop-mcp -- npx -y @alisaitteke/photoshop-mcp@1.7.21Or add to the file ~/.codex/config.toml, for all projects
[mcp_servers.photoshop-mcp]
command = "npx"
args = ["-y", "@alisaitteke/photoshop-mcp@1.7.21"]If the file already exists, append the block to the end.
Add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"photoshop-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcp key.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the context_servers key.
Add to the file .codeassistant/mcp.json, in the project
{
"mcpServers": {
"photoshop-mcp": {
"command": "npx",
"args": [
"-y",
"@alisaitteke/photoshop-mcp@1.7.21"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Open Photoshop, then add the server: claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp. For a standalone chat window use npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui.
Other ways from the author
claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcpRequires Photoshop to be running.
This is third-party code. Review the repository files before installing.
What it does
The server drives Adobe Photoshop through a set of tools and prepackaged recipes that the agent calls from a plain-language request. It removes backgrounds with an editable mask, retouches portraits, prepares images for web and social in sRGB at the right size, splits a wide design into carousel slides and watermarks folders in bulk. Multi-step recipes land as a single undo step in Photoshop. A built-in browser chat window can be launched on its own and connected to your AI provider or to a Claude Code or Gemini CLI account.
Who it is for. For designers, retouchers and social media specialists who want to run Photoshop by words instead of clicks.
Good fit when
- You need to remove a background and keep an editable mask
- You need to prepare images for social formats
- You need to process a folder of images by one recipe
Not a fit when
- Photoshop is not running or the version is older than 2012
- You need generative fill features without an Adobe account
Example request
Remove the background from this portrait and keep an editable mask, then export an Instagram versionLimitations
An unofficial project, not affiliated with Adobe. You need Photoshop running on Windows or macOS and Node.js 18 or newer. Some features, such as generative fill, require an Adobe account. Anonymous aggregated usage analytics are collected by default and can be disabled. The built-in chat window needs an AI provider key or a CLI account login.
How to disable. Remove the server entry from your MCP client config. Turn off anonymous analytics as described in the project docs.
MCP
- Transport
- stdio
- Authentication
- not required
Security check
- Runs operations inside Photoshop and changes your files
- Collects anonymous usage analytics by default
README in short
The README shows scenarios: background removal, portrait retouch, web and social export, carousel splitting, batch watermarking and color grading. It covers npx setup, a standalone chat window option and configuration inside Cursor, Claude and VS Code. It notes the project is unofficial and not affiliated with Adobe, and that anonymous analytics are on by default and can be disabled. Localized READMEs and a project site are provided. MIT licensed.
FAQ
Do I need an Adobe account?
Not for basic operations. Generative fill and similar features require an Adobe account.
Can I work without an IDE?
Yes, there is a standalone browser chat window that connects to an AI provider or a CLI account.
Related
Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks
Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering
Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render