Skip to content
Back to search

adb-mcp

adb-mcp is a proof of concept project to enabled AI control of Adobe tools (Adobe Photoshop and Adobe Premiere) by providing an interface to LLMs via the MCP protocol.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

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

HTML

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

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This guide assumes you're using Claude Desktop. Other MCP-compatible AI applications should work similarly.

Download Source Code

Clone or download the source code from the [main project page](https://github.com/mikechambers/adb-mcp).

Install Claude Desktop

1. Download and install [Claude Desktop](https://claude.ai/download) 2. Launch Claude Desktop to verify it works

Note, you can use any client / code that supports MCP, just follow its instructions for how to configure.

Install MCP for Development

Navigate to the project directory and run:

Photoshop

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py

Premiere Pro

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py

InDesign

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow id-mcp.py

AfterEffects

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ae-mcp.py

Illustrator

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ai-mcp.py

Restart Claude Desktop after installation.

Set Up Proxy Server

Using Prebuilt Executables (Recommended)

1. Download the appropriate executable for your platform from the latest [release](https://github.com/mikechambers/adb-mcp/releases) (files named like `adb-proxy-socket-macos-x64.zip` (Intel), `adb-proxy-socket-macos-arm64.zip` (Silicon), or `adb-proxy-socket-win-x64.exe.zip`). 2. Unzip the executable. 3. Double click or run from the console / terminal

Running from Source

1. Navigate to the adb-proxy-socket directory 2. Run `node proxy.js`

You should see a message like: `Photoshop MCP Command proxy server running on ws://localhost:3001`

**Keep this running** — the proxy server must stay active for Claude to communicate with Adobe plugins.

Install Plugins

Photoshop, Premiere Pro, InDesign (UXP)

1. Launch **UXP Developer Tools** from Creative Cloud 2. Enable developer mode when prompted 3. Select **File > Add Plugin** 4. Navigate to the appropriate directory and select **manifest.json**: - **Photoshop**: `uxp/ps/manifest.json` - **Premiere Pro**: `uxp/pr/manifest.json` - **InDesign**: `uxp/id/manifest.json` 5. Click **Load** 6. In your Adobe application, open the plugin panel and click **Connect**

Enable Developer Mode in Photoshop

**For Photoshop:** 1. Launch Photoshop (2025/26.0 or greater) 2. Go to **Settings > Plugins** and check **"Enable Developer Mode"** 3. Restart Photoshop

Enable Developer Mode in Premeire Pro

**For Premeire Pro:** 1. Launch Premeire Pro (2025/26.0 or greater) 2. Go to **Settings > Plugins** and check **"Enable Developer Mode"** 3. Restart Premeire Pro

AfterEffects, Illustrator (CEP)

Mac

1. Make sure the following directory exists (if it doesn't then create the directories) `/Users/USERNAME/Library/Application Support/Adobe/CEP/extensions`

2. Navigate to the extensions directory and create a symlink that points to the AfterEffect / Illustrator plugin in the CEP directory.

cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ae com.mikechambers.ae

or

cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ai com.mikechambers.ai

Windows

1. Make sure the following directory exists (if it doesn't then create the directories) `C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions`

2. Open Command Prompt as Administrator (or enable Developer Mode in Windows Settings)

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.

README.md · README · 341 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # adb-mcp
  2. adb-mcp is a proof of concept project to enabled AI control of Adobe tools (Adobe Photoshop and Adobe Premiere) by providing an interface to LLMs via the MCP protocol.
  3. The project is not endorsed by nor supported by Adobe.
  4. It has been tested with Claude desktop (Mac and Windows) from Anthropic, as well as the OpenAI Agent SDK, and allows AI clients to control Adobe Photoshop and Adobe Premiere. Theoretically, it should work with any AI App / LLM that supports the MCP protocol, and is built in a way to support multiple Adobe applications.
  5. Example use cases include:
  6. - Giving Claude step by step instruction on what to do in Photoshop, providing a conversational based interface (particularly useful if you are new to Photoshop).
  7. - Giving Claude a task (create an instagram post that looks like a Polariod image, create a double exposure) and letting it create it from start to finish to use as a template.
  8. - Asking Claude to generate custom Photoshop tutorials for you, by creating an example file, then step by step instructions on how to recreate.
  9. - As a Photoshop utility tool (have Claude rename all of your layers into a consistent format)
  10. - Have Claude create new Premiere projects pre-populations with clips, transitions, effects and Audio
  11. [View Video Examples](https://www.youtube.com/playlist?list=PLrZcuHfRluqt5JQiKzMWefUb0Xumb7MkI)
  12. The Premiere agent is a bit more limited in functionality compared to the Photoshop agent, due to current limitations of the Premiere plugin API.
  13. ## How it works
  14. The proof of concept works by providing:
  15. - A MCP Server that provides an interface to functionality within Adobe Photoshop to the AI / LLM
  16. - A Node based command proxy server that sits between the MCP server and Adobe app plugins
  17. - An Adobe app (Photoshop and Premiere) plugin that listens for commands, and drives the programs
  18. **AI** <-> **MCP Server** <-> **Command Proxy Server** <-> **Photoshop / Premiere UXP Plugin** <-> **Photoshop / Premiere**
  19. The proxy server is required because the public facing API for UXP Based JavaScript plugin does not allow it to listen on a socket connection (as a server) for the MCP Server to connect to (it can only connect to a socket as a client).
  20. ## Requirements
  21. In order to run this, the following is required:
  22. - AI LLM with support for MCP Protocol (tested with Claude desktop on Mac & Windows, and OpenAI Agent SDK)
  23. - Python 3, which is used to run the MCP server provided with this project
  24. - NodeJS, used to provide a proxy between the MCP server and Photoshop
  25. - Adobe UXP Developer tool (available via Creative Cloud) used to install and debug the Photoshop / Premiere plugin used to connect to the proxy
  26. - Adobe Photoshop (26.0 or greater) with the MCP Plugin installed or Adobe Premiere Beta (25.3 Build 46 or greater)
  27. ## Installation
  28. This guide assumes you're using Claude Desktop. Other MCP-compatible AI applications should work similarly.
  29. ### Download Source Code
  30. Clone or download the source code from the [main project page](https://github.com/mikechambers/adb-mcp).
  31. ### Install Claude Desktop
  32. 1. Download and install [Claude Desktop](https://claude.ai/download)
  33. 2. Launch Claude Desktop to verify it works
  34. Note, you can use any client / code that supports MCP, just follow its instructions for how to configure.
  35. ### Install MCP for Development
  36. Navigate to the project directory and run:
  37. #### Photoshop
  38. ```bash
  39. uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py
  40. ```
  41. #### Premiere Pro
  42. ```bash
  43. uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py
  44. ```
  45. #### InDesign
  46. ```bash
  47. uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow id-mcp.py
  48. ```
  49. #### AfterEffects
  50. ```bash
  51. uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ae-mcp.py
  52. ```
  53. #### Illustrator
  54. ```bash
  55. uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ai-mcp.py
  56. ```
  57. Restart Claude Desktop after installation.
  58. ### Set Up Proxy Server
  59. #### Using Prebuilt Executables (Recommended)
  60. 1. Download the appropriate executable for your platform from the latest [release](https://github.com/mikechambers/adb-mcp/releases) (files named like `adb-proxy-socket-macos-x64.zip` (Intel), `adb-proxy-socket-macos-arm64.zip` (Silicon), or `adb-proxy-socket-win-x64.exe.zip`).
  61. 2. Unzip the executable.
  62. 3. Double click or run from the console / terminal
  63. #### Running from Source
  64. 1. Navigate to the adb-proxy-socket directory
  65. 2. Run `node proxy.js`
  66. You should see a message like:
  67. `Photoshop MCP Command proxy server running on ws://localhost:3001`
  68. **Keep this running** — the proxy server must stay active for Claude to communicate with Adobe plugins.
  69. ### Install Plugins
  70. #### Photoshop, Premiere Pro, InDesign (UXP)
  71. 1. Launch **UXP Developer Tools** from Creative Cloud
  72. 2. Enable developer mode when prompted
  73. 3. Select **File > Add Plugin**
  74. 4. Navigate to the appropriate directory and select **manifest.json**:
  75. - **Photoshop**: `uxp/ps/manifest.json`
  76. - **Premiere Pro**: `uxp/pr/manifest.json`
  77. - **InDesign**: `uxp/id/manifest.json`
  78. 5. Click **Load**
  79. 6. In your Adobe application, open the plugin panel and click **Connect**
  80. ##### Enable Developer Mode in Photoshop
  81. **For Photoshop:**
  82. 1. Launch Photoshop (2025/26.0 or greater)
  83. 2. Go to **Settings > Plugins** and check **"Enable Developer Mode"**
  84. 3. Restart Photoshop
  85. ##### Enable Developer Mode in Premeire Pro
  86. **For Premeire Pro:**
  87. 1. Launch Premeire Pro (2025/26.0 or greater)
  88. 2. Go to **Settings > Plugins** and check **"Enable Developer Mode"**
  89. 3. Restart Premeire Pro
  90. #### AfterEffects, Illustrator (CEP)
  91. ##### Mac
  92. 1. Make sure the following directory exists (if it doesn't then create the directories)
  93. `/Users/USERNAME/Library/Application Support/Adobe/CEP/extensions`
  94. 2. Navigate to the extensions directory and create a symlink that points to the AfterEffect / Illustrator plugin in the CEP directory.
  95. ```bash
  96. cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
  97. ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ae com.mikechambers.ae
  98. ```
  99. or
  100. ```bash
  101. cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
  102. ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ai com.mikechambers.ai
  103. ```
  104. ##### Windows
  105. 1. Make sure the following directory exists (if it doesn't then create the directories)
  106. `C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions`
  107. 2. Open Command Prompt as Administrator (or enable Developer Mode in Windows Settings)
  108. 3. Create a junction or symbolic link that points to the AfterEffect / Illustrator plugin in the CEP directory:
  109. ```cmd
  110. mklink /D "C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions\com.mikechambers.ae" "C:\Users\USERNAME\src\adb-mcp\cep\com.mikechambers.ae"
  111. ```
  112. or
  113. ```cmd
  114. mklink /D "C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions\com.mikechambers.ai" "C:\Users\USERNAME\src\adb-mcp\cep\com.mikechambers.ai"
  115. ```
  116. Note if you don't want to symlink, you can copy com.mikechambers.ae / com.mikechambers.ao into the CEP directory.
  117. ### Using Claude with Adobe Apps
  118. Launch the following:
  119. 1. Claude Desktop
  120. 2. adb-proxy-socket node server
  121. 3. Launch Photoshop, Premiere, InDesign, AfterEffects, Illustrator
  122. _TIP: Create a project for Photoshop / Premiere Pro in Claude and pre-load any app specific instructions in its Project knowledge._
  123. #### Photoshop
  124. 1. Launch UXP Developer Tool and click the Load button for _Photoshop MCP Agent_
  125. 2. In Photoshop, if the MCP Agent panel is not open, open _Plugins > Photoshop MCP Agent > Photoshop MCP Agent_
  126. 3. Click connect in the agent panel in Photoshop
  127. Now you can switch over the Claude desktop. Before you start a session, you should load the instructions resource which will provide guidance and info the Claude by clicking the socket icon (Attach from MCP) and then _Choose an Integration_ > _Adobe Photoshop_ > _config://get_instructions_.
  128. #### Premiere
  129. 1. Launch UXP Developer Tool and click the Load button for _Premiere MCP Agent_
  130. 2. In Premiere, if the MCP Agent panel is not open, open _Window > UXP Plugins > Premiere MCP Agent > Premiere MCP Agent_
  131. 3. Click connect in the agent panel in Photoshop
  132. #### InDesign
  133. 1. Launch UXP Developer Tool and click the Load button for InDesitn MCP Agent_
  134. 2. In InDesign, if the MCP Agent panel is not open, open _Plugins > InDesign MCP Agent > InDesign MCP Agent_
  135. 3. Click connect in the agent panel in Photoshop
  136. #### AfterEffects
  137. 1. _Window > Extensions > Illustrator MCP Agent_
  138. #### Illustrator
  139. 1. Open a file (the plugin won't launch unless a file is open)
  140. 2. _Window > Extensions > Illustrator MCP Agent_
  141. Note, you must reload the plugin via the UXP Developer app every time you restart Photoshop, Premiere and InDesign.
  142. ### Setting up session
  143. In the chat input field, click the "+" button. From there click "Add from Adobe Photoshop / Premiere" then select *config://get_instructions*. This will load the instructions into the prompt. Submit that to Claude and once it processes it, you are ready to go.
  144. <img src="images/claud-attach-mcp.png" width="300">
  145. This will help reduce errors when the AI is using the app.
  146. ### Prompting
  147. At anytime, you can ask the following:
  148. ```
  149. Can you list what apis / functions are available for working with Photoshop / Premiere?
  150. ```
  151. and it will list out all of the functionality available.
  152. When prompting, you do not need to reference the APIs, just use natural language to give instructions.
  153. For example:
  154. ```
  155. Create a new Photoshop file with a blue background, that is 1080 width by 720 height at 300 dpi
  156. ```
  157. ```
  158. Create a new Photoshop file for an instagram post
  159. ```
  160. ```
  161. Create a double exposure image in Photoshop of a woman and a forest
  162. ```
  163. ```
  164. Generate an image of a forest, and then add a clipping mask to only show the center in a circle
  165. ```
  166. ```
  167. Make something cool with photoshop
  168. ```
  169. ```
  170. Add cross fade transitions between all of the clips on the timeline in Premiere
  171. ```
  172. ### Tips
  173. #### General
  174. * When asking AI to view the content in Photoshop / Premiere Pro, you can see the image returned in the Tool Call item in the chat. It will appear once the entire response has been added to the chat.
  175. * When prompting, ask the AI to think about and check its work.
  176. * The more you guide it (i.e. "consider using clipping masks") the better the results
  177. * The more advanced the model, or the more resources given to the model the better and more creative the AI is.
  178. * As a general rule, don't make changes in the Adobe Apps while the AI is doing work. If you do make changes, make sure to tell the AI about it.
  179. * The AI will learn from its mistakes, but will lose its memory once you start a new chat. You can guide it to do things in a different way, and then ask it to start over and it should follow the new approach.
  180. The AI currently has access to a subset of Photoshop / Premiere / InDesign / Illustrator / AfterEffects functionality. In general, the approach has been to provide lower level tools to give the AI the basics to do more complex stuff.
  181. Note, for AfterEffects and Illustrator, there is a low level Extend Script API that will let the LLM run any arbitrary extend script (which allows it to do just about anything).
  182. The Photoshop plugin has more functionality that Premiere.
  183. By default, the AI cannot access files directly, although if you install the [Claude File System MCP server](https://www.claudemcp.com/servers/filesystem) it can access, and load files into Photoshop / Premiere (open files and embed images).
  184. #### Photoshop
  185. * You can ask the AI to look at the content of the Photoshop file and it should be able to then see the output.
  186. * The AI currently has issue sizing and positioning text correctly, so giving it guidelines on font sizes to use will help, as well as telling it to align the text relative to the canvas.
  187. * The AI has access to all of the Postscript fonts on the system. If you want to specify a font, you must use its Postscript name (you may be able to ask the AI for it).
  188. * You can ask the AI for suggestions. It comes up with really useful ideas / feedback sometimes.
  189. #### Premiere
  190. * Currently the plugin assumes you are just working with a single sequence.
  191. * Pair the Premiere Pro MCP with the [media-utils-mcp](https://github.com/mikechambers/media-utils-mcp) to expand functionality.
  192. ### Troubleshooting
  193. #### MCP won't run in Claude
  194. If you get an error when running Claude that the MCP is not working, you may need to edit your Claude config file and put an absolute path for the UV command. More info [here](https://github.com/mikechambers/adb-mcp/issues/5#issuecomment-2829817624).
  195. #### All fonts not available
  196. The MCP server will return a list of available fonts, but depending on the number of fonts installed on your system, may omit some to work around the amount of data that can be send to the AI. By default it will list the first 1000 fonts sorted in alphabetical order.
  197. You can tell the AI to use a specific font, using its postscript name.
  198. #### Plugin won't install or connect
  199. * Make sure the app is running before you try to load the plugin.
  200. * In the UXP developer tool click the debug button next to load, and see if there are any errors.
  201. * Make sure the node / proxy server is running. If you plugin connects you should see output similar to:
  202. ```
  203. adb-mcp Command proxy server running on ws://localhost:3001
  204. User connected: Ud6L4CjMWGAeofYAAAAB
  205. Client Ud6L4CjMWGAeofYAAAAB registered for application: photoshop
  206. ```
  207. * When you press the connect button, if it still says "Connect" it means there was either an error, or it can't connect to the proxy server. You can view the error in the UXP Developer App, by opening the Developer Workspace and click "Debug".
  208. #### Errors within AI client
  209. * If something fails on the AI side, it will usually tell you the issue. If you click the command / code box, you can see the error.
  210. * The first thing to check if there is an issue is to make sure the plugin in Photoshop / Premiere is connected, and that the node proxy server is running.
  211. * If response times get really slow, check if the AI servers are under load, and that you do not have too much text in the current conversation (restarting a new chat can sometimes help speed up, but you will lose the context).
  212. If you continue to have issues post an [issue](https://github.com/mikechambers/adb-mcp/issuesrd.gg/fgxw9t37D7). Include as much information as you can (OS, App, App version, and debug info or errors).
  213. ## Development
  214. Adding new functionality is relatively easy, and requires:
  215. 1. Adding the API and parameters in the *mcp/ps-mcp.py* / *mcp/pr-mcp.py* file (which is used by the AI)
  216. 2. Implementing the API in the *uxp/ps/commands/index.js* / *uxp/pr/commands/index.js* file.
  217. This [thread](https://github.com/mikechambers/adb-mcp/issues/10#issuecomment-3191698528) has some info on how to add functionality.
  218. ## Questions, Feature Requests, Feedback
  219. If you have any questions, feature requests, need help, or just want to chat, join the [discord](https://discord.gg/fgxw9t37D7).
  220. You can also log bugs and feature requests on the [issues page](https://github.com/mikechambers/adb-mcp/issues).
  221. ## License
  222. Project released under a [MIT License](LICENSE.md).
  223. [![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](LICENSE.md)

Ratings and comments

Sign in to rate this skill.

Sign in

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