What is the Illustrator MCP server?
Illustrator MCP is a bridge that connects an AI coding agent to a running copy of Adobe Illustrator on macOS or Windows through ExtendScript. It exposes 29 tools for documents, layers, shapes, text, color, alignment and vectorization, so the agent edits real artboards, layers and paths rather than producing a flat generated image.
Illustrator MCP is a bridge, not an official Adobe product, that lets an AI coding agent drive a running copy of Adobe Illustrator on macOS or Windows. It reaches Illustrator through ExtendScript, called over AppleScript on macOS or COM on Windows, so the agent manipulates a real open document instead of generating a static image.
Because it edits the real document, layers stay editable, text stays live text, and artboards keep their structure, so a design can be refined by hand after the agent's pass.
What it changes in your workflow
- The agent creates rectangles, ellipses, lines, text frames and placed images directly on the artboard instead of describing a flat composite.
- illustrator_vectorize_image turns a raster image into editable paths, using VTracer if installed or Illustrator's own Image Trace as a fallback.
- Layer tools create, switch and list layers, and selection tools target objects by name, so a multi-step edit can act on the right object every time.
- illustrator_run_script executes custom ExtendScript for edits that the 28 structured tools do not cover.
Setup at a glance
| Illustrator MCP server | |
|---|---|
| OS | macOS or Windows |
| App | Adobe Illustrator installed and running |
| Transport | stdio by default; Streamable HTTP with an MCP_HTTP_TOKEN option |
| First run on macOS | Grant Automation permission for the client app to control Illustrator |
Who it is for
Best for
- Teams that want an agent to build or edit a real Illustrator document, artboard by artboard, rather than generate a flat image.
- Turning a raster logo or icon into editable vector paths through the vectorization tool.
- Illustrator users already comfortable with ExtendScript who want an agent-callable wrapper around it.
Not for
- When the target application is Photoshop rather than Illustrator, the Photoshop MCP server drives Photoshop with its own tool set instead.
- If the canvas is a self-hosted Penpot file rather than a desktop Illustrator document, the Penpot MCP server reads shapes and tokens and creates frames there instead.
- Choose a Figma-first route when the design should be read and created directly in Figma, Figma Unified MCP reads, creates and exports code from Figma designs.
- Go with a Figma Desktop workflow when designs should be built there from plain prompts, Conduit Design MCP creates, edits and exports Figma designs through its own plugin.
Use it with UiChemy
Illustrator MCP edits vector artwork in a desktop app. UiChemy's Composer builds the WordPress page itself inside Elementor or Gutenberg, so export finished artwork here and bring it into a Composer page as an image asset.
Connect Illustrator MCP Server for AI Coding Agents to your AI client
git clone https://github.com/gherardo200-glitch/illustrator-mcp.gitClone and install
Run
git clone https://github.com/gherardo200-glitch/illustrator-mcp.git, thencd illustrator-mcpandnpm install.Add the server to your client
Use the config above with the real absolute path to dist/index.js; Claude Desktop, Claude Code and Cursor each take the same node command in their own config location.
Grant permission on macOS
On first run, enable Automation access for the client app to control Adobe Illustrator in System Settings.
Open Illustrator
Make sure Illustrator is installed and ideally already running before the agent calls a tool.
Check the connection
Call illustrator_get_status and confirm it reports Illustrator as available.
Client configuration
{
"mcpServers": {
"illustrator": {
"command": "node",
"args": ["/absolute/path/to/illustrator-mcp/dist/index.js"]
}
}
}Endpoints and ports
node dist/index.jsDefault local transport.node dist/index.js --httpStreamable HTTP transport with an optional MCP_HTTP_TOKEN header.What you can do with it
- Live document editingEvery tool acts on the real open Illustrator document, so layers, text and paths stay editable after the agent's pass.
- Full artboard toolkitShape, text and image tools cover rectangles, ellipses, lines, text frames and placed images on the artboard.
- Raster to vectorillustrator_vectorize_image converts a raster image into editable paths through VTracer or Illustrator's own Image Trace.
- Layer and selection controlLayer tools create and switch layers, while selection tools target, group or align objects by name or position.
- ExtendScript escape hatchillustrator_run_script runs custom ExtendScript for edits the 28 structured tools do not cover.
- Cross-platform bridgeThe same tool set reaches Illustrator through AppleScript on macOS or COM on Windows.
- Two transport modesstdio runs locally by default, and an HTTP mode supports a remote client with optional bearer-token style authentication.
Tools it exposes
illustrator_get_status
Checks whether Illustrator is available and reachable.
illustrator_create_document
Creates a new Illustrator document.
illustrator_open_document
Opens an existing Illustrator document.
illustrator_export_document
Exports the active document to PNG or PDF.
illustrator_list_layers
Lists the layer hierarchy of the active document.
illustrator_create_rectangle
Draws a rectangle shape on the artboard.
illustrator_create_text
Creates an editable text frame.
illustrator_place_image
Embeds a raster image into the document.
illustrator_transform_selection
Scales, rotates or translates the current selection.
illustrator_set_color
Sets the fill or stroke color on the current selection.
illustrator_align_selection
Aligns or distributes the selection relative to the artboard or itself.
illustrator_vectorize_image
Converts a raster image to editable vector paths using VTracer or Illustrator's Image Trace.
illustrator_select_by_name
Selects objects in the document by a given identifier.
illustrator_run_script
Runs a custom ExtendScript for edits outside the structured tools.
Frequently asked questions
What is the Illustrator MCP server?
It is a bridge that connects an AI coding agent to a running copy of Adobe Illustrator through ExtendScript. It exposes 29 tools for documents, layers, shapes, text, color and vectorization, acting on the real open document.
How do I set up the Illustrator MCP server?
Clone the repository, run npm install, then point your MCP client's configuration at the absolute path to dist/index.js with node as the command. Claude Desktop, Claude Code and Cursor all take the same entry.
Does it work on both macOS and Windows?
Yes. On macOS it reaches Illustrator through AppleScript calling ExtendScript, and on Windows it uses COM to call ExtendScript the same way, so the same 29 tools work on either operating system.
Do I need Illustrator open already?
The tools act on a running Illustrator session, so having the application installed and ideally already running, with Automation permission granted on macOS, lets the first tool call connect without extra setup.
Can it turn a raster image into editable vectors?
Yes. The illustrator_vectorize_image tool converts a raster image into editable vector paths, using the separately installed VTracer engine by default or falling back to Illustrator's own built-in Image Trace feature.
Can it do things the 29 tools do not cover?
The illustrator_run_script tool runs a custom ExtendScript for cases outside the structured tool set, giving access to the same scripting layer the other 28 tools are built on top of.
Which AI coding agents and editors does it work with?
The README gives setup for Claude Desktop, Claude Code and Cursor, plus an HTTP mode for ChatGPT Desktop through a secure MCP tunnel. Any other MCP-compatible client that can run a node command should connect the same way.


