Illustrator MCP server

Read from the package source without running it. The installed server may list more.

• align_objects

  Align and/or distribute multiple objects by their UUIDs

• apply_graphic_style

  Apply a graphic style to objects. Note: Illustrator will be activated (brought to foreground) during execution.

• apply_text_style

  Apply a character or paragraph style to a text frame. Note: Illustrator will be activated (brought to foreground) during execution.

• assign_color_profile

  Assign (tag) a color profile to the document. WARNING: This only changes the profile tag \u2014 it does NOT convert color values (ICC conversion). For full conversion, use Edit > Convert to Profile in Illustrator. Note: Illustrator will be activated (brought to foreground) during execution.

• check_contrast

  Check WCAG color contrast ratios. Manual mode: provide two colors. Auto mode: detect overlapping foreground/background pairs in the document. Note: GrayColor uses ink-quantity interpretation (0=white, 100=black), which differs from the API reference.

• check_text_consistency

  Analyze text frames for dummy/placeholder text and known notation variation patterns (katakana long vowel, fullwidth/halfwidth, wave dash/tilde). Returns all text contents for LLM-driven deeper analysis of inconsistencies, typos, and version mismatches. Note: AI analysis may miss errors and does not replace a human text review.

• close_document

  Close the active Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.

• convert_coordinate

  Convert a point between artboard and document coordinate systems in the active document.

• convert_to_outlines

  Convert text to outlines. Note: Illustrator will be activated (brought to foreground) during execution.

• create_crop_markswrite action

  Create crop marks (\u30C8\u30F3\u30DC / trim marks) on the active artboard or selected objects. By default, creates marks for the artboard and expands the artboard to include all marks. With use_selection=true, creates marks for the currently selected object(s) without modifying the artboard. Automatically selects Japanese-style (\u65E5\u672C\u5F0F) or Western-style crop marks based on locale. Not

• create_documentwrite action

  Create a new Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.

• create_ellipsewrite action

  Create an ellipse. Note: Illustrator will be activated (brought to foreground) during execution.

• create_gradientwrite action

  Create a gradient in the document and optionally apply it to objects. Note: Illustrator will be activated (brought to foreground) during execution.

• create_linewrite action

  Create a line. Note: Illustrator will be activated (brought to foreground) during execution.

• create_pathwrite action

  Create a custom path. Note: Illustrator will be activated (brought to foreground) during execution.

• create_path_textwrite action

  Create a text frame that flows along a path. Note: Illustrator will be activated (brought to foreground) during execution.

• create_rectanglewrite action

  Create a rectangle. Note: Illustrator will be activated (brought to foreground) during execution.

• create_text_framewrite action

  Create a text frame. Note: Illustrator will be activated (brought to foreground) during execution.

• delete_objectswrite action

  Delete one or more objects by UUID (get UUIDs from find_objects / get_layers / get_selection). Locked objects are skipped unless force_unlock is true. Reversible with the undo tool. To delete a whole layer use manage_layers instead. Note: Illustrator will be activated (brought to foreground) during execution.

• duplicate_objects

  Duplicate one or more objects, optionally offsetting the copies. Note: Illustrator will be activated (brought to foreground) during execution.

• export

  Export objects, groups, artboards, or selection. Use target "artboard:all" to batch-export every artboard in one call. For single PNG/JPG exports, the exported image is returned as base64 in the response \u2014 you can view it directly without reading the file from disk ("artboard:all" returns file paths only). Note: Illustrator will be activated (brought to foreground) during execution.

• export_pdf

  Export print-ready PDF. Note: Illustrator will be activated (brought to foreground) during execution. The exported PDF should be verified by a human before final submission.

• extract_design_tokens

  Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format

• find_objects

  Search for objects by specified criteria

• get_artboards

  Get all artboard information

• get_colors

  Get all color information used in the document

• get_document_info

  Get document metadata

• get_document_structure

  Get tree structure of layers, groups, and objects

• get_effects

  Get effect and appearance information

• get_groups

  Get structure of groups, clipping masks, and compound paths

• get_guidelines

  Get guide information

• get_images

  Get embedded and linked image information

• get_layers

  Get layer structure as a tree

• get_overprint_info

  Get overprint settings with K100/rich black detection and intent classification

• get_path_items

  Get path and shape data. Note: fill/stroke do not include per-attribute opacity; use the item-level opacity field for transparency.

• get_selection

  Get detailed information about the currently selected objects

• get_separation_info

  Get color separation information: CMYK process plates and spot color plates with usage counts

• get_symbols

  Get symbol definitions and instances

• get_text_frame_detail

  Get detailed text frame attributes including per-character runs (font, tracking, akiLeft/akiRight, tsume, proportionalMetrics), kerning pairs with manual kerning values (1/1000 em), and paragraph attributes. Returns cssHints for web/CSS reproduction. Note: paragraph leading/autoLeading may return 0 in some ExtendScript versions due to missing API support.

