illustrator-mcp-server
MCP server for reading, manipulating, and exporting Adobe Illustrator design data
Versions
1.5.1latest1.5.01.4.01.3.21.3.1+ show 14 moreshow less
1.3.01.2.121.2.111.2.101.2.91.2.61.2.51.2.41.2.31.2.11.2.01.1.11.0.11.0.0Tools 66
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 — 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.
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.
get_document_structure Get tree structure of layers, groups, and objects
get_groups Get structure of groups, clipping masks, and compound paths
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.
get_separation_info Get color separation information: CMYK process plates and spot color plates with usage counts
get_selection Get detailed information about the currently selected objects
get_guidelines Get guide information
get_effects Get effect and appearance 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_symbols Get symbol definitions and instances
get_document_info Get document metadata
list_text_frames List text frames with summary-level information. Supports reading-order sort, pagination, and a lightweight contents-only mode.
get_artboards Get all artboard information
convert_coordinate Convert a point between artboard and document coordinate systems in the active document.
list_fonts List fonts available in Illustrator. Does not require an open document.
get_colors Get all color information used in the document
find_objects Search for objects by specified criteria
extract_design_tokens Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format
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.
ungroup_objects Ungroup a group, releasing its children to the parent layer. Note: Illustrator will be activated (brought to foreground) during execution.
convert_to_outlines Convert text to outlines. Note: Illustrator will be activated (brought to foreground) during execution.
create_line Create a line. Note: Illustrator will be activated (brought to foreground) during execution.
create_document Create a new Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.
resize_for_variation 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).
close_document Close the active Illustrator document. 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.
manage_swatches Add, update, or delete swatches in the active document. Note: Illustrator will be activated (brought to foreground) during execution.
set_z_order Change the stacking order of an object. 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 — 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.
modify_object Modify properties of an existing object. 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_color_chips Extract all unique colors from the document and place color chip swatches with labels outside the artboard
duplicate_objects Duplicate one or more objects, optionally offsetting the copies. Note: Illustrator will be activated (brought to foreground) during execution.
save_document Save the active Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.
create_rectangle Create a rectangle. Note: Illustrator will be activated (brought to foreground) during execution.
manage_linked_images Relink or embed a placed (linked) image. embed converts PlacedItem to RasterItem — the original UUID becomes invalid and a new UUID for the RasterItem is returned. Note: Illustrator will be activated (brought to foreground) during execution.
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.
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_artboards Add, remove, resize, rename, fit, or rearrange artboards. Note: Illustrator will be activated (brought to foreground) during execution.
create_ellipse Create an ellipse. Note: Illustrator will be activated (brought to foreground) during execution.
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.
apply_graphic_style Apply a graphic style to objects. Note: Illustrator will be activated (brought to foreground) during execution.
list_graphic_styles List all graphic styles in the active document.
apply_text_style Apply a character or paragraph style to a text frame. Note: Illustrator will be activated (brought to foreground) during execution.
list_text_styles List all character and paragraph styles in the active document.
create_crop_marks Create crop marks (トンボ / trim marks) on the active artboard or selected objects.
manage_layers Add, rename, show/hide, lock/unlock, reorder, or delete layers
open_document Open an Illustrator document from a file path. Note: Illustrator will be activated (brought to foreground) during execution.
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→CMYK) not possible — from_color and to_color must use the same color type as the target objects.
create_path_text Create a text frame that flows along a path. 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.
align_objects Align and/or distribute multiple objects by their UUIDs
create_text_frame Create a text frame. Note: Illustrator will be activated (brought to foreground) during execution.
create_path Create a custom path. Note: Illustrator will be activated (brought to foreground) during execution.
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 — 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.
create_gradient Create a gradient in the document and optionally apply it to objects. 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.
select_objects Select objects by UUID. Pass an empty array to deselect all. Selected objects can then be manipulated interactively in Illustrator.
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.
preflight_check Run pre-press quality checks. Note: This check is not exhaustive — 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.
set_workflow Set the session-level workflow and default coordinate system.
set_illustrator_version Set which Illustrator version to target when multiple versions are installed.
Permissions 3
filesystem low shell high env_vars low