Photoshop
MCP server for Adobe Photoshop automation - Control Photoshop from AI assistants with 50+ tools for design, image editing, and workflow automation
What is Photoshop?
Photoshop is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for adobe photoshop automation - control photoshop from ai assistants with 50+ tools for design, image editing, and workflow automation
MCP server for Adobe Photoshop automation - Control Photoshop from AI assistants with 50+ tools for design, image editing, and workflow automation
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Adobe Photoshop automation - Control Photosho
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @alisaitteke/photoshop-mcpManual Installation
npx -y @alisaitteke/photoshop-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Photoshop
The Photoshop MCP Server enables AI assistants like Claude and Cursor to programmatically control Adobe Photoshop through 80 tools—68 atomic photoshop_* tools for precise operations and 12 photoshop_recipe_* tools for multi-step outcomes like background removal, portrait enhancement, color grading, and batch mockup replacement, each executed as a single undoable history state. It bridges natural language prompts and Photoshop's ExtendScript API, allowing designers and creative teams to automate repetitive image editing tasks, generate designs from descriptions, and integrate Photoshop into AI-driven production workflows without manual clicking.
Prerequisites
- Adobe Photoshop CC 2020 or later installed on macOS or Windows
- Node.js 18 or higher with npm and npx available
- An MCP-compatible client such as Claude Desktop or Cursor IDE
- Photoshop must be running before executing MCP tool calls
Install the Photoshop MCP package
Install the @alisaitteke/photoshop-mcp package globally via npm.
npm install -g @alisaitteke/photoshop-mcpEnsure Photoshop is running
Open Adobe Photoshop before connecting the MCP server. The server communicates with a running Photoshop instance via ExtendScript, so Photoshop must be active.
Configure your MCP client
Add the Photoshop MCP server to your claude_desktop_config.json.
{
"mcpServers": {
"photoshop": {
"command": "npx",
"args": ["-y", "@alisaitteke/photoshop-mcp"]
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop so it picks up the Photoshop server. You should see photoshop_* tools in the available tools list.
Verify the connection
Ask Claude to ping Photoshop and read its capabilities to confirm the server is communicating with the running Photoshop instance.
(Optional) Launch the standalone web UI
If you prefer a browser-based interface instead of Claude Desktop, launch the bundled web UI that lets you chat with AI and drive Photoshop without configuring an MCP client.
npx -p @alisaitteke/photoshop-mcp photoshop-mcp-uiPhotoshop Examples
Client configuration
Minimal claude_desktop_config.json entry for the Photoshop MCP Server.
{
"mcpServers": {
"photoshop": {
"command": "npx",
"args": ["-y", "@alisaitteke/photoshop-mcp"]
}
}
}Prompts to try
After connecting, use these prompts to automate Photoshop through Claude.
- "Ping Photoshop and read its capabilities for my installed version, then get the current document state"
- "Remove the background from the active portrait layer using Select Subject with a 2px feather mask"
- "Apply a warm film color grade to the open document as non-destructive adjustment layers"
- "Create a 1920x1080 document with a light blue background (RGB 240, 248, 255) and add centered text 'Welcome' in 64pt"
- "Set up frequency separation on the active raster layer with a 6px blur radius for retouching"
- "Export Instagram post and X post variants as separate JPEGs from the active document"Troubleshooting Photoshop
Tools return 'Photoshop not found' or connection errors
Ensure Adobe Photoshop is open and not in a dialog or modal state before sending commands. The server requires a running Photoshop instance accessible via the local scripting interface. Restart Photoshop if the issue persists.
Recipe tools fail with 'active layer is not a raster layer' error
Recipe tools like enhance-portrait and remove-background require the active layer to be a raster (pixel) layer. If it is a Smart Object or text layer, first rasterize it by asking Claude to 'rasterize the active layer' before running the recipe.
npx hangs or takes very long on first run
The first run downloads the package. Ensure you have a stable internet connection and npm cache is writable. You can also pre-install globally with `npm install -g @alisaitteke/photoshop-mcp` and use `photoshop-mcp` as the command in your config instead of npx.
Frequently Asked Questions about Photoshop
What is Photoshop?
Photoshop is a Model Context Protocol (MCP) server that mcp server for adobe photoshop automation - control photoshop from ai assistants with 50+ tools for design, image editing, and workflow automation It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Photoshop?
Install via npm with the command: npx -y @alisaitteke/photoshop-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Photoshop?
Photoshop works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Photoshop free to use?
Yes, Photoshop is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Photoshop Alternatives — Similar Developer Tools Servers
Looking for alternatives to Photoshop? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Photoshop in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Photoshop?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.