PsMCP-MCP-Server-for-Photoshop
LocalAbout PsMCP-MCP-Server-for-Photoshop
A Photoshop MCP server built with win32com, accompanied by a Gradio client using Gemini. It exposes tools for automating Photoshop tasks and can be configured for MCP clients such as Claude and Cursor.
Key features
- 01Photoshop interaction through win32com
- 02Tools for Photoshop tasks
- 03Gradio client with Gemini
- 04Configurable PSD, asset, and export directories
Use cases
- 01Automate text insertion, resizing, and exports
- 02Batch-edit PSD files in design pipelines
- 03Generate marketing creatives from templates
- 04Toggle layers or apply effects with scripts
MCP support
The server exposes Photoshop tools to MCP clients, with setup examples for Claude and Cursor. The project also includes a Gradio MCP client using Gemini.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEPsMCP-MCP-Server-for-Photoshop
Watch the Demo Below
Usage
Install Requirements
Activate your Python environment and install dependencies:
pip install -r requirements.txt
Run Using the Gradio Client Provided
Heads Up: The Gemini Gradio client I've provided, for some reason does only a maximum of one tool call for any request, use this just to test the tool. For actual usage use Claude ot Cursor
Set Gemini Key in .env
GEMINI_API_KEY = PASTE_YOUR_KEY_HERE
Set Directories for PSDs, Assets and Exports
PSD_DIRECTORY = "D:\\Photoshop Files"
EXPORT_DIRECTORY = "D:\\PsMCP-Exports"
ASSETS_DIR = "D:\\PsMCP-Assets"
Run the App and connect to the Server
python app.py
Configure Server with Any MCP Client (Claude, Cursor, etc)
Add Server to Config file as follows to access the tools
{
"mcpServers": {
"PhotoshopAdv": {
"command": "uv",
"args": [
"--directory",
"Path/To/Directory",
"run",
"psMCP.py"
],
"timeout": 60000
}
}
}
Use Cases
- Automate repetitive Photoshop tasks (e.g., inserting text, resizing, exporting).
- Build custom design pipelines for batch PSD editing.
- Rapidly generate marketing creatives from templates.
- Toggle layers or apply effects dynamically through Python scripts.
- Streamline creative asset versioning and export processes.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.

