🇺🇸 English | 🇯🇵 日本語 | 🇨🇳 简体中文 | 🇰🇷 한국어 | 🇪🇸 Español | 🇩🇪 Deutsch | 🇫🇷 Français | 🇵🇹 Português (BR)

Illustrator MCP Server

An MCP (Model Context Protocol) server for reading, manipulating, and exporting Adobe Illustrator design data — with 63 built-in tools.

Control Illustrator directly from AI assistants like Claude — extract design information for web implementation, verify print-ready data, and export assets.

Everything Adobe’s official Illustrator MCP (beta) can do — and more. See the comparison.

---

🎨 Gallery

All artwork below was created entirely by Claude through natural language conversation — no manual Illustrator operation involved.

See detailed breakdowns below for prompts, tool usage, and artboard structure.

---

[!TIP] Developing and maintaining this tool takes time and resources. If it helps your workflow, your support means a lot — ☕ buy me a coffee!

---

🚀 Quick Start

🛠️ Claude Code

Requires Node.js 20+.

claude mcp add illustrator-mcp -- npx illustrator-mcp-server

🖥️ Claude Desktop

1. Download illustrator-mcp-server.mcpb from GitHub Releases
2. Open Claude Desktop → Settings → Extensions
3. Drag and drop the .mcpb file into the Extensions panel
4. Click the Install button

[!CAUTION] AI can make mistakes. Do not over-rely on the output — always have a human perform the final check on submission data. The user is responsible for the results.

[!NOTE] macOS: On first run, allow automation access in System Settings > Privacy & Security > Automation.

[!NOTE] Modify and export tools will bring Illustrator to the foreground during execution.

Multiple Illustrator Versions

If you have multiple versions of Illustrator installed, you can tell Claude which version to use during conversation. Just say something like “Use Illustrator 2024” and the set_illustrator_version tool will target that version.

[!NOTE] If Illustrator is already running, the server connects to the running instance regardless of the version setting. The version is only used to launch the correct version when Illustrator is not yet running.

---

🎬 What You Can Do

You:    Show me all the text information in this document
Claude:  → list_text_frames → get_text_frame_detail
         There are 12 text frames in the document.
         The heading "My Design" uses Noto Sans JP Bold 48px, color #333333 ...

You:    Run a pre-press preflight check
Claude:  → preflight_check
         ⚠ 2 warnings:
         - Low resolution image: image_01.jpg (150dpi) — 300dpi or higher recommended
         - Non-outlined fonts: 3 text frames

You:    Check text for inconsistencies
Claude:  → check_text_consistency
         📝 Consistency Report:
         ⚠ "Contact Us" vs "Contact us" — capitalization mismatch
         ❌ "Lorem ipsum" (2 places) — placeholder text remaining

You:    Create banner size variations from this A4 flyer
Claude:  → get_document_info → resize_for_variation
         Created 3 size variations:
         - 728×90 / 300×250 / 160×600

---

🆚 Comparison with Adobe’s Official Illustrator MCP

In short: everything the official MCP does, this project does too — plus a lot more. Adobe ships a built-in MCP server in Illustrator Beta (30.4+, still beta-only as of August 2026), focused on analyzing and batch-processing existing documents. This project covers those same workflows — analysis, bulk recoloring, variations, batch artboard export, font / broken-link checks — and adds what the official server doesn’t have: creating artwork from scratch, saving documents, print & prepress checks, and design-system tools. And it runs on stable Illustrator, no beta required.

* Based on user reports as of April 2026 (beta). The official server is under active development — see Adobe’s documentation for the latest status.

---

📖 Recipes

---

Workflow Templates

Pre-built workflow templates available in the Claude Desktop prompt picker.

---

Tool Reference

Read Tools (21)

Modify Tools (39)

Export Tools (2)

Utility (3)

---

Coordinate System

The server automatically detects the coordinate system from the document:

• CMYK documents use Illustrator’s native coordinate system, matching what print designers expect
• RGB documents use a web-style coordinate system that is easier for AI to work with
• Use set_workflow to override the auto-detected coordinate system if needed
• All tool responses include a coordinateSystem field indicating which system is active

---

Example: SMPTE Test Pattern

A 1920×1080 SMPTE color bar test pattern, created entirely through natural language instructions to Claude.

Prompt:

Make a 1920x1080 video test pattern

Result:

Artboard structure (via get_document_structure):

Tools used: create_document, manage_layers, create_rectangle ×23, create_line ×2, create_ellipse, create_text_frame ×6, modify_object ×4, save_document, export

---

Example: Twilight Geometry

An abstract geometric landscape artwork — created entirely by Claude, with no human design direction beyond “make whatever art you want.”

Prompt:

Make an art piece of your own imagination in Illustrator. Take your time. Create whatever you like.

Claude’s process:

I’ll create “Twilight Geometry” — an abstract landscape with geometric celestial elements. A deep gradient twilight sky, layered mountain silhouettes, a crescent moon with decorative rings, and stars scattered across the canvas.

Diamond-shaped stars in different colors — warm whites, cool blues, lavender purples — each one subtly different to suggest different types of stars. Constellation lines connecting them. Wireframe triangles and a hexagon floating in the sky for a mystical atmosphere.

A water surface at the bottom with the moon’s light reflected as shimmering wavy lines, fading as they descend.

Claude’s reflection:

It turned out better than I expected. I think the hybrid world of geometry and nature came through well.

Result:

Tools used: create_document, manage_layers ×4, create_rectangle ×2, create_gradient ×2, create_path ×11, create_ellipse ×14, create_line ×4, create_text_frame ×2, modify_object, set_z_order, export

---

Known Limitations

---

For Developers

Architecture

flowchart LR
    Claude |MCP Protocol| Server["MCP Server\n(TypeScript/Node.js)"]

    Server -.->|generate| Runner["run-{uuid}.scpt / .ps1"]
    Server -.->|generate| JSX["script-{uuid}.jsx\n(BOM UTF-8)"]
    Server -.->|write| PF["params-{uuid}.json"]

    Runner -->|execFile| osascript
    Runner -->|execFile| PS["powershell.exe"]

    osascript -->|do javascript| AI["Adobe Illustrator\n(ExtendScript/JSX)"]
    PS -->|DoJavaScript| AI

    JSX -.->|execute| AI
    PF -.->|read| AI
    AI -.->|write| RF["result-{uuid}.json"]
    RF -.->|read| Server

---

Building from Source

git clone https://github.com/ie3jp/illustrator-mcp-server.git
cd illustrator-mcp-server
npm install
npm run build
claude mcp add illustrator-mcp -- node /path/to/illustrator-mcp-server/dist/index.js

Verify

npx @modelcontextprotocol/inspector npx illustrator-mcp-server

Testing

# Unit tests
npm test

# E2E smoke test (requires Illustrator running)
npx tsx test/e2e/smoke-test.ts

The E2E test creates fresh documents (RGB + CMYK), places test objects, runs 182 test cases across 10 phases covering all registered tools and coordinate system auto-detection, and cleans up automatically.

---

Disclaimer

This tool automates many Illustrator operations, but AI can make mistakes. Extracted data, preflight results, and document modifications should always be reviewed by a person. Do not rely on this tool as your sole quality check. Use it as an assistant alongside your own manual verification, especially for print submissions and client deliverables. The authors are not responsible for any damages or losses arising from the use of this software or its outputs.

---

License

MIT