# Photoshop MCP

> MCP server for Adobe Photoshop — 1.6.1 — 102 tools (generative AI + 16 recipe workflows), standalone web UI, and state-aware agent workflows. Control Photoshop from Cursor, Claude Desktop, Claude Code, or natural language. Unofficial; not affiliated with Adobe.

Important notes:

- Prefer `photoshop_recipe_*` for multi-step outcomes (single Photoshop undo step); use atomic `photoshop_*` tools for precise edits.
- Agent workflow: `get_capabilities` → `get_state` → act → `get_preview` to verify.
- Prerequisites: Adobe Photoshop running on Windows or macOS, Node.js 18+.
- MCP stdio: `npx -y @alisaitteke/photoshop-mcp` · Standalone UI: `npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui`

## Docs

- [Home](https://alisaitteke.github.io/photoshop-mcp/): Marketing landing — quick start, features, links
- [Full README](https://alisaitteke.github.io/photoshop-mcp/readme/): Install, MCP client config, standalone UI, tool catalog overview
- [Architecture](https://alisaitteke.github.io/photoshop-mcp/docs/architecture/): System design, data flow, platform abstraction
- [Available tools](https://alisaitteke.github.io/photoshop-mcp/docs/available-tools/): Complete `photoshop_*` tool reference
- [Prompt layer](https://alisaitteke.github.io/photoshop-mcp/docs/prompt-layer/): MCP prompts, recipes, server instructions
- [Development](https://alisaitteke.github.io/photoshop-mcp/docs/development/): Local build, testing, UXP bridge plugin
- [Troubleshooting](https://alisaitteke.github.io/photoshop-mcp/docs/troubleshooting/): Common connection and script errors

## Translations

- [Türkçe README](https://alisaitteke.github.io/photoshop-mcp/tr/readme/): Turkish full README
- [简体中文 README](https://alisaitteke.github.io/photoshop-mcp/zh/readme/): Chinese full README
- [Español README](https://alisaitteke.github.io/photoshop-mcp/es/readme/): Spanish full README
- [Deutsch README](https://alisaitteke.github.io/photoshop-mcp/de/readme/): German full README
- [日本語 README](https://alisaitteke.github.io/photoshop-mcp/ja/readme/): Japanese full README

## Distribution

- [npm package](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp): `@alisaitteke/photoshop-mcp`
- [MCP Registry](https://registry.modelcontextprotocol.io): `io.github.alisaitteke/photoshop-mcp`
- [GitHub repository](https://github.com/alisaitteke/photoshop-mcp): Source, issues, releases
- [Agent map (AGENTS.md)](https://github.com/alisaitteke/photoshop-mcp/blob/main/AGENTS.md): Navigation for coding agents

## Optional

- [Usage analytics](https://alisaitteke.github.io/photoshop-mcp/docs/anonymous-usage-analytics/): Opt-out anonymous telemetry
- [Social preview assets](https://alisaitteke.github.io/photoshop-mcp/docs/social-preview/): OG image and share copy
- [Sitemap](https://alisaitteke.github.io/photoshop-mcp/sitemap.xml): All canonical site URLs
- [llms-full.txt](https://alisaitteke.github.io/photoshop-mcp/llms-full.txt): This index plus condensed architecture and quick-start text