Back to packageRELEASE DETAILS

1.1.1

npm

00bx-photoshop-mcp

MCP server for Adobe Photoshop. 323 tools + 7 AI skills for design automation.

Published11 Feb 2026

Direct dependencies0

Transitive dependenciesNot calculated

README

Current package documentation

00bx-photoshop-mcp

MCP server for Adobe Photoshop. 323 tools + 7 AI skills for design automation via OpenCode.

Install

npm install -g 00bx-photoshop-mcp
00bx-photoshop-mcp-install

Installs everything to ~/.00bx-photoshop-mcp/ and 7 OpenCode skills to ~/.config/opencode/skills/.

Setup

1. Start the proxy

cd ~/.00bx-photoshop-mcp/adb-proxy-socket && node proxy.js

Keep this running. Background alternative:

nohup node proxy.js > /tmp/ps-proxy.log 2>&1 &

2. Load the UXP plugin

Open Adobe UXP Developer Tool (from Creative Cloud)
Add Plugin -> select ~/.00bx-photoshop-mcp/uxp/ps
Click Load
Open Photoshop

3. Add MCP config

Add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "adobe-photoshop": {
      "type": "local",
      "command": [
        "~/.00bx-photoshop-mcp/mcp/.venv/bin/python",
        "~/.00bx-photoshop-mcp/mcp/ps-mcp.py"
      ],
      "timeout": 30000,
      "enabled": true
    }
  }
}

Restart OpenCode. Done.

What's included

323 Tools

Category	Examples
Filters	Gaussian blur, motion blur, oil paint, sharpen, noise, pixelate, distortion
Layer styles	Drop shadow, inner glow, bevel, gradient overlay, stroke
Shapes	Rectangle, ellipse, polygon, line, arrow, custom path
Selections	Subject, sky, color range, focus area, expand, feather
Text	Single/multi-line, edit properties
Transforms	Scale, rotate, flip, perspective, warp, content-aware scale
Adjustments	Brightness, hue/sat, curves, levels, color balance, vibrance
Canvas	Create, crop, resize, rotate, trim
Layers	Create, duplicate, delete, group, merge, visibility, position
batchPlay	Execute any Photoshop command directly

7 AI Skills (auto-installed)

Skills load on-demand so they don't eat your context window.

Skill	What it covers
`ps-fundamentals`	Core rules, coordinate system, masks, smart objects
`ps-blend-modes`	All blend mode formulas and quick reference
`ps-tool-catalog`	Complete 323-tool reference by category
`ps-batchplay`	BatchPlay descriptors, reference forms, event codes
`ps-text-effects`	19 verified text effect recipes with exact parameters
`ps-photo-effects`	13 photo effects + 4 color grading recipes
`ps-advanced`	Filter ranges, workflow templates, gotchas, quality checklist

Architecture

OpenCode <-> MCP Server (Python) <-> Proxy (Node) <-> UXP Plugin <-> Photoshop

Requirements

Adobe Photoshop 2025/2026
Adobe UXP Developer Tool
Python 3.10+
Node.js 18+
OpenCode

Troubleshooting

"Could not connect to photoshop"

Check proxy is running: lsof -i :3001
Check UXP plugin is loaded
Make sure Photoshop is open

MCP not showing in OpenCode

Validate config: cat ~/.config/opencode/opencode.json | python3 -m json.tool
Restart OpenCode

Commands timeout

Increase timeout to 60000 in your config
Open a document in Photoshop first (some commands need one)

Attribution

Forked from mikechambers/adb-mcp. Extended from 50 to 323 tools with full filter/effect coverage.

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 0

Native requirements

0 direct targetsNot calculated transitive count

No declared dependencies in this collected response

Declarations describe requirements; they are not a resolved dependency graph.

Distribution files

1 collected

Distribution 1

Source distribution

Source file

Checksums from source

{
  "shasum": "b864831831622dbad59202dd428aeebb45cf3a4d",
  "tarball": "https://registry.npmjs.org/00bx-photoshop-mcp/-/00bx-photoshop-mcp-1.1.1.tgz",
  "fileCount": 80,
  "integrity": "sha512-MsBV4yoMfhgnjKjduFIviIXeFAV4yW4OeGbvn4WlCjzKPmFF0TKqPSdJwmzvPcQmd/djxU/a58t8UXmkY/7y8g==",
  "signatures": [
    {
      "sig": "MEQCIGe65gy4rvbEPd5mcHgl6N1a2J8LCx/ZBl2cl1TWwjzgAiACuQ7ABTE9TrvnihHpxDO5phfpEFBMaspCTiFaBH3kFA==",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 1405071
}

Repository

PENDING

00bx/00bx-photoshop-mcp

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 16:33 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:383cc0f93e903e353fac76b07a436af4802aae4770e0aa205284a9bd8a7f2249

Other collected versions

1.1.211 Feb 1.1.010 Feb 1.0.310 Feb 1.0.210 Feb 1.0.110 Feb 1.0.010 Feb View all collected versions →