MCP.so
Sign In

Photoshop MCP Server

@loonghao

Basic information

Category

Media & Design

Last updated

License

MIT

Transports

stdio

Author

loonghao

About Photoshop MCP Server

A Model Context Protocol (MCP) server that interfaces with Adobe Photoshop's Python API. Enables LLMs to execute image editing operations, automate workflows, and manage Photoshop tasks through structured commands and context-aware interactions.

Before you connect

Documentation reviewed 2026-10-25

When to choose this server

This Photoshop integration uses Windows COM through photoshop-python-api. It is suitable for automating an installed Photoshop application on Windows.

Setup and limitations

The maintainer explicitly excludes macOS and Linux. Python 3.10 or newer and Photoshop are required. Before troubleshooting client settings, check the operating system and COM access; choosing a different Python executable will not make this project work on macOS.

These notes check the linked documentation, not a live authenticated connection. Suggested checks are steps for you to run.

Photoshop MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "photoshop": {
      "command": "uvx",
      "args": [
        "--python",
        "3.10",
        "photoshop-mcp-server"
      ],
      "env": {
        "PS_VERSION": "2024"
      }
    }
  }
}

Photoshop MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Photoshop MCP Server?

Photoshop MCP Server is a Model Context Protocol (MCP) server that bridges MCP‑compatible AI assistants with Adobe Photoshop on Windows. It uses the photoshop-python-api to allow programmatic control of Photoshop documents, layers, and effects.

How to use Photoshop MCP Server?

Install via pip install photoshop-mcp-server or uv install photoshop-mcp-server, then add the server to your MCP host configuration (e.g., Claude Desktop, Windsurf, Cline) using uvx and set the PS_VERSION environment variable. Once configured, you can ask your AI assistant to perform Photoshop tasks.

Key features of Photoshop MCP Server

  • Create, open, and save Photoshop documents
  • Create and manipulate text and solid color layers
  • Retrieve Photoshop session and document information
  • Apply effects and adjustments to images
  • Exposes resources: photoshop://info, photoshop://document/info, photoshop://document/layers

Use cases of Photoshop MCP Server

  • Generate and edit documents via natural‑language chat commands
  • Automate layer creation and styling for social media posts
  • Analyze existing PSD files (e.g., count layers, get layer structure)
  • Integrate Photoshop into larger MCP‑based workflows

Frequently asked questions

1

What operating systems are supported?

Only Windows. The server communicates with Photoshop via Windows‑specific COM interfaces and does not work on macOS or Linux.

2

What Python version is required?

Python 3.10 or higher. You can explicitly specify a version (3.10–3.14) in the `uvx` arguments.

3

How do I specify which Photoshop version to connect to?

Set the environment variable `PS_VERSION` in your MCP host configuration (e.g., `"PS_VERSION": "2024"`). Versions CC2017 through 2024 are tested.

4

How is the server installed?

Install via pip: `pip install photoshop-mcp-server`, or via uv: `uv install photoshop-mcp-server`.

5

What MCP hosts are supported?

It works with any standard MCP host, including Claude Desktop, Windsurf, and Cline. Configuration follows the `uvx` command format.

Comments

More Media & Design MCP servers