# 00bx Photoshop Mcp

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-00bx-00bx-photoshop-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [00bx](https://agentstack.voostack.com/s/00bx)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [00bx](https://github.com/00bx)
- **Source:** https://github.com/00bx/00bx-photoshop-mcp

## Install

```sh
agentstack add mcp-00bx-00bx-photoshop-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 00bx-photoshop-mcp

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

## Install

```bash
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

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

Keep this running. Background alternative:

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

### 2. Load the UXP plugin

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

### 3. Add MCP config

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

```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](https://github.com/mikechambers/adb-mcp). Extended from 50 to 323 tools with full filter/effect coverage.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [00bx](https://github.com/00bx)
- **Source:** [00bx/00bx-photoshop-mcp](https://github.com/00bx/00bx-photoshop-mcp)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-00bx-00bx-photoshop-mcp
- Seller: https://agentstack.voostack.com/s/00bx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.