PsMCP-MCP-Server-for-Photoshop

@Chandrahas455

About PsMCP-MCP-Server-for-Photoshop

An Extensive MCP server and a Gradio MCP client ( with Gemini ) with several tools made using win32com to intereact with Photoshop. Designing with Photoshop has never been more fun!

Config

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

{
  "mcpServers": {
    "PsMCP-MCP-Server-for-Photoshop": {
      "command": "python",
      "args": [
        "app.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is PsMCP-MCP-Server-for-Photoshop?

PsMCP-MCP-Server-for-Photoshop connects MCP‑compatible AI assistants (like Claude and Cursor) to Adobe Photoshop. It exposes Photoshop actions as tools that can be called to automate image editing, layer management, and file export. This server is aimed at developers and designers who want to script Photoshop workflows through natural language or Python.

How to use PsMCP-MCP-Server-for-Photoshop?

Install dependencies from requirements.txt, set the required environment variables (GEMINI_API_KEY, PSD_DIRECTORY, EXPORT_DIRECTORY, ASSETS_DIR) in a .env file, then run app.py. For production use, configure the server in your MCP client’s settings file (e.g., Claude or Cursor) with the command uv --directory <path> run psMCP.py and a timeout of 60000–100000 ms. A Gradio client is provided for quick testing, but note it only makes at most one tool call per request.

Key features of PsMCP-MCP-Server-for-Photoshop

Connects AI assistants to Adobe Photoshop tools.
Automates repetitive tasks like resizing, text insertion, and export.
Supports batch PSD editing with custom pipelines.
Enables dynamic layer toggling and effect application.
Integrates with Gemini API for optional test runs.

Use cases of PsMCP-MCP-Server-for-Photoshop

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.

FAQ from PsMCP-MCP-Server-for-Photoshop

What does PsMCP-MCP-Server-for-Photoshop do?

It exposes Adobe Photoshop functions as MCP tools so that an AI assistant (Claude, Cursor, etc.) can control Photoshop actions directly from a chat interface or script.

How do I set up PsMCP-MCP-Server-for-Photoshop?

Install Python dependencies with pip install -r requirements.txt, create a .env file with your GEMINI_API_KEY and directory paths for PSDs, exports, and assets, then run python app.py.

What are the system dependencies?

The server requires Python and the packages listed in requirements.txt. It also needs Adobe Photoshop installed on the same machine to control it via scripting.

Are there any known limitations?

The included Gradio client (using Gemini) only executes a single tool call per request. For reliable multi‑step workflows you should use a full MCP client like Claude or Cursor.

How do I connect PsMCP-MCP-Server-for-Photoshop to my MCP client?

Add the server to your MCP client’s configuration file (e.g., mcpServers in Claude’s config) with the command uv --directory /path/to/server run psMCP.py and set an appropriate timeout.

Frequently asked questions

What does PsMCP-MCP-Server-for-Photoshop do?

It exposes Adobe Photoshop functions as MCP tools so that an AI assistant (Claude, Cursor, etc.) can control Photoshop actions directly from a chat interface or script.

How do I set up PsMCP-MCP-Server-for-Photoshop?

Install Python dependencies with `pip install -r requirements.txt`, create a `.env` file with your `GEMINI_API_KEY` and directory paths for PSDs, exports, and assets, then run `python app.py`.

What are the system dependencies?

The server requires Python and the packages listed in `requirements.txt`. It also needs Adobe Photoshop installed on the same machine to control it via scripting.

Are there any known limitations?

The included Gradio client (using Gemini) only executes a single tool call per request. For reliable multi‑step workflows you should use a full MCP client like Claude or Cursor.

How do I connect PsMCP-MCP-Server-for-Photoshop to my MCP client?

Add the server to your MCP client’s configuration file (e.g., `mcpServers` in Claude’s config) with the command `uv --directory /path/to/server run psMCP.py` and set an appropriate timeout.

Comments

Basic information

More Media & Design MCP servers

Uwear.ai

Run complete AI fashion photoshoots from ChatGPT, Claude, or Codex. Turn flat-lay, packshot, and mannequin product images into catalog-ready on-model photos and video with saved art direction, automatic QA, and catalog-s

Lamina — On-brand product photos, video & try-ons

Lamina

Generate on brand product videos from Claude Code (or any assistant) in one line. Lamina turns a brief + your brand kit into finished product photos, video reels, and campaign banners - no prompt engineering; brand guard