photoshop-mcp

Name: photoshop-mcp
Author: alisaitteke

Issues

MCP for Adobe Photoshop. 118 tools. Control from Cursor, Claude or custom LLMs.

755stars

77forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/alisaitteke/photoshop-mcp

Getting Started

Guides for using ai agents skills like photoshop-mcp.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportIssues

Last scanned: 6/13/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "concurrently: Vulnerability found",
      "severity": "critical"
    },
    {
      "type": "npm-audit",
      "message": "shell-quote: shell-quote quote() does not escape newlines in object .op values",
      "severity": "critical"
    }
  ],
  "status": "FAILED",
  "scannedAt": "2026-06-13T07:46:46.413Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

Compare with similar skills

See how photoshop-mcp compares with popular alternatives.

photoshop-mcp vs rea

See comparison

photoshop-mcp vs ecc

See comparison

photoshop-mcp vs hermes agent

See comparison

README.md

Frequently Asked Questions

What is photoshop-mcp?

photoshop-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by alisaitteke. MCP for Adobe Photoshop. 118 tools. Control from Cursor, Claude or custom LLMs. It has 755 GitHub stars.

Is photoshop-mcp safe to use?

photoshop-mcp failed SkillsLLM's automated security scan, which flagged one or more high-severity issues. Review the Security Report section carefully before using it.

How do I install photoshop-mcp?

Clone the repository with "git clone https://github.com/alisaitteke/photoshop-mcp" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is photoshop-mcp written in?

photoshop-mcp is primarily written in TypeScript. It is open-source under alisaitteke on GitHub, so you can review or fork the full source.

Are there alternatives to photoshop-mcp?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh photoshop-mcp against similar tools.

AI Courses · Agentic AI, LLM Engineering & MCP

Beginner to professional · First lesson free · Lifetime access

20% off

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

rea

by morluto

Reverse engineer anything with agents, from app behavior down to native binaries.

399,335

spectra-app anythingmcp

Photoshop MCP

Languages: English · 简体中文 · Español · Deutsch · 日本語 · Türkçe · Website

Chat with Photoshop like a colleague. Describe what you want in plain words — "remove this background", "resize these for Instagram" — and your AI assistant does the clicking for you. Works with Cursor, Claude, or the built-in chat window. No code, no scripts, no IDE required.

Note: This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.

New: instant edits with Jev

Not every prompt needs a language model. The built-in chat window can now ask Jev, TypeSafe AI's System One model, where each message should go before any LLM runs. When Jev is confident you asked for one of 26 safe commands and recipes (undo, opacity, blend mode, remove background, color grade, split carousel, …), or a short chain of them like "black and white, then opacity 50", it runs in Photoshop straight away: no LLM call, no LLM tokens. Anything else, and hard-to-undo steps like merge or flatten, goes to the Action Plan.

TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui

Experimental and opt-in. Without the key the UI works exactly as before and nothing is sent to TypeSafe; with it, prompts also go to api.typesafe.ai. Routes, thresholds and the off switch: docs/standalone-ui.md.

What can it do?

✂️ Remove backgrounds — subject isolated with a clean, editable mask
👤 Retouch portraits — skin smoothing, tone fixes, dodge & burn setup
🌐 Export for web & social — sRGB, sharpened, correctly sized for Instagram, X, and more
🎞️ Make carousels — split one wide design into seamless, numbered slides
💧 Watermark in bulk — a whole folder of photos in one go, originals untouched
🎨 Color grade & more — film looks, sky replacement, generative fill (Adobe account required)
⏪ Stay safe — every multi-step "recipe" is a single undo step in Photoshop

Under the hood: 128 tools (111 atomic + 17 one-step recipes) — full list in docs/available-tools.md.

Try saying

Remove the background from this portrait — keep it editable with a mask.

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.

Get started

You need Photoshop running (Windows or macOS, any version 2012+) and Node.js 18+.

Option 1 — Easiest: the built-in chat window

npx -p @alisaitteke/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.

Standalone UI Screenshot

Details, providers, Action Plan (API key or CLI account), and security notes: 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 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. The Install-in-Cursor button and a raw mcp.json entry still work, but they show a generic icon.

Claude Code:

claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp

Or add this to your MCP client's config (Cursor, Claude Desktop, …):

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"]
    }
  }
}

How it works

You type what you want in plain language.
The AI plans the steps, checking the document state first.
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.

Documentation

Available tools — all 128 tools with parameters
Standalone UI — providers, auth modes, Action Plan, security
Prompt layer — prompt templates and recipes
Architecture — how the bridge works under the hood
Development — build from source, tests

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a PR.

❤️ Contributors & Credits

Thanks to all our contributors!

Maintainer

Built by Ali Sait Teke — GitHub · LinkedIn.

License

MIT

Anonymous, aggregated usage analytics are collected by default and can be disabled anytime — details in docs/anonymous-usage-analytics.md.