```
Enhance this portrait — smooth the skin and fix the tones, medium intensity.
```
```
Prepare this design for web, then export Instagram and X post variants.
```
```
Split this wide banner into a 5-slide seamless Instagram carousel.
```
More recipes (batch watermark, passport photos, CSV-driven cards, mockups, …) and
pre-engineered prompt templates: [`docs/prompt-layer.md`](docs/prompt-layer.md).
## Get started
You need **Photoshop running** (Windows or macOS, any version 2012+) and **Node.js 18+**.
### Option 1 — Easiest: the built-in chat window
```bash
npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui
```
A chat window opens in your browser. Sign in with an AI provider API key — or
reuse your existing **Claude Code** / **Gemini CLI** account, no key needed.
Details, providers, Action Plan (API key or CLI account), and security notes:
[`docs/standalone-ui.md`](docs/standalone-ui.md).
### Option 2 — Inside your AI app (Cursor, Claude, VS Code)
**Cursor (shows the Photoshop logo in the MCP list):** install the plugin from **Customize → Plugins**, or search the [Cursor Marketplace](https://cursor.com/marketplace) for `photoshop-mcp` once it is listed. That package still launches `npx -y @alisaitteke/photoshop-mcp`; the plugin manifest is what supplies the icon.
Until the Marketplace listing is live, copy `.cursor-plugin/`, `mcp.json`, and `assets/` into `~/.cursor/plugins/local/photoshop-mcp` and reload the window — details in [CONTRIBUTING.md](CONTRIBUTING.md#cursor-marketplace). The Install-in-Cursor button and a raw `mcp.json` entry still work, but they show a generic icon.
[](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)
[](https://vscode.dev/redirect/mcp/install?name=photoshop&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40alisaitteke%2Fphotoshop-mcp%22%5D%7D)
Claude Code:
```bash
claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
```
Or add this to your MCP client's config (Cursor, Claude Desktop, …):
```json
{
"mcpServers": {
"photoshop": {
"command": "npx",
"args": ["-y", "@alisaitteke/photoshop-mcp"]
}
}
}
```
## How it works
1. **You type** what you want in plain language.
2. **The AI plans** the steps, checking the document state first.
3. **Photoshop executes** — each recipe lands as one undoable step.
Something went wrong? The AI reads the structured error and knows what to try
next. Common fixes: [`docs/troubleshooting.md`](docs/troubleshooting.md).
## Documentation
- [Available tools](docs/available-tools.md) — all 116 tools with parameters
- [Standalone UI](docs/standalone-ui.md) — providers, auth modes, Action Plan, security
- [Prompt layer](docs/prompt-layer.md) — prompt templates and recipes
- [Architecture](docs/architecture.md) — how the bridge works under the hood
- [Development](docs/development.md) — build from source, tests
## Contributing
Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
## ❤️ Contributors & Credits
Thanks to all our contributors!