1. Home
  2. Photoshop MCP Server
  3. Photoshop MCP Server for Cursor: Setup & Config

Data as of

Photoshop MCP Server for Cursor: Setup & Config

Photoshop MCP Server lets Cursor control a locally installed Photoshop through photoshop-python-api.

What you can do with Photoshop in Cursor

A Windows Photoshop bridge for assistant-driven document creation, layer work, and inspection.

  • Save documents through an assistant workflow.
  • Build image compositions using layer and adjustment operations.

Before you start: Photoshop in Cursor

  • Windows
  • Locally installed Adobe Photoshop
  • Python 3.10+
  • uv / uvx for the recommended configuration

The README reports testing Photoshop CC2017 through 2024. macOS and Linux are not supported. Set PS_VERSION to the local release you intend to control.

Photoshop Cursor configuration

  1. Choose Cursor configuration scope

    For Photoshop MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

  2. Add Photoshop MCP Server to Cursor

    Use the photoshop-python-api-mcp-server entry below in mcpServers. Keep Photoshop MCP Server's documented stdio connection fields and your other Cursor entries.

  3. Check Photoshop MCP Server in Cursor

    Photoshop MCP Server: Enable in Cursor’s MCP settings; inspect tools.

Config file · Project: .cursor/mcp.json

User: ~/.cursor/mcp.json

JSON
{
  "mcpServers": {
    "photoshop-python-api-mcp-server": {
      "command": "uvx",
      "args": [
        "--python",
        "3.10",
        "photoshop-mcp-server"
      ],
      "env": {
        "PS_VERSION": "<Installed Photoshop version, such as 2024>"
      }
    }
  }
}

Photoshop tools available to Cursor

Photoshop's stored tool list documents 2 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

create_document

Find create_document under Photoshop in Cursor's MCP settings; inspect its arguments when the agent requests a call.

create_text_layer

Find create_text_layer under Photoshop in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Add a text layer to a Photoshop document.

Photoshop: full stored tool descriptions

Troubleshooting Photoshop in Cursor

  • Cursor must find uvx --python (from uv, for Python tools) for Photoshop MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
  • Review PS_VERSION for Photoshop MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
  • Photoshop MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
  • Known limitation: Runs only on Windows because of COM dependencies.
  • Known limitation: Requires Photoshop to be installed locally.
  • General Cursor troubleshooting lives in the /clients/cursor guide.

Photoshop MCP Server — details. Cursor guide

Frequently asked questions

Cursor's Photoshop MCP Server entry belongs under mcpServers in .cursor/mcp.json (project) or ~/.cursor/mcp.json (user). Confirm the active scope in MCP settings.

Cursor's photoshop-python-api-mcp-server example uses stdio.

Photoshop MCP Server's Cursor configuration invokes uvx --python (from uv, for Python tools).

Cursor's Photoshop MCP Server example references PS_VERSION. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

Photoshop MCP Server's stored list contains 2 tools, including create_document, create_text_layer. Compare those names with Cursor's connected tool list; the stored list is not a live check.

Set PS_VERSION in the MCP host environment.

The README lists application information, active-document information, and active-document layers.