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. If any UUID is not found, nothing is moved and the missing UUIDs are returned in notFound.

• apply_graphic_style

  Apply a graphic style to objects. Objects that are found are styled; missing UUIDs are listed in notFound and per-object failures in errors (success is false if either is non-empty). 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.

• check_contrast

  Check WCAG color contrast ratios. Manual mode: provide color1 and color2. Auto mode (auto_detect: true): find visible foreground/background pairs by bounding-box overlap (stacking order, opacity and clipping are not considered; gradient/pattern/image backgrounds are reported as unevaluated). Non-RGB colors are converted without ICC profiles, so their ratio is approximate and WCAG pass/fail is null

• 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. If the document has unsaved changes and save is omitted, the document is NOT closed and an error is returned \u2014 pass save: true to save, or save: false to explicitly discard the changes. 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 (irreversible except via undo). Text frames that cannot be converted (e.g. locked) are left as-is and listed in "failed" with the reason; success is false if any failed. 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; the original (trim) rectangle is returned as original_artboard_rect. With use_selection=true, creates marks for the currently selected object(s) without modifying the artboard. Automatically selects Japanese-style

• 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. If font_name is not found, nothing is created and an error with font_candidates is returned. 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. Positioning differs by kind: for point text (x, y) is the text ANCHOR \u2014 y is the BASELINE of the first line (glyphs extend above it), and x is the left edge, center, or right edge depending on justification (so right-aligned text only needs justification: "right" with x at the right edge). For area text (x, y) is the top-left of the text area. verified.bounds always repor

• 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. success is false if any UUID was not found or could not be deleted (see notFound / errors). The undo tool may revert it, but undo steps are Illustrator history steps, not tied to MCP calls. To delete a whole layer use manage_layers instead. Note: Il

• duplicate_objects

  Duplicate one or more objects, optionally offsetting the copies. Copies (and their group/compound-path children) get new UUIDs; notes/memos are kept (objects whose note cannot be rewritten keep the source UUID and are listed in warnings). Missing UUIDs are listed in notFound and per-item failures in failed (success is then false, but copies that were made are still returned). Note: Illustrator wil

• 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; images larger than ~3.75MB are not inlined). An explicit output_path that already exists

• export_pdf

  Export print-ready PDF. Japanese trim marks (marks_style "japanese" + trim_marks) are drawn temporarily on the document and removed after export; they are only supported for single-artboard documents (multi-artboard documents return an error). When a preset is given, trim mark settings you do not specify are kept from the preset. An explicit output_path that already exists is not overwritten unles

• extract_design_tokens

  Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format. Optionally writes the result to output_path (never overwrites an existing file unless overwrite: true).

• find_objects

  Search for objects by specified criteria

• get_artboards

  Get all artboard information

• get_colors

  Get all color information used in the document. usedFillColors / usedStrokeColors list each distinct color once with a count of how many paths and text ranges use it (most used first).

• 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. Children of a clipping-mask group mark the mask path with clipping: true. When depth cuts the tree off, the item has childrenTruncated: true and childCount (children is empty only because of the depth limit).

• get_guidelines

  Get guide information

• get_images

  Get embedded and linked image information: file path, broken-link status (linkBroken: file missing on disk), pixel size, and effective resolution (ppi at the placed size; rotation-safe).

• get_layers

  Get layer structure as a tree

• get_overprint_info

  Get overprint settings of paths (incl. compound paths), text (per character) and raster images, each with a heuristic label (K100 / rich black / spot / likely accidental) inferred from colors only. The result includes the scan scope; placed files, symbols and meshes are not inspected.

• get_path_items

  Get path and shape data, including paths inside groups and compound paths (clipping: true marks a clipping-mask path). 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. While editing text (text cursor or selected characters), the containing text frame is returned with a textSelection field (selected contents, length, start; insertionPoint: true for a bare cursor).

• get_separation_info

  Get color separation info: process and spot plates actually used by the artwork (paths, gradients, text, rasters) with usage counts, inks with no detected usage, global process colors, and Illustrator's document ink list. The result includes the scan scope; placed files, patterns and symbols are not inspected.

• 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), paragraph attributes (leading, autoLeading, paragraph style), orientation (horizontal/vertical) and threaded-frame links (nextFrameUUID/previousFrameUUID). Returns cssHints for web/CSS reproduction.

• group_objects

  Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. If any UUID is not found, nothing is grouped and the missing UUIDs are returned in notFound. Note: Illustrator will be activated (brought to foreground) during execution.

• import_svg_as_editable
• 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 (including orientation and threaded-frame links nextFrameUUID/previousFrameUUID). Supports reading-order sort, pagination, and a lightweight contents-only mode. layer_name includes text inside groups and sublayers of that layer.

• 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/export variable XML, or generate artboards from CSV. import (XML) replaces ALL existing variables and datasets in the document. import_csv does not create variables or datasets: it copies the objects on artboard 0 (left unchanged as the template) onto one new artboard per CSV row, placed to the right of existing a

• manage_layers

  Add, rename, show/hide, lock/unlock, reorder, or delete top-level layers by name. If several layers share a name, rename/show/hide/lock/unlock/reorder act on the topmost one with a warning, and delete is refused.

• 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. fill/stroke on a group or compound path are applied to every path and text frame inside it (like Illustrator's UI; clipping paths and guides are skipped) and the result reports how many were changed (painted) and the colors they actually have (verified.descendantFills). success is false if any of them could not be painted. Note: Illustrator will be activate

• move_to_layer

  Move one or more objects to a different layer. Objects that are found are moved; missing UUIDs are listed in notFound and per-object failures in errors (success is false if either is non-empty). 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 used in the document (path fills/strokes including inside groups and compound paths, text colors, gradient stop colors; spot colors per tint) and place color chip swatches with labels outside the artboard. Pattern fills cannot be shown as chips and are counted in skippedColors. Items already on the chip layer are ignored.

• 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 next to the artboard: color chips (path, text and gradient stop colors), font samples, and legends of recurring spacings, artboard margins and guide gaps. Everything goes on a NON-PRINTING layer (created with Print off; if layer_name already exists its print setting is kept and a warning is returned). By default nothing is drawn on the artboard itself; set annotate_artbo

• 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_check
• replace_color
• resize_for_variationwrite action

  Create size variations from a source artboard. Duplicates all objects and scales/repositions them proportionally to fit target sizes. New artboards are placed to the right of all existing artboards; copies get new UUIDs. 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. save_as refuses to replace an existing file unless overwrite is true. 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 steps in Illustrator's history. Steps are Illustrator history entries, not MCP tool calls (one tool call may create several steps). Returns count = steps actually performed; if a step fails, the result is an error that still reports how many were performed. 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 scan159 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 4 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

86/100

higher than 72% of 48,255 servers

Tools

66

the typical server has 7

Tools that change things

18%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

143

more than 95% of 28,688 servers

Downloads a week

3,633

more than 95% of 12,191 servers with a package

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, Cursor, VS Code or Claude Desktop 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 36 days ago (2026-09-29). The latest release is v1.10.3.

How does Illustrator compare with other MCP servers?

safety score 86/100 (higher than 72% of 48,255 servers); tools 66 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.