illustrator-mcp
Drive a real, open Adobe Illustrator document from an AI/MCP client by creating and editing vector artwork, inspecting state, exporting, vectorizing images, or running custom ExtendScript.
Check Illustrator status/version and list open documents.
Create/open/save/close/export documents, including PNG/JPG/SVG/PDF and specific artboards.
Inspect document info, artboards, layers, and current selection.
Create rectangles, ellipses, lines, text, and place images.
Vectorize raster images into editable paths with VTracer or Image Trace.
Transform, recolor, reorder, align, delete, group/ungroup selected artwork.
Create and activate layers; select all, deselect all, or select by name.
Run arbitrary ExtendScript to access anything else in Illustrator's scripting API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@illustrator-mcp create an A4 poster, add a red rounded rectangle and a headline"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Illustrator MCP
Give Claude, ChatGPT, or Cursor the keyboard and mouse for a real, already-open Adobe Illustrator document.
This is an MCP (Model Context Protocol) server that bridges an AI assistant and Adobe Illustrator itself, not a generator that hands you a picture and calls it done. Ask your assistant to "create an A4 poster, add a red rounded rectangle and a headline" and it drives your actual, running copy of Illustrator through Illustrator's own scripting engine (ExtendScript). What comes out is the same file you can keep editing by hand afterward, layers and all.
Not just image generation. Plenty of tools, OpenAI's own image models included, turn a prompt into a vector-looking picture. That picture has no relationship to anything you're working on: no layers, no editable text, no artboards, nothing left to select or nudge. Illustrator MCP is a different kind of thing. It opens, reads, and edits a real Illustrator document while it's sitting open on your screen. Vectorizing a raster image is one of its 29 tools, not the whole project.
Works on macOS and Windows. Illustrator must be installed on the same machine as the server.
What can it do?
Say things like:
"Create a 1080×1080 RGB document and add the title 'SALE' in bold orange."
"Draw three circles in a row, then align them to the center of the artboard."
"Open
campaign.ai, find the layer called 'Pricing', and change the numbers.""Place
~/logo.pngin the top-left corner and scale it to 200px wide.""Select everything named 'badge' and make it blue."
"Export the current artboard as a 2x transparent PNG to my Desktop."
"Read all the text objects in this document and list their contents."
Every one of those runs against the Illustrator window that's actually open in
front of you, not a sandbox or a throwaway render. The server ships 29 tools
covering documents, artboards, layers, shapes, text, images, transforms,
alignment, color, selection, and export, plus a run_script escape hatch that
can execute any Illustrator ExtendScript, so an agent is never boxed in. Image
vectorization (illustrator_vectorize_image, Image Trace under the hood,
expanded into real editable paths) is one of those 29 tools: handy when a client
hands you a raster logo and you need clean paths, but a feature, not the product.
Related MCP server: Illustrator MCP Vectorizer
How it works
┌─────────────┐ MCP (stdio) ┌──────────────────┐ ExtendScript ┌──────────────┐
│ Claude / │ ◄────────────► │ illustrator-mcp │ ◄─────────────► │ Adobe │
│ ChatGPT / │ tool calls │ server (Node/TS) │ osascript / │ Illustrator │
│ Cursor ... │ │ │ PowerShell COM │ │
└─────────────┘ └──────────────────┘ └──────────────┘The AI client sends tool calls over MCP.
The server turns each call into a small ExtendScript program.
It runs that script inside Illustrator via AppleScript
do javascript(macOS) or COMDoJavaScript(Windows).Results come back as structured JSON.
Because the final layer is ExtendScript, anything the Illustrator scripting API supports is reachable.
Requirements
Adobe Illustrator installed (any reasonably recent version) and, ideally, running.
Node.js 18+.
macOS or Windows.
An MCP-capable client (Claude Desktop, Claude Code, Cursor, ChatGPT desktop with MCP, …).
Install
git clone https://github.com/gherardo200-glitch/illustrator-mcp.git
cd illustrator-mcp
npm install # also builds via the "prepare" script
npm run build # (only needed if you skip install-time build)This produces dist/index.js, the server entry point. Note its absolute path: you'll need it for the client config, e.g.:
/absolute/path/to/illustrator-mcp/dist/index.jsConnect it to your AI client
Claude Desktop
Edit the config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"illustrator": {
"command": "node",
"args": ["/absolute/path/to/illustrator-mcp/dist/index.js"]
}
}
}Restart Claude Desktop. You should see the Illustrator tools appear.
Claude Code
claude mcp add illustrator -- node /absolute/path/to/illustrator-mcp/dist/index.js…or commit a .mcp.json to your project (see examples/mcp.json).
Cursor
Add to ~/.cursor/mcp.json (or the project's .cursor/mcp.json):
{
"mcpServers": {
"illustrator": {
"command": "node",
"args": ["/absolute/path/to/illustrator-mcp/dist/index.js"]
}
}
}ChatGPT (desktop or web)
ChatGPT reaches MCP servers through connectors (Developer Mode, Plus/Pro or
Business/Enterprise/Edu). It does not launch a local stdio server directly.
The clean way to connect this local server is OpenAI's Secure MCP Tunnel
(tunnel-client): outbound-only, no public port. This repo ships an HTTP
transport for exactly this: run node dist/index.js --http (listens on
http://127.0.0.1:3000/mcp), though the tunnel can also drive the stdio server
directly.
Step-by-step: docs/ATTIVAZIONE.md (Italian) ·
technical notes: docs/CHATGPT.md.
Any other MCP client
Two transports, one codebase:
stdio (default):
node dist/index.jsStreamable HTTP:
node dist/index.js --http(PORT/HOSToverride the default127.0.0.1:3000, endpoint/mcp,/healthzfor liveness). Rejects requests with an unrecognizedHost/Originheader (DNS-rebinding protection); setMCP_HTTP_TOKENto also require anX-MCP-Tokenheader on every request. See Safety notes.
First run & permissions (macOS)
The first time the server talks to Illustrator, macOS asks permission to let your terminal/app control Adobe Illustrator (Apple Events automation). Click OK.
If you denied it or nothing happens, enable it manually: System Settings → Privacy & Security → Automation → (your app: Terminal / Claude / Cursor) → enable Adobe Illustrator.
Verify the connection by asking your assistant to run illustrator_get_status
(it does not launch Illustrator, so it's a safe first call).
Tools
Area | Tools |
App |
|
Documents |
|
Inspect |
|
Create |
|
Vectorize |
|
Edit |
|
Layers |
|
Selection |
|
Power |
|
Coordinates: all positions and sizes are in points (= pixels at 72 dpi),
measured from the top-left of the active artboard, with Y increasing downward,
the intuitive convention for design tools. (The run_script helpers convert
from Illustrator's native Y-up global system.)
Colors: hex (#FF7F00), a common name (red, blue, green, …), or none.
Colors are automatically converted to RGB or CMYK to match the document.
Image vectorization (two engines)
illustrator_vectorize_image supports two engines:
vtracer(default): the open-source VTracer CLI produces a clean SVG that is opened in Illustrator as editable paths. Free, local, and usually cleaner than Image Trace. Requires thevtracerbinary.image_trace: Illustrator's built-in Image Trace. No install, kept as a fallback.
Install VTracer (once), pick one:
Prebuilt binary (no Rust needed): download your platform's archive from the releases page, extract the
vtracerbinary, and put it on yourPATH(or pointVTRACER_PATHat it). On macOS you may needxattr -d com.apple.quarantine /path/to/vtracer.From source:
cargo install vtracer(needs the Rust toolchain).
The server finds VTracer via PATH or the VTRACER_PATH environment variable. If
it's missing, the tool returns clear install instructions and you can fall back to
engine: "image_trace".
Both engines are best on logos, flat art, line art, and few-color graphics; photorealistic images produce many paths and usually need manual cleanup.
The run_script escape hatch
illustrator_run_script runs arbitrary ExtendScript. The code runs inside a
function. return a JSON-serializable value to get it back. Prelude helpers are
available: __doc(), __color(hex), __setPos(item, x, y), __itemInfo(item),
__abRect(), __activeAB(doc), __style(item, opts).
// e.g. count every text frame and return their contents
var d = __doc();
var out = [];
for (var i = 0; i < d.textFrames.length; i++) out.push(d.textFrames[i].contents);
return { count: out.length, texts: out };Safety notes
Tools carry MCP annotations (
readOnlyHint,destructiveHint, …) so clients can prompt before destructive actions (delete, close,run_script).run_scriptis powerful: it can modify/delete artwork and touch the file system (read, write, or delete any file your OS user can access — ExtendScript'sFile/FolderAPI is not sandboxed). Prefer the specialized tools when they fit, and review scripts before approving them, especially from an AI client you don't fully trust.In
--httpmode the server opens a real network port (default127.0.0.1:3000/mcp). Anyone who can reach that port can call any tool, includingrun_script. The server now rejects requests whoseHostorOriginheader isn't127.0.0.1/localhost(plus whateverHOSTyou set) on that port, which is the standard defense against DNS-rebinding attacks (a page on an attacker-controlled domain that briefly resolves to127.0.0.1, hoping to reach your local server through the browser): the browser still sends the attacker's real hostname inHost/Origin, so it never matches the allowlist and gets a403. There is still no authentication by default, so anything else that can reach the port with a correctHostheader (another local process, or a device on your LAN/internet if you port-forward it) can still call every tool. SetMCP_HTTP_TOKENto a random secret to require a matchingX-MCP-Tokenheader on every request (plain requests get401); leave it unset and behaviour is unchanged. KeepHOSTat its127.0.0.1default, don't port-forward or expose3000on your LAN/internet, only run--httpmode while you're actively using it, and only use OpenAI's outbound-only Secure MCP Tunnel to reach it (seedocs/CHATGPT.md; note the tunnel client doesn't document a way to attach a custom header today, soMCP_HTTP_TOKENand the ChatGPT tunnel may not combine unless you add a small local proxy that injects it). stdio mode (the default, used by Claude/ Cursor) does not open a network port and is not affected.
Troubleshooting
Symptom | Fix |
"Not authorized to control Illustrator" | Grant Automation permission (see above), then retry. |
"Could not reach Adobe Illustrator" | Make sure Illustrator is installed and running. |
"No document is open" | Create one with |
Calls time out | Illustrator may be showing a modal dialog; bring it to the front and dismiss it. |
Tools don't appear in the client | Check the absolute path in the config and restart the client. |
Roadmap
Chat panel inside Illustrator (UXP/CEP): a dockable panel with a chat box so you can talk to the assistant without leaving Illustrator. See
docs/IN_APP_CHAT.mdfor the design, integration plan, and a cost breakdown (in Italian).More workflow tools (pathfinder, effects, symbols, swatches, batch export).
✅ HTTP (Streamable) transport for ChatGPT / remote MCP clients (
--http).
Contributions welcome: see CONTRIBUTING.md.
🇮🇹 Guida rapida (Italiano)
Questo è un connettore che permette a Claude, ChatGPT o Cursor di comandare Adobe Illustrator parlandogli in linguaggio naturale ("crea un poster A4, aggiungi un rettangolo rosso e un titolo"). Non è un generatore di immagini vettoriali: lavora dentro un documento Illustrator vero, già aperto sul tuo schermo, che resta modificabile a mano dopo. La vettorizzazione di un'immagine raster è solo uno dei 29 tool disponibili.
Per usarlo:
Installa Node.js 18+ e assicurati di avere Illustrator.
Nel terminale:
git clone https://github.com/gherardo200-glitch/illustrator-mcp.git cd illustrator-mcp npm installCopia il percorso assoluto di
dist/index.js.Incollalo nella configurazione del tuo client (vedi Claude Desktop sopra).
Riavvia il client e chiedi: "usa illustrator_get_status" per verificare che funzioni. Su macOS, al primo utilizzo concedi il permesso di automazione.
Da lì in poi puoi chiedere di creare documenti, forme, testi, allineare, colorare,
esportare PNG/PDF e altro. Per operazioni avanzate c'è illustrator_run_script,
che esegue qualsiasi script di Illustrator.
License
MIT © 2026
Available Tools
29 toolsillustrator_align_selectionAlign Selection to ArtboardAIdempotent
Align selected objects relative to the active artboard.
Args:
horizontal ('left'|'center'|'right'), optional
vertical ('top'|'middle'|'bottom'), optional.
Inputs: vertical, horizontal.
illustrator_arrange_selectionArrange Selection (Z-order)A
Change the stacking order of selected objects.
Args:
order ('front'|'back'|'forward'|'backward').
Inputs: order (required).
illustrator_close_documentClose DocumentADestructive
Close the active document.
Args:
save (boolean): save changes before closing (default false).
Inputs: save.
illustrator_create_documentCreate DocumentA
Create a new Illustrator document. Launches Illustrator if it is not already running.
Args:
width, height (number): canvas size in the chosen unit
unit ('pt'|'px'|'mm'|'cm'|'in'): default 'px'
color_mode ('RGB'|'CMYK'): 'RGB' for screen, 'CMYK' for print (default 'RGB')
artboards (number): number of artboards (default 1)
Returns the new document's name, size in points, and color mode.
Inputs: width (required), height (required), unit, artboards, +1 more.
illustrator_create_ellipseCreate EllipseA
Draw an ellipse/circle. The x,y,width,height describe its bounding box (top-left origin, Y down). Args: x, y, width, height, optional fill, stroke, strokeWidth, name.
Inputs: x (required), y (required), width (required), height (required), +4 more.
illustrator_create_layerCreate LayerA
Create a new layer in the active document and make it active. New artwork is created on the active layer.
Args:
name (string).
Inputs: name (required).
illustrator_create_lineCreate LineA
Draw a straight line between two points (x1,y1) and (x2,y2), top-left origin, Y down. Args: x1, y1, x2, y2, optional stroke (default black), strokeWidth (default 1), name.
Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +3 more.
illustrator_create_rectangleCreate RectangleA
Draw a rectangle (optionally rounded) on the active document.
Coordinates/sizes are in points, from the top-left of the active artboard, Y down. Args: x, y (top-left), width, height, optional corner_radius, fill, stroke, strokeWidth, name.
Inputs: x (required), y (required), width (required), height (required), +5 more.
illustrator_create_textCreate TextB
Add a text object.
Args:
text (string): the text content
x, y (number): top-left position (Y down)
font_size (number): size in points (default 24)
font (string, optional): PostScript font name, e.g. 'ArialMT', 'Helvetica-Bold'
fill (color, optional): text color
name (string, optional)
Inputs: x (required), y (required), text (required), fill, +3 more.
illustrator_delete_selectionDelete SelectionADestructive
Delete all currently selected objects.
Inputs: no named parameters.
illustrator_deselect_allDeselect AllAIdempotent
Clear the current selection.
Inputs: no named parameters.
illustrator_export_documentExport DocumentAIdempotent
Export the active document to an image or PDF.
Args:
path (string): absolute destination path (include the extension)
format ('png'|'jpg'|'svg'|'pdf'): default 'png'
scale (number): raster scale in percent, e.g. 200 = 2x (default 100)
transparent (boolean): PNG transparency (default true)
artboard_index (number, optional): export a specific artboard (0-based)
PNG/JPG are clipped to the active artboard.
Inputs: path (required), scale, format, transparent, +1 more.
illustrator_get_document_infoGet Document InfoARead-onlyIdempotent
Get an overview of the active document: name, color mode, size, artboards, layers, item and selection counts. Use this to understand the current state before making changes.
Inputs: no named parameters.
illustrator_get_selectionGet SelectionARead-onlyIdempotent
List the currently selected objects with their type, name, position and size (artboard-relative, Y down).
Inputs: no named parameters.
illustrator_get_statusGet Illustrator StatusARead-onlyIdempotent
Check whether Adobe Illustrator is running and, if so, its version and how many documents are open. This does NOT launch Illustrator, so it is a safe first call to verify the connection.
Inputs: no named parameters.
illustrator_group_selectionGroup / Ungroup SelectionA
Group the selected objects into one group, or ungroup selected groups.
Args:
action ('group'|'ungroup'), default 'group'.
Inputs: action.
illustrator_list_artboardsList ArtboardsARead-onlyIdempotent
List all artboards in the active document with their index, name and size in points.
Inputs: no named parameters.
illustrator_list_documentsList Open DocumentsARead-onlyIdempotent
List all documents currently open in Illustrator, marking the active one.
Inputs: no named parameters.
illustrator_list_layersList LayersARead-onlyIdempotent
List all layers in the active document with visibility, lock state and item counts.
Inputs: no named parameters.
illustrator_open_documentOpen DocumentA
Open an existing file in Illustrator (.ai, .pdf, .eps, .svg, and other supported formats).
Args:
path (string): absolute path to the file to open.
Inputs: path (required).
illustrator_place_imagePlace ImageA
Place a raster/vector image file into the active document (linked, or embedded).
Args:
path (string): absolute path to the image
x, y (number): top-left position (default 0,0)
width, height (number, optional): resize to these dimensions in points
embed (boolean): embed instead of link (default false)
name (string, optional)
Inputs: path (required), x, y, name, +3 more.
illustrator_run_scriptRun ExtendScriptADestructive
Execute arbitrary ExtendScript (Illustrator's JavaScript) in the active Illustrator instance. Use this for anything the specialized tools do not cover — advanced paths, effects, batch edits, reading detailed properties, etc.
The code runs inside a function body: use return <value> to send JSON-serializable data back. The global app and the active document are available, plus helpers: __doc(), __color(hex), __setPos(item, x, y), __itemInfo(item), __abRect(), __activeAB(doc), __style(item, opts).
Coordinates in Illustrator's native API are Y-up and global; the helpers convert to artboard-relative Y-down.
Example code: var d = __doc(); var r = d.pathItems.rectangle(0, 0, 100, 100); return __itemInfo(r);
NOTE: This can modify or delete artwork and interact with the file system. Prefer the specialized tools when they fit.
Inputs: code (required).
illustrator_save_documentSave DocumentAIdempotent
Save the active document. With no 'path', saves in place (the document must already have a file). With a 'path', saves a copy in the given format.
Args:
path (string, optional): absolute destination path
format ('ai'|'pdf'|'eps'): used only when 'path' is given (default 'ai').
Inputs: path, format.
illustrator_select_allSelect AllAIdempotent
Select all objects in the active document.
Inputs: no named parameters.
illustrator_select_by_nameSelect By NameAIdempotent
Select objects by their name (assigned when created). Clears the previous selection first.
Args:
name (string): name (or substring) to match
exact (boolean): require an exact match (default false).
Inputs: name (required), exact.
illustrator_set_active_layerSet Active LayerAIdempotent
Make an existing layer the active one (subsequent new artwork goes here).
Args:
name (string): the layer name.
Inputs: name (required).
illustrator_set_colorSet Color of SelectionAIdempotent
Change fill/stroke of the selected objects. For text objects, 'fill' recolors the text.
Args: fill (color), stroke (color), strokeWidth (number). Provide at least one.
Inputs: fill, stroke, strokeWidth.
illustrator_transform_selectionTransform SelectionA
Move, rotate and/or scale the currently selected objects.
Args (all optional, applied in order move -> rotate -> scale):
dx, dy (number): move by this many points (dy positive = down)
rotate (number): rotation in degrees (counter-clockwise positive)
scale (number): uniform scale in percent (100 = no change)
scale_x, scale_y (number): non-uniform scale in percent (used if 'scale' omitted).
Inputs: dx, dy, scale, rotate, +2 more.
illustrator_vectorize_imageVectorize Image → Editable PathsA
Turn a raster image (PNG/JPG, e.g. AI-generated art a client sent) into editable VECTOR PATHS in Illustrator. This automates the 'redraw the artwork from scratch' task.
Engines:
'vtracer' (default): open-source VTracer produces a clean SVG that is opened as editable paths. Usually cleaner than Image Trace; free and local. Needs the
vtracerbinary installed (see README).'image_trace': Illustrator's built-in Image Trace (no install), kept as a fallback.
Input: path (absolute) OR image_base64 (bytes / data: URI, for images pasted in chat).
VTracer args: mode ('color'|'blackwhite'), curve_mode ('spline'|'polygon'|'pixel'), filter_speckle (remove specks, higher = cleaner), color_precision (2-8), corner_threshold (deg). Image Trace args: mode, preset, max_colors, threshold, path_fidelity, corner_fidelity, noise_fidelity, expand.
Best on logos, flat art, line art, and few-color graphics. Photorealistic images produce many paths and usually need manual cleanup.
Inputs: mode, path, engine, expand, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Each tool targets a specific action on a specific resource (e.g., create_rectangle, list_layers, export_document) with no overlapping purposes. The run_script tool is explicitly for edge cases, and its description warns to prefer specialized tools.
All tools follow the consistent pattern 'illustrator_verb_noun' in snake_case, making the tool set predictable and easy to navigate.
29 tools is well-scoped for a complex application like Illustrator. The set covers document, object, selection, transformation, and layer operations without being overwhelming.
Core workflows (create, select, transform, organize, export) are covered. Missing dedicated tools for editing text content or creating custom paths, but the run_script tool fills these gaps adequately.
Maintenance
Related MCP Connectors
Direct AI video, image, music and storyboard production from any MCP client.
AI video, image and audio generation with 140+ AI models from any MCP agent
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to generate vector graphics in Adobe Illustrator using natural language prompts, by sending ExtendScript commands via a local MCP server.174-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to automate Adobe Illustrator, converting bitmap artwork into editable .ai files, running ExtendScript, and capturing the Illustrator window for visual QA.1-
- AlicenseAqualityCmaintenanceAn MCP server that lets AI assistants like Claude control Adobe Illustrator through natural language by executing ExtendScript code and providing document state inspection.127MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that lets AI assistants control Adobe Illustrator locally—running ExtendScript, capturing canvas screenshots, exporting artwork, and optionally remembering techniques—all without network activity.-