illustrator-ai-mcp

Let Claude design in Adobe Illustrator — 100% local, private by default.

An MCP (Model Context Protocol) server that gives AI assistants hands and eyes inside Adobe Illustrator: it writes and runs ExtendScript, sees the canvas via window screenshots, reads document structure, exports artwork, and (optionally) remembers techniques that worked — all without a single byte leaving your machine from this server.

📖 New here? Start with the step-by-step USER_GUIDE.md — install, Claude Desktop/Code setup, permissions, and troubleshooting for both platforms.

Privacy

• No network code. This package contains zero HTTP clients, telemetry, or analytics. It talks only to Illustrator (via AppleScript/ExtendScript) and your local filesystem.

• History is opt-in and OFF by default. Nothing is logged until you (or the AI, with your permission) call set_memory(True).

• One-command wipe. Everything the server ever stores lives in ~/.illustrator-mcp. Delete that folder and it's gone. There is also a clear_history capability in the memory layer.

• Honest caveat: screenshots of your Illustrator window and script results are sent to the AI model as part of your conversation — that is inherent to how the AI sees the canvas and iterates on the design. If a document is confidential, don't ask an AI to look at it. The server itself, however, never transmits anything on its own.

Related MCP server: illustrator-mcp

Features vs. the original

Inspired by spencerhhubert/illustrator-mcp-server, rebuilt with the feedback loop an AI actually needs:

Requirements

• macOS (AppleScript bridge — fully supported) or Windows (COM bridge — experimental)

• Adobe Illustrator (any recent CC version), running

• Python 3.11+

• uv recommended (plain pip works too)

Install

With uv (recommended)

git clone https://github.com/Gokul2/illustrator-mcp-Gokul-Dhatkshina-Moorthy-.git illustrator-ai-mcp
cd illustrator-ai-mcp
uv sync

With plain pip

git clone https://github.com/Gokul2/illustrator-mcp-Gokul-Dhatkshina-Moorthy-.git illustrator-ai-mcp
cd illustrator-ai-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Hook it up

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "illustrator": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/illustrator-ai-mcp",
        "run",
        "illustrator-ai-mcp"
      ]
    }
  }
}

Restart Claude Desktop afterwards.

Claude Code

claude mcp add illustrator -- uv --directory /absolute/path/to/illustrator-ai-mcp run illustrator-ai-mcp

First run: macOS permissions

The first time the server touches Illustrator, macOS will ask for two permissions. Grant both to the app hosting the server (Claude Desktop, your terminal, etc.):

1. Automation — lets the server send ExtendScript to Illustrator. System Settings → Privacy & Security → Automation → enable Adobe Illustrator under your client app.

2. Screen Recording — lets view_canvas screenshot the Illustrator window. System Settings → Privacy & Security → Screen Recording → enable your client app, then restart it.

If a screenshot comes back black or the tool reports a permission error, Screen Recording is the usual culprit.

Tool reference

Example prompts

• "Design a minimalist mountain logo — dark blue palette, geometric, on a square artboard."

• "Recreate this layout as 3 variations on separate artboards."

• "Draw a sunburst badge with 24 rays, then export it as an SVG to my Desktop."

• "Look at the canvas and tell me what's misaligned, then fix it."

• "That gradient trick worked great — save it as a snippet for next time."

Your data

Everything the server stores lives in one folder:

~/.illustrator-mcp/

That's the opt-in run history (SQLite), optional screenshots, and your snippet library. To wipe it:

• ask the AI to clear the history (uses the memory layer's clear_history), or

• nuke it yourself: rm -rf ~/.illustrator-mcp

Nothing else is written anywhere, and nothing is ever transmitted by this server.