Photoshop MCP Server

Photoshop MCP Server is an MCP server that integrates AI assistants with Adobe Photoshop using the photoshop-python-api library. Built specifically for Windows operating systems, it bridges Model Context Protocol clients like Claude Desktop, Windsurf, and Cline with locally running versions of Adobe Photoshop ranging from CC 2017 through 2024. Graphic designers, creative technologists, and digital artists use it to execute routine graphic design workflows through natural language prompts. The server exposes tools and resources that inspect application states, query active documents, inspect layer trees, generate solid color layers, and insert styled text layers. By routing instructions through Windows COM interfaces, AI agents can programmatically manipulate canvas elements, review PSD structures, open and save image files, and apply adjustments to active graphic documents without manual intervention.

Category: Design, Media & Creative

Tags: adobe, automation, graphics, image editing, photoshop

Visit Photoshop MCP Server

How to install and configure Photoshop MCP Server

1. Verify you are running Windows OS with Python 3.10 or higher and Adobe Photoshop (CC 2017–2024) installed. 2. Install the package using pip by running pip install photoshop-mcp-server, or with uv using uv install photoshop-mcp-server. 3. Open your MCP client configuration file (such as Claude Desktop, Windsurf, or Cline). 4. Add the server entry under mcpServers using uvx: json { "mcpServers": { "photoshop": { "command": "uvx", "args": ["--python", "3.10", "photoshop-mcp-server"], "env": { "PS_VERSION": "2024" } } } } 5. Update the PS_VERSION environment variable to match your installed version (e.g., "2023" or "2024"), then restart your client.

What you can do with Photoshop MCP Server

• Creating new Photoshop documents with specific canvas dimensions and resolutions through natural language commands. - Generating and styling text layers automatically with designated fonts, alignments, and content strings. - Inspecting open PSD files to analyze layer hierarchies, count group folders, and list adjustment layers. - Adding solid color or gradient background layers to active projects for automated graphic asset creation. - Opening existing image files from local disk and saving finished compositions without manual menu navigation.

Key facts

• https://github.com/loonghao/photoshop-python-api-mcp-server
• Design, Media & Creative, Developer Tools & Code Intelligence
• adobe, automation, graphics, image editing, photoshop

Part of MCP Servers

What can Photoshop MCP Server do?

Photoshop MCP Server allows AI assistants to interact with Adobe Photoshop on Windows. It can create, open, and save documents, add and manipulate text and solid color layers, read layer hierarchies, and retrieve session or document metadata through Model Context Protocol tools and resources.

Does Photoshop MCP Server work on macOS or Linux?

No, Photoshop MCP Server works strictly on Windows operating systems. It relies directly on Windows-specific COM interfaces to communicate with Adobe Photoshop, meaning macOS and Linux environments are not supported.

Which MCP clients work with Photoshop MCP Server?

Any standard Model Context Protocol client running on Windows works with this server, including Claude Desktop, Windsurf, and Cline. It connects locally using uvx execution specified in the client configuration.

Is Photoshop MCP Server open source?

Yes, Photoshop MCP Server is open source and distributed under the MIT license. You can view, modify, and contribute to the source code on GitHub at https://github.com/loonghao/photoshop-python-api-mcp-server.

Which Adobe Photoshop versions are supported?

The server has been tested with Adobe Photoshop CC 2017 through version 2024. You specify your target installation by configuring the PS_VERSION environment variable in your MCP client settings.