{ "markdown": "# Photoshop MCP\n\n

\n \n \"Photoshop\n \n

\n\n**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://photoshop-mcp.com/)**\n\n[![npm version](https://img.shields.io/npm/v/@alisaitteke/photoshop-mcp.svg)](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)\n[![GitHub release](https://img.shields.io/github/v/release/alisaitteke/photoshop-mcp?include_prereleases)](https://github.com/alisaitteke/photoshop-mcp/releases)\n[![Action Plan](https://img.shields.io/badge/Action%20Plan-beta-amber.svg)](docs/standalone-ui.md#action-plan-beta)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)\n[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.alisaitteke%2Fphotoshop--mcp-purple.svg)](https://registry.modelcontextprotocol.io)\n[![MCP Toplist](https://mcptoplist.com/badge/io.github.alisaitteke%2Fphotoshop-mcp.svg)](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)\n[![Website](https://img.shields.io/badge/website-photoshop--mcp-cyan.svg)](https://photoshop-mcp.com/)\n\n**Chat with Photoshop like a colleague.** Describe what you want in plain words —\n\"remove this background\", \"resize these for Instagram\" — and your AI assistant\ndoes the clicking for you. Works with Cursor, Claude, or the built-in chat\nwindow. No code, no scripts, no IDE required.\n\n> **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.\n\n## What can it do?\n\n- ✂️ **Remove backgrounds** — subject isolated with a clean, editable mask\n- 👤 **Retouch portraits** — skin smoothing, tone fixes, dodge & burn setup\n- 🌐 **Export for web & social** — sRGB, sharpened, correctly sized for Instagram, X, and more\n- 🎞️ **Make carousels** — split one wide design into seamless, numbered slides\n- 💧 **Watermark in bulk** — a whole folder of photos in one go, originals untouched\n- 🎨 **Color grade & more** — film looks, sky replacement, generative fill (Adobe account required)\n- ⏪ **Stay safe** — every multi-step \"recipe\" is a single undo step in Photoshop\n\nUnder the hood: 118 tools (102 atomic + 16 one-step recipes) — full list in\n[`docs/available-tools.md`](docs/available-tools.md).\n\n## Try saying\n\n```\nRemove the background from this portrait — keep it editable with a mask.\n```\n\n\"Remove\n\n```\nEnhance this portrait — smooth the skin and fix the tones, medium intensity.\n```\n\n\"Enhance\n\n```\nPrepare this design for web, then export Instagram and X post variants.\n```\n\n\"Prepare\n\n```\nSplit this wide banner into a 5-slide seamless Instagram carousel.\n```\n\n\"Split\n\nMore recipes (batch watermark, passport photos, CSV-driven cards, mockups, …) and\npre-engineered prompt templates: [`docs/prompt-layer.md`](docs/prompt-layer.md).\n\n## Get started\n\nYou need **Photoshop running** (Windows or macOS, any version 2012+) and **Node.js 18+**.\n\n### Option 1 — Easiest: the built-in chat window\n\n```bash\nnpx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui\n```\n\nA chat window opens in your browser. Sign in with an AI provider API key — or\nreuse your existing **Claude Code** / **Gemini CLI** account, no key needed.\n\n![Standalone UI Screenshot](./images/frame_generic_light.png)\n\nDetails, providers, and security notes: [`docs/standalone-ui.md`](docs/standalone-ui.md).\n\n### Option 2 — Inside your AI app (Cursor, Claude, VS Code)\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)\n[![Install in VS Code](https://img.shields.io/badge/Install%20in-VS%20Code-0098FF)](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)\n\nClaude Code:\n\n```bash\nclaude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp\n```\n\nOr add this to your MCP client's config (Cursor, Claude Desktop, …):\n\n```json\n{\n \"mcpServers\": {\n \"photoshop\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@alisaitteke/photoshop-mcp\"]\n }\n }\n}\n```\n\n## How it works\n\n1. **You type** what you want in plain language.\n2. **The AI plans** the steps, checking the document state first.\n3. **Photoshop executes** — each recipe lands as one undoable step.\n\nSomething went wrong? The AI reads the structured error and knows what to try\nnext. Common fixes: [`docs/troubleshooting.md`](docs/troubleshooting.md).\n\n## Documentation\n\n- [Available tools](docs/available-tools.md) — all 118 tools with parameters\n- [Standalone UI](docs/standalone-ui.md) — providers, auth modes, Action Plan, security\n- [Prompt layer](docs/prompt-layer.md) — prompt templates and recipes\n- [Architecture](docs/architecture.md) — how the bridge works under the hood\n- [Development](docs/development.md) — build from source, tests\n\n## Contributing\n\nContributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.\n\n## Maintainer\n\nBuilt by **[Ali Sait Teke](https://alisait.com)** — [GitHub](https://github.com/alisaitteke) · [LinkedIn](https://www.linkedin.com/in/alisait/).\n\n## License\n\nMIT\n\nAnonymous, aggregated usage analytics are collected by default and can be\ndisabled anytime — details in [`docs/anonymous-usage-analytics.md`](docs/anonymous-usage-analytics.md).\n", "bytes": 6272, "sha": "0de95b4d47ede35ee0642ce780d8485a31e4ef6bf9e84922c53f01e02bef8039", "repo_slug": "alisaitteke/photoshop-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_alisaitteke_photoshop_mcp_f8b5e532/readme" }