• group_objects

  Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. Note: Illustrator will be activated (brought to foreground) during execution.

• import_svg_as_editable

  Import an SVG file into the active document as editable Illustrator paths/text/groups (NOT as a linked image). Internally opens the SVG as a temporary document, duplicates its contents into the target document, then closes the source. Use this instead of place_image for SVG. Note: Illustrator will be activated (brought to foreground) during execution.

• list_fonts

  List fonts available in Illustrator. Does not require an open document.

• list_graphic_styles

  List all graphic styles in the active document.

• list_text_frames

  List text frames with summary-level information. Supports reading-order sort, pagination, and a lightweight contents-only mode.

• list_text_styles

  List all character and paragraph styles in the active document.

• manage_artboards

  Add, remove, resize, rename, fit, or rearrange artboards. Note: Illustrator will be activated (brought to foreground) during execution.

• manage_datasets

  List variables/datasets, apply or create datasets, bind variables to objects, import CSV/XML. CSV headers are auto-bound to objects with matching names. Note: Illustrator will be activated (brought to foreground) during execution.

• manage_layers

  Add, rename, show/hide, lock/unlock, reorder, or delete layers

• manage_linked_images

  Relink or embed a placed (linked) image. embed converts PlacedItem to RasterItem \u2014 the original UUID becomes invalid and a new UUID for the RasterItem is returned. Note: Illustrator will be activated (brought to foreground) during execution.

• manage_swatches

  Add, update, or delete swatches in the active document. Note: Illustrator will be activated (brought to foreground) during execution.

• modify_object

  Modify properties of an existing object. Note: Illustrator will be activated (brought to foreground) during execution.

• move_to_layer

  Move one or more objects to a different layer. Note: Illustrator will be activated (brought to foreground) during execution.

• open_document

  Open an Illustrator document from a file path. Note: Illustrator will be activated (brought to foreground) during execution.

• place_color_chips

  Extract all unique colors from the document and place color chip swatches with labels outside the artboard

• place_image

  Place a raster or PDF image file (PNG, JPG, TIFF, PSD, PDF, etc.) into the document as a linked or embedded image. SVG is NOT supported here because PlacedItems produces a non-editable linked artwork \u2014 use import_svg_as_editable instead to bring SVG content in as editable paths/text. Note: Illustrator will be activated (brought to foreground) during execution.

• place_style_guide

  Place a visual style guide (color chips, font samples, spacing indicators) outside the artboard

• place_symbol

  Place a new symbol instance or replace the symbol definition of an existing instance. Note: Illustrator will be activated (brought to foreground) during execution.

• preflight_checkwrite action

  Run pre-press quality checks. Note: This check is not exhaustive \u2014 it does not replace a human final review. GrayColor uses ink-quantity interpretation (0=white/no ink, 100=black/full ink), which differs from the API reference.

• replace_color

  Find and replace colors across the document or within a specific layer. Limitations: SpotColor and GrayColor matching not supported. Cross-colorspace matching (e.g. RGB\u2192CMYK) not possible \u2014 from_color and to_color must use the same color type as the target objects.

• resize_for_variationwrite action

  Create size variations from a source artboard. Duplicates all objects and scales/repositions them proportionally to fit target sizes. Limitations: no text reflow, effects/strokes scale with objects but may need manual adjustment, proportional placement only (not smart layout).

• save_document

  Save the active Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.

• select_objects

  Select objects by UUID. Pass an empty array to deselect all. Selected objects can then be manipulated interactively in Illustrator.

• set_illustrator_version

  Set which Illustrator version to target when multiple versions are installed. Specify a version year (e.g. "2024", "2025"). If Illustrator is already running, connects to the running instance regardless of version. If not running, launches the specified version. Use clear: true to reset to default behavior (connect to any running Illustrator).

• set_workflow

  Set the session-level workflow and default coordinate system. Call this after confirming the user's intent (web, print, or video). Once set, all tools that omit coordinate_system will use the session default. Use clear: true to reset to auto-detection from document (CMYK/print \u2192 document coords, RGB/web \u2192 artboard-web).

• set_z_orderwrite action

  Change the stacking order of an object. Note: Illustrator will be activated (brought to foreground) during execution.

• undo

  Undo or redo actions in Illustrator. Note: Illustrator will be activated (brought to foreground) during execution.

• ungroup_objects

  Ungroup a group, releasing its children to the parent layer. Note: Illustrator will be activated (brought to foreground) during execution.

• Code scan157 source files scanned20/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 5 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Illustrator: common questions

Is Illustrator MCP server safe?

Yes, by our scan: it is graded A (86/100). Read the Illustrator safety report

How do I install Illustrator?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Illustrator need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Illustrator maintained?

The last commit was 5 days ago (2026-09-14). The latest release is v1.8.0.