This MCP server provides a bridge between MCP clients and Adobe Photoshop on Windows. It enables AI assistants and other MCP-enabled agents to control Photoshop programmatically via a set of documented resources and tools, including creating and manipulating documents and layers, querying session information, and applying effects. The server is designed to run through a standard MCP host configuration (recommended using uvx) and relies on the Photoshop COM interfaces available on Windows. Once configured, you can invoke tools like create_document, create_text_layer, or get_document_info through your MCP client to perform common Photoshop automation tasks. The server exposes resources such as photoshop://info, photoshop://document/info, and photoshop://document/layers to inspect the current Photoshop state and document structure.

Prerequisites:

• Windows operating system (Windows only)
• Adobe Photoshop installed locally (tested with CC2017–2024)
• Python 3.10 or higher
• MCP host environment (e.g., a system that supports uvx-based configurations)

Installation steps:

1. Install the Photoshop MCP server package: pip install photoshop-mcp-server

   or using uv (if you prefer the uvx workflow)

   uv install photoshop-mcp-server

2. Ensure Photoshop is installed and accessible via COM on Windows. Launch Photoshop manually to initialize COM interfaces if needed.

3. Configure the MCP host to run the server (recommended via uvx, see configuration example in the README): { "mcpServers": { "photoshop": { "command": "uvx", "args": ["--python", "3.10", "photoshop-mcp-server"], "env": { "PS_VERSION": "2024" } } } }

4. Start the MCP host to launch the server and connect a client. The server will start listening through the MCP host as configured.

Tips and considerations:

• This server is Windows-only due to reliance on Photoshop's COM interfaces. Mac and Linux are not supported.
• PS_VERSION may need to be adjusted to match the installed Photoshop version (e.g., 2024, 2023, 2022).
• Use the standard uvx command format for compatibility with popular MCP hosts like Claude Desktop, Windsurf, and Cline.
• The available resources include photoshop://info, photoshop://document/info, and photoshop://document/layers. Tools cover document creation, layer manipulation (text layers, solid color layers, etc.), and session information retrieval.
• Ensure your Python version matches the --python argument when explicitly specifying a Python version (3.10–3.14 supported).
• Run Photoshop before starting the MCP server to ensure COM initialization succeeds, and keep Photoshop running while the MCP server is active.