create_documentLABSCO SUMMARY
Windows only, and PS_VERSION decides which Photoshop it attaches to.
The platform limit is absolute — COM is the integration — so check that before anything else. If you clear it, the version variable is the setting that matters next: with several Photoshop installs on a machine, PS_VERSION is what points the server at the right one. Resources give the assistant the current document and layer state without a tool call.
What it is
A bridge between MCP clients and Adobe Photoshop, built on photoshop-python-api and Windows COM.
What you get
- Document tools — create, open and save documents
- Layer tools — create text layers, solid colour layers and more
- Session tools — information about the Photoshop session, the active document and the current selection
- Effects and adjustments applied to images
- Read-only resources: photoshop://info for the application, photoshop://document/info for the active document, and photoshop://document/layers for its layers
Requirements
Windows only — it depends on Windows COM interfaces, and macOS and Linux cannot run it. Adobe Photoshop installed locally, tested from CC2017 through 2024, and Python 3.10 or higher. Install photoshop-mcp-server from PyPI, then configure your MCP host with the uvx command and PS_VERSION set to the Photoshop version you want to connect to.
Setup effort
One command — pip install photoshop-mcp-server
USE CASES
01
Starting a document to spec
Create it at the dimensions you need and add the text layer in the same request.
02
Asking about a file you have open
Read the active document's information and layer structure without clicking through the panel.
03
Making a simple graphic
Build a background fill and a styled text layer for a social post, then save it.
04
Attaching to a specific Photoshop version
Set PS_VERSION so the server connects to the install you meant.
2 tools
Listed in project docs. Your client may show a different list.
create_text_layerBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- uvx on PATH
- Python Version 3.10
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install photoshop-mcp-serverMCP Clients
Claude Desktop, Windsurf, Other MCP clients
JSON
{
"mcpServers": {
"photoshop": {
"command": "uvx",
"args": [
"--python",
"3.10",
"photoshop-mcp-server"
],
"env": {
"PS_VERSION": "2024"
}
}
}
}
