photoshop-python-api-mcp-server

MCP.Pizza Chef: loonghao

Windows only, and it needs Adobe Photoshop already installed on the same computer. Despite the broad claims on its front page, what actually ships today is narrow but useful: create, open, and save documents, add a text layer or a solid colour fill layer, and report back on the open document, its layers, and the current selection. There is no filter, effect, or adjustment control. Setup is a short block pasted into Claude Desktop, Cline, or Windsurf.

Images/Design

Use This MCP server To

Start a new Photoshop file at the size I name Add a headline as a text layer without touching the toolbar Put a solid colour background behind my artwork Ask how many layers my open file has Save the document I am working on

README

Photoshop MCP Server

⚠️ WINDOWS ONLY: This server only works on Windows operating systems due to its dependency on Windows-specific COM interfaces.

A Model Context Protocol (MCP) server for Photoshop integration using photoshop-python-api.

English | 简体中文

Overview

This project provides a bridge between the Model Context Protocol (MCP) and Adobe Photoshop, allowing AI assistants and other MCP clients to control Photoshop programmatically.

Photoshop MCP Server Demo

photoshop-python-api-mcp-server FAQ

Does this work on a Mac?

No. It is Windows only because of how it talks to Photoshop, and macOS and Linux cannot run it at all.

Do I need Photoshop already?

Yes, installed and licensed on the same Windows machine. Versions from CC2017 through 2024 are the tested range.

Can I use this to apply a filter or a photo adjustment?

Not today. The front page hints at effects, but the tools that actually ship cover documents, text layers, and solid colour fill layers only.

Can I use this to build a simple social post?

Partly. You can create the document, lay in a colour background, and place text, but gradients and effects are not included.

Do I need an account key?

No. It drives the copy of Photoshop already on your machine, and nothing is sent to an outside service.

How hard is the setup?

You install one Python package and paste a short block into your assistant's settings, naming your Photoshop version. Some comfort with a terminal helps.

Which apps does it work in?

Claude Desktop, Cline, and Windsurf are named in the instructions, and the same configuration works in other MCP apps.

Is it maintained?

Yes, with updates as recent as July 2026.