Photoshop MCP Server

Unofficial project · Not affiliated with or endorsed by Adobe Inc.

An MCP (Model Context Protocol) server that lets Cursor, Claude Desktop, and other MCP clients control Adobe Photoshop from your IDE. Create documents, manage layers, apply filters, run actions, and automate workflows by describing what you want in natural language—no manual scripting required.

What is it?

You keep working in your editor; the AI sends commands to Photoshop via this server. “Create a 1920×1080 document, add a blue background, center the text ‘Hello’,” or “Open photo.jpg, apply auto levels, sharpen, save as edited.jpg.” The server talks to Photoshop using ExtendScript over AppleScript (macOS) or COM (Windows), so it works with Photoshop 2012 through current versions.

Key Features

50+ tools: Documents (create, open, save, close, crop), layers (create, delete, duplicate, merge, opacity, blend modes, visibility), text (font, size, color, alignment), filters (Gaussian blur, sharpen, noise, motion blur), color adjustments (brightness/contrast, hue/saturation, auto levels), selections and masks, undo/redo, and play actions or run custom ExtendScript.
Cross-platform: Windows and macOS, with automatic detection of the Photoshop installation.
Context tracking: After each operation the server returns document and layer state so the AI stays aware of the current file and active layer.
NPX-ready: Use npx @alisaitteke/photoshop-mcp; no global install needed.

Quick Start

1. Add to Cursor MCP config (e.g. .cursor/mcp.json or workspace MCP settings):

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"],
      "env": {
        "LOG_LEVEL": "1"
      }
    }
  }
}

2. (Optional) Set PHOTOSHOP_PATH if Photoshop is not in the default location.

3. Restart Cursor and ask your AI to run Photoshop operations (e.g. “Create a 800×600 document and add text ‘Test’”).

Technologies

TypeScript
MCP (Model Context Protocol) SDK
ExtendScript (via AppleScript on macOS, COM on Windows)

Installation

# Run with npx (recommended)
npx @alisaitteke/photoshop-mcp

# Or install globally
npm install -g @alisaitteke/photoshop-mcp