Skip to content
Back to search

photoshop-mcp

SkillWorks with Claude CodeGitHub

Control Adobe Photoshop from Claude Code — 128 tools, recipes, generative AI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/alisaitteke/photoshop-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/alisaitteke/photoshop-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alisaitteke--photoshop-mcp/badge.svg)](/listings/alisaitteke--photoshop-mcp)

HTML

<a href="/listings/alisaitteke--photoshop-mcp"><img src="/api/listings/alisaitteke--photoshop-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 12 lines
  1. {
  2. "name": "photoshop-mcp",
  3. "displayName": "Photoshop MCP",
  4. "version": "1.7.38",
  5. "description": "Control Adobe Photoshop from Claude Code — 128 tools, recipes, generative AI.",
  6. "author": {
  7. "name": "Ali Sait Teke"
  8. },
  9. "homepage": "https://photoshop-mcp.com/",
  10. "repository": "https://github.com/alisaitteke/photoshop-mcp",
  11. "license": "MIT"
  12. }
README.md · README · 181 lines
  1. # Photoshop MCP
  2. <p align="center">
  3. <a href="https://github.com/alisaitteke/photoshop-mcp">
  4. <img src="./images/readme-hero-v2.png" alt="Photoshop MCP — tell Photoshop what you want, AI does the clicking" width="100%" />
  5. </a>
  6. </p>
  7. **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/)**
  8. [![npm version](https://img.shields.io/npm/v/@alisaitteke/photoshop-mcp.svg)](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)
  9. [![GitHub release](https://img.shields.io/github/v/release/alisaitteke/photoshop-mcp?include_prereleases)](https://github.com/alisaitteke/photoshop-mcp/releases)
  10. [![Action Plan](https://img.shields.io/badge/Action%20Plan-beta-amber.svg)](docs/standalone-ui.md#action-plan-beta)
  11. [![Jev routing](https://img.shields.io/badge/Jev%20routing-opt--in-31A8FF.svg)](#new-instant-edits-with-jev)
  12. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  13. [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
  14. [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()
  15. [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.alisaitteke%2Fphotoshop--mcp-purple.svg)](https://registry.modelcontextprotocol.io)
  16. [![MCP Toplist](https://mcptoplist.com/badge/io.github.alisaitteke%2Fphotoshop-mcp.svg)](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)
  17. [![Website](https://img.shields.io/badge/website-photoshop--mcp-cyan.svg)](https://photoshop-mcp.com/)
  18. [![Photoshop MCP Server MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/alisaitteke/photoshop-mcp/badges/card.svg)](https://glama.ai/mcp/servers/alisaitteke/photoshop-mcp)
  19. **Chat with Photoshop like a colleague.** Describe what you want in plain words —
  20. "remove this background", "resize these for Instagram" — and your AI assistant
  21. does the clicking for you. Works with Cursor, Claude, or the built-in chat
  22. window. No code, no scripts, no IDE required.
  23. > **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.
  24. ## New: instant edits with Jev
  25. <p align="center">
  26. <a href="docs/standalone-ui.md#jev-intent-routing-experimental-opt-in">
  27. <img src="./images/readme-hero-jev.png" alt="Jev routes each prompt before any LLM runs: one safe command goes straight to Photoshop with no LLM call; plans, visual checks and vague requests go to the LLM" width="100%" />
  28. </a>
  29. </p>
  30. Not every prompt needs a language model. The built-in chat window can now ask
  31. **Jev**, [TypeSafe AI](https://typesafe.ai)'s System One model, where each
  32. message should go before any LLM runs. When Jev is confident you asked for one
  33. of 26 safe commands and recipes (undo, opacity, blend mode, remove background,
  34. color grade, split carousel, …), or a short chain of them like "black and white,
  35. then opacity 50", it runs in Photoshop straight away: no LLM call, no LLM
  36. tokens. Anything else, and hard-to-undo steps like merge or flatten, goes to the
  37. Action Plan.
  38. ```bash
  39. TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui
  40. ```
  41. Experimental and opt-in. Without the key the UI works exactly as before and
  42. nothing is sent to TypeSafe; with it, prompts also go to `api.typesafe.ai`.
  43. Routes, thresholds and the off switch:
  44. [`docs/standalone-ui.md`](docs/standalone-ui.md#jev-intent-routing-experimental-opt-in).
  45. ## What can it do?
  46. - ✂️ **Remove backgrounds** — subject isolated with a clean, editable mask
  47. - 👤 **Retouch portraits** — skin smoothing, tone fixes, dodge & burn setup
  48. - 🌐 **Export for web & social** — sRGB, sharpened, correctly sized for Instagram, X, and more
  49. - 🎞️ **Make carousels** — split one wide design into seamless, numbered slides
  50. - 💧 **Watermark in bulk** — a whole folder of photos in one go, originals untouched
  51. - 🎨 **Color grade & more** — film looks, sky replacement, generative fill (Adobe account required)
  52. - ⏪ **Stay safe** — every multi-step "recipe" is a single undo step in Photoshop
  53. Under the hood: 128 tools (111 atomic + 17 one-step recipes) — full list in
  54. [`docs/available-tools.md`](docs/available-tools.md).
  55. ## Try saying
  56. ```
  57. Remove the background from this portrait — keep it editable with a mask.
  58. ```
  59. <img src="./images/recipe-remove-bg.svg" alt="Remove background: subject isolated on transparency" width="640" />
  60. ```
  61. Enhance this portrait — smooth the skin and fix the tones, medium intensity.
  62. ```
  63. <img src="./images/recipe-enhance-portrait.svg" alt="Enhance portrait: skin smoothing + auto tone in one undoable step" width="640" />
  64. ```
  65. Prepare this design for web, then export Instagram and X post variants.
  66. ```
  67. <img src="./images/recipe-prepare-web.svg" alt="Prepare for web: sRGB, downscale, sharpen, optimized JPEG" width="640" />
  68. ```
  69. Split this wide banner into a 5-slide seamless Instagram carousel.
  70. ```
  71. <img src="./images/recipe-carousel.svg" alt="Split one wide document into numbered carousel slides" width="640" />
  72. More recipes (batch watermark, passport photos, CSV-driven cards, mockups, …) and
  73. pre-engineered prompt templates: [`docs/prompt-layer.md`](docs/prompt-layer.md).
  74. ## Get started
  75. You need **Photoshop running** (Windows or macOS, any version 2012+) and **Node.js 18+**.
  76. ### Option 1 — Easiest: the built-in chat window
  77. ```bash
  78. npx -p @alisaitteke/photoshop-mcp ui
  79. ```
  80. A chat window opens in your browser. Sign in with an AI provider API key — or
  81. reuse your existing **Claude Code** / **Gemini CLI** account, no key needed.
  82. ![Standalone UI Screenshot](./images/frame_generic_light.png)
  83. Details, providers, Action Plan (API key or CLI account), and security notes:
  84. [`docs/standalone-ui.md`](docs/standalone-ui.md).
  85. ### Option 2 — Inside your AI app (Cursor, Claude, VS Code)
  86. **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.
  87. 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.
  88. [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=photoshop&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGlzYWl0dGVrZS9waG90b3Nob3AtbWNwIl19)
  89. [![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)
  90. Claude Code:
  91. ```bash
  92. claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp
  93. ```
  94. Or add this to your MCP client's config (Cursor, Claude Desktop, …):
  95. ```json
  96. {
  97. "mcpServers": {
  98. "photoshop": {
  99. "command": "npx",
  100. "args": ["-y", "@alisaitteke/photoshop-mcp"]
  101. }
  102. }
  103. }
  104. ```
  105. ## How it works
  106. 1. **You type** what you want in plain language.
  107. 2. **The AI plans** the steps, checking the document state first.
  108. 3. **Photoshop executes** — each recipe lands as one undoable step.
  109. Something went wrong? The AI reads the structured error and knows what to try
  110. next. Common fixes: [`docs/troubleshooting.md`](docs/troubleshooting.md).
  111. ## Documentation
  112. - [Available tools](docs/available-tools.md) — all 128 tools with parameters
  113. - [Standalone UI](docs/standalone-ui.md) — providers, auth modes, Action Plan, security
  114. - [Prompt layer](docs/prompt-layer.md) — prompt templates and recipes
  115. - [Architecture](docs/architecture.md) — how the bridge works under the hood
  116. - [Development](docs/development.md) — build from source, tests
  117. ## Contributing
  118. Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
  119. ## ❤️ Contributors & Credits
  120. Thanks to all our contributors!
  121. <a href="https://github.com/alisaitteke/photoshop-mcp/graphs/contributors"><img src="https://contrib.rocks/image?repo=alisaitteke/photoshop-mcp" alt="Contributors" /></a>
  122. ## Maintainer
  123. Built by **[Ali Sait Teke](https://alisait.com)** — [GitHub](https://github.com/alisaitteke) · [LinkedIn](https://www.linkedin.com/in/alisait/).
  124. ## License
  125. MIT
  126. Anonymous, aggregated usage analytics are collected by default and can be
  127. disabled anytime — details in [`docs/anonymous-usage-analytics.md`](docs/anonymous-usage-analytics.md).

Version history

  • v1.7.3811/11/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.