Illustrator MCP Server
Drive Adobe Illustrator from any MCP client: artwork, type, colour, effects, data and export.
Connector by zachshallbetter · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/zachshallbetter-adobe-mcp-illustrator
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: ui-design
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 55 read · 223 write · 30 delete
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 308
Read from the source code; the running server may list different tools.
Read 55 · Look things up without changing anything.
change_selectionconvert_live_shapesconvert_text_to_outlinesconvert_to_artboardsdeselect_allfind_menu_commandsfind_replace_textfind_unused_swatchesget_appearanceget_boundsget_color_settingsget_default_fill_stroke
Show 43 more tools
get_document_infoget_document_setupget_file_infoget_item_dataget_path_infoget_preferencesget_selectionget_text_attributesget_trace_infohelpillustrator_statuslist_actionslist_artboardslist_assetslist_brusheslist_document_fontslist_document_presetslist_documentslist_fontslist_graphic_styleslist_graphslist_imageslist_itemslist_layerslist_mesheslist_print_settingslist_sliceslist_storieslist_swatcheslist_symbolslist_text_styleslist_tracing_presetslist_variablesopen_brush_libraryopen_documentopen_document_with_optionsopen_graphic_stylesopen_swatch_libraryopen_symbol_libraryshow_allshow_data_setswitch_documentview_artboard
Write 223 · Create, change, send or run things.
add_appearance_attributeadd_artboardadd_current_coloradd_to_clipping_maskadd_used_colorsadjust_colorsadjust_textalign_artboardsalign_itemsapply_3d_effectapply_brushapply_effect
Show 211 more tools
apply_gradientapply_graph_dataapply_graphic_styleapply_last_effectapply_matrixapply_patternapply_smart_punctuationapply_svg_filterapply_text_stylearrange_itemsattach_to_perspectiveaverage_pointsbind_variablebreak_symbol_linkchange_caseclose_all_documentsclose_documentcollect_assetscolorize_imagecompound_shapecopy_artboardcopy_itemscreate_action_setcreate_arccreate_data_setscreate_documentcreate_document_from_presetcreate_ellipsecreate_gradientcreate_layercreate_linecreate_pathcreate_path_textcreate_patterncreate_polar_gridcreate_polygoncreate_rectanglecreate_rectangular_gridcreate_spiralcreate_starcreate_swatchcreate_swatch_groupcreate_symbolcreate_textcreate_text_stylecreate_trim_markscreate_variablecrop_imagedistort_itemsdistribute_itemsduplicate_itemsduplicate_swatchesduplicate_symboledit_clipping_maskedit_colorsedit_envelopeedit_patternedit_slicesedit_swatchedit_text_styleexpand_blendexpand_live_paintexpand_objects_on_pathexpand_traceexport_autocadexport_data_setsexport_for_screensexport_jpegexport_pdfexport_perspective_presetsexport_pngexport_psdexport_selectionexport_selection_as_aiexport_svgexport_textexport_tiffexport_variablesexport_web_imageexport_web_svgfill_placeholder_textfit_artboard_to_artworkgo_to_linkgroup_itemshide_itemsimport_brushesimport_csv_dataimport_perspective_presetsimport_textimport_variablesinsert_special_characterintertwineload_actionsload_color_settingsload_swatch_libraryload_text_styleslock_itemsmake_blendmake_clipping_maskmake_compound_pathmake_envelopemake_live_paintmake_repeatmake_trap_strokemerge_swatchesmove_itemsmove_items_to_layernew_from_templatenudge_itemsorganize_layersoverprint_blackpaste_artworkpath_operationpathfinderplace_imageplace_imagesplace_symbolplace_text_fileprint_documentrearrange_artboardsreflect_itemsrelease_blendrelease_clipping_maskrelease_live_paintrelease_perspectiverelease_repeatrelease_tracerelink_imagesrename_assetrename_graphic_stylerename_patternrename_symbolreorder_artboardsrepeat_pathfinderrepeat_transformreplace_blend_spinereplace_fontreplace_symbolresize_itemsreverse_blendrotate_itemsrun_batchsave_brush_librarysave_documentsave_document_copysave_graphic_style_librarysave_swatch_librarysave_symbol_libraryscale_itemsselect_allselect_by_typeselect_itemsselect_layer_artworkselect_nested_itemsselect_sameselect_similar_itemsselect_symbol_instancesselect_toolset_active_artboardset_active_layerset_artboardset_artboard_displayset_asian_typeset_blend_optionsset_character_attributesset_color_viewset_default_fill_strokeset_document_setupset_file_infoset_fillset_isolation_modeset_item_dataset_item_urlset_layer_propertiesset_opacityset_other_layersset_overprintset_paragraph_attributesset_path_optionsset_path_textset_perspective_gridset_preferencesset_repeat_optionsset_right_to_left_textset_strokeset_tab_stopsset_text_contentsset_text_frame_optionsset_text_orientationset_text_styleset_text_wrapset_trace_optionsset_transform_optionsset_transparency_groupset_variables_lockedshear_itemssimplify_pathsplit_pathswap_fill_stroketoggle_corner_widgettoggle_global_edittoggle_prepress_viewtoggle_view_optiontrace_imagetransform_eachtransform_patternungroup_itemsunlock_allupdate_legacy_textupdate_linksuse_clipboard
Delete 30 · Delete, drop, revoke or wipe things.
clean_updelete_artboarddelete_data_setsdelete_empty_artboardsdelete_graphic_stylesdelete_itemsdelete_layerdelete_swatchesdelete_symbolsdelete_text_stylesdelete_variablesedit_anchor_points
Show 18 more tools
edit_swatch_groupexecute_illustrator_codeexecute_menu_commandflatten_transparencyplay_actionrasterize_itemsremove_assetsremove_from_clipping_maskreset_bounding_boxreset_fill_strokerevert_documentrun_image_commandrun_script_filerun_type_commandset_raster_effect_settingssplit_into_gridthread_text_framesunload_actions
Secrets and settings it asks for
Other settings (environment variables or headers).
ILLUSTRATOR_ALLOWED_DIRSILLUSTRATOR_APP_NAMEILLUSTRATOR_SCRIPT_TIMEOUT_MS
Network hosts it talks to 2
color.org· found in codegithub.com· found in code
Files it touches
- Your home directory (~)
- Any path the agent passes to its tools
Tools (308)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
add_appearance_attributeAdd another fill or stroke to each item's appearance (Appearance panel menu > Add New Fill / Add New Stroke), so one object can carry several fills or strokes. The new attribute goes above the current ones; apply_effect, apply_graphic_style or the Appearance panel then style it
add_artboardAdd an artboard. x and y are measured from artboard 0's top-left corner, in points
add_current_colorAdd the current colour as a swatch (Color panel > Create New Swatch): the fill or stroke of the first selected object, or the default fill or stroke when nothing is selected. Named after its values the way Illustrator names them unless a name is given
add_to_clipping_maskPut items inside a clipping mask, keeping their position: into an existing clip group (given the group or its clipping path), or, given a plain path or compound path, make that path a clipping mask around them the way Draw Inside does. The items go in front of the group's other contents
add_used_colorsAdd a swatch for each process colour used in the fills and strokes of the artwork (Swatches panel > Add Used Colors), skipping colours that already have one. Swatches are named the way Illustrator names them, e.g. "C=0 M=60 Y=100 K=0"
adjust_colorsChange colours by script, following Illustrator's colour commands: saturate (Edit > Edit Colors > Saturate: scales each ink, RGB colour amount or spot tint by a percentage), adjust_balance (Edit > Edit Colors > Adjust Color Balance: adds percentages to the CMYK, RGB, gray or global-tint values of colours already in that mode; convert first with edit_colors), complement (Color panel > Complement: the sum of the highest and lowest component minus each component), web_safe (each RGB value to the nearest web-safe step) or printable (RGB brought into the CMYK gamut, like clicking the Color panel's …
adjust_textStep text formatting up or down the way the Type keyboard commands do: font size up or down by points or by Font Size Step Up/Down, kern or track looser or tighter, Clear Tracking, Uniform Type (scales back to 100%), and Fit Headline (Type > Fit Headline, area type)
align_artboardsAlign artboards to one another, or space them evenly, moving the artwork on them along (Artboard tool: align and distribute artboards). Artwork belongs to an artboard when its centre lies on it
align_itemsAlign items to each other (their combined bounds), to an artboard, or to a key object that stays still (Object > Align, Align panel). center_middle centres both ways in one step
apply_3d_effectMake objects or text 3D with a live effect (Effect > 3D and Materials): extrude, revolve, inflate, or rotate (a flat plane turned in 3D). It stays editable in the 3D and Materials panel unless expand is true. The current effect takes depth, cap, revolveAngle, bothSides and wireframe; lighting, materials and rotation stay at the menu command's defaults (Off-Axis Front). With classic: true it applies Effect > 3D (Classic) instead, which also takes rotation angles, perspective and a surface style
apply_brushApply a brush from the document's Brushes panel to paths (as clicking a brush in the Brushes panel does): calligraphic, scatter, art, pattern or bristle. Paths inside groups and compound paths are brushed too. With expand, the brush strokes become ordinary artwork (Object > Expand Appearance). Use import_brushes first for a brush from a library file
apply_effectDescription is built at runtime.
apply_gradientFill (or stroke) items with a gradient swatch and place it the way the Gradient tool does: on each object, or with across: true as one gradient spanning all of them (one gradient across several objects). Give an angle, or from and to points to place it exactly like dragging the Gradient tool (for a radial gradient, from is the centre and to a point on its edge). The gradient can be a document swatch or come from a built-in gradient library (Window > Swatch Libraries > Gradients, the gradient presets), which is loaded first
apply_graph_dataRedraw graphs with new data (the Graph Data window's Import Data and Apply): optionally load a variable library (.xml) holding graph data, then display one of its data sets. Graphs must be bound to graph variables (create_variable with kind graph); a library exported from Illustrator after entering data in the graph carries the format
apply_graphic_styleApply a graphic style from the document's Graphic Styles panel to items. By default the style replaces their appearance; with merge it is added to it (Alt/Option-click in the panel)
Show 293 more tools
apply_last_effectApply the most recently used effect again, with the same settings, to items (Effect > Apply Last Effect). Nothing changes if no effect has been applied in this Illustrator session
apply_matrixTransform items by an affine matrix [a, b, c, d, tx, ty] in artboard terms (x right, y down): x' = a·x + c·y + tx, y' = b·x + d·y + ty, applied around the reference point. tx and ty are points
apply_patternFill or stroke paths, compound paths, groups (every path inside) and text with a pattern swatch in the document, by pattern or swatch name: one made with create_pattern or a predefined one (list_swatches shows them as kind pattern). Library patterns must first be added to the document's Swatches panel. transform_pattern then moves, scales or rotates the pattern inside the objects
apply_smart_punctuationReplace keyboard punctuation with typographer's punctuation, the way Type > Smart Punctuation does: straight quotes to curly quotes, -- to an en dash and --- to an em dash, ... to an ellipsis, multiple spaces after a period to one, and optionally ff/fi/fl/ffi/ffl ligatures and fractions such as 1/2. Formatting is kept
apply_svg_filterApply an SVG filter to items as a Live Effect (Effect > SVG Filters): one of the filters new documents carry (AI_Alpha_1, AI_Alpha_4, AI_BevelShadow_1, AI_CoolBreeze, AI_Dilate_3, AI_Dilate_6, AI_Erode_3, AI_Erode_6, AI_GaussianBlur_4, AI_GaussianBlur_7, AI_PixelPlay_1, AI_PixelPlay_2, AI_Shadow_1, AI_Shadow_2, AI_Static, AI_Turbulence_3, AI_Turbulence_5, AI_Woodgrain) or the name of another SVG filter in the document. The filter must exist in the document. Use expand to turn the result into plain artwork
apply_text_styleApply a character style to text frames, a character range or the selected text, or a paragraph style to their paragraphs. clearOverrides removes local formatting that differs from the style. Without name, the text's current styles are reapplied with overrides cleared (Clear Overrides)
arrange_itemsChange stacking order: bring to front, bring forward, send backward, send to back
attach_to_perspectivePut objects into perspective on a grid plane. Without a position, they are attached where they are (Object > Perspective > Attach to Active Plane); with x and y they are placed at that point on the plane (PageItem.bringInPerspective, in the grid's own coordinates as Adobe's scripting guide uses them). The grid is shown first
average_pointsAverage anchor points (Object > Path > Average): move them onto one horizontal line, one vertical line, or one point. Handles move with their anchors. With join, connect the averaged end points afterwards (Average & Join)
bind_variableBind an existing variable to more items. Each item takes the variable's kind: a text frame for text, a placed image for image, a graph for graph, any object for visibility
break_symbol_linkTurn symbol instances into ordinary artwork (Symbols panel > Break Link to Symbol). The symbol stays in the document
change_caseChange the case of text frames' text (Type > Change Case): UPPERCASE, lowercase, Title Case or Sentence case
change_selectionChange the selection with a Select menu command: reselect (repeat the last Select > Same or Select > Object command), inverse (select everything not selected), next_above or next_below (the next object up or down the stacking order in the same layer; next_below reaches objects hidden behind others). Give target to select those items first; otherwise the current selection is used
clean_upRemove stray points (single-anchor paths), unpainted paths (no fill, no stroke) and empty text from the document (Object > Path > Clean Up). Locked and hidden objects, clipping paths, guides and the paths inside compound paths are left alone
close_all_documentsClose every open document (File > Close All). Unsaved changes are discarded unless save is true; with save, every document with changes must already have a file
close_documentClose the active document. Unsaved changes are discarded unless save is true
collect_assetsAdd artwork to the Asset Export panel (Collect for Export > As Single Asset, or As Multiple Assets). Returns the new asset ids for export_for_screens
colorize_imageColour a grayscale or 1-bit embedded image with an RGB or CMYK colour (Colorize, the way a fill applies to such an image). Embed linked images first with update_links
compound_shapePathfinder panel compound shapes: make one from the targets with a shape mode (unite, intersect, exclude, minus_front; the parts stay editable), release one back into its objects, or expand one into plain paths (the panel's Expand button). Runs the panel's commands through a temporary Action
convert_live_shapesTurn paths that resemble rectangles, rounded rectangles, ellipses, polygons or lines into live shapes (Object > Shape > Convert to Shape), or turn live shapes back into ordinary paths (Object > Shape > Expand Shape). Live-shape properties (width, height, angle, corner radii in the Transform panel) cannot be read or set by a script; move_items, rotate_items and scale_items transform live shapes
convert_text_to_outlinesConvert text frames to outlined artwork (Type > Create Outlines). The text is no longer editable
convert_to_artboardsTurn the chosen objects (usually rectangles) into artboards of the same bounds (Object > Artboards > Convert to Artboards)
copy_artboardDuplicate an artboard with the artwork on it (Artboards panel menu > Duplicate Artboards), copy it into another open document, or cut it (move it and its artwork, removing the original). Artwork belongs to an artboard when its centre lies on it
copy_itemsCopy paths and other items into another open document (onto its active layer or a named layer, at the same document coordinates), or onto the clipboard for pasting into other applications (Edit > Copy)
create_action_setCreate an action set with new actions (Actions panel > Create New Set, Create New Action) from steps recorded in saved .aia files: each new action lists the steps it copies, as a whole saved action or one numbered step of it, and can switch each step or its dialog on or off. Then load the set, save it as an .aia file, or both. Steps cannot be recorded here; record them in Illustrator and save the set first
create_arcDraw an arc (Arc tool, with the Arc Segment Tool Options): the arc spans a width x height box (Length X-Axis, Length Y-Axis) from the start corner to the opposite corner. baseAlong x leaves the start point horizontally, y vertically. slope: positive is convex, negative concave, 0 a straight line. closed adds the corner the arc curves around (a pie-slice shape). With fill, the arc is filled (Fill Arc)
create_data_setsCreate data sets from records: for each record, set the bound items to its values (text for text variables, an image file for image variables, true/false for visibility) and capture a data set with its name. A record that names an existing data set updates it. Variables a record leaves out keep their previous value
create_documentCreate a document. The colour mode cannot be changed later without converting every colour, so choose CMYK for print and RGB for screen
create_document_from_presetCreate a document from a new-document preset (File > New), overriding its name, size, orientation, units, colour mode, raster effects resolution, preview mode, transparency grid and bleed. list_document_presets names the presets
create_ellipseDraw an ellipse inside the box whose top-left corner is x, y
create_gradientAdd a linear or radial gradient swatch from colour stops, and optionally apply it as the fill of items
create_layerCreate a layer at the top of the stack, or as a sublayer of parentLayer, with the Layer Options settings (Layers panel menu > New Layer, New Layer with Dialog)
create_lineDraw a straight line (Line Segment tool) from x1, y1 to x2, y2, or from x1, y1 with a length and angle as in the tool's options dialog. With fill, the line is filled (Fill Line)
create_pathDraw a path through points. Each point is [x, y], or an object with x, y and optional curve handles in and out ([x, y] in the same coordinates)
create_path_textPut text on or inside a path (Type on a Path tool, or the Area Type tool on a shape). kind path runs the text along the path; area flows it inside the shape. The path becomes the text's path, as with the tools; give keepPath to leave the original in place
create_patternMake a pattern swatch from the targets (Object > Pattern > Make), optionally naming it. The artwork stays where it is. By default Illustrator leaves pattern editing mode at once; with keepEditing it stays there so tile type, size, spacing and overlap can be set by hand in the Pattern Options panel, and edit_pattern with mode exit finishes
create_polar_gridDraw a polar grid (Polar Grid tool, with its options dialog) as a group: concentric ellipses and radial lines, each with skew. compoundPath makes every other ring a compound path (Create Compound Path From Ellipses). With fill, the ellipses are filled (Fill Grid)
create_polygonDraw a regular polygon centred on centerX, centerY
create_rectangleDraw a rectangle, optionally with rounded corners. x and y are the top-left corner in points from the artboard's top-left
create_rectangular_gridDraw a rectangular grid (Rectangular Grid tool, with its options dialog) as a group: horizontal and vertical dividers with skew, and the outside edges as one rectangle (Use Outside Rectangle As Frame) or as four lines. With fill, the frame is filled (Fill Grid)
create_spiralDraw a spiral (Spiral tool, with its dialog's options): radius from the centre to the outermost point, decay (each quarter-turn segment's radius as a percentage of the one before), segments (quarter turns; four make one wind) and style (direction). It starts at its outermost point, to the right of the centre, and winds inward
create_starDraw a star centred on centerX, centerY
create_swatchAdd a swatch: a process colour, a global process colour (editing it updates every object that uses it), or a spot colour (an ink such as a Pantone colour or a varnish plate). Optionally put it in a swatch group
create_swatch_groupCreate a swatch group (a colour group in the Swatches panel), optionally moving existing swatches into it
create_symbolMake a symbol from artwork (Symbols panel > New Symbol) with a registration point. By default the artwork is replaced by an instance of the new symbol, as the panel does. Several items become one symbol, or one symbol each with each: true
create_textAdd text. Point text grows with its content from x, y (the left end of the first baseline); area text flows inside a box of width and height whose top-left is x, y
create_text_styleCreate a character or paragraph style (New Character Style, New Paragraph Style), optionally from the formatting of existing text (its first character and paragraph), then with the given attributes, and optionally apply it to that text
create_trim_marksDraw trim marks around the targets' bounds (Object > Create Trim Marks). The marks are editable artwork
create_variableCreate a variable (Variables panel > New Variable) and optionally bind it to items: text to text frames, image to placed images, graph to graphs, visibility to any object (Make Object Dynamic, Make Visibility Dynamic)
crop_imageCrop linked or embedded images to a rectangle, discarding the pixels outside it (Object > Crop Image). The result is an embedded image at the given resolution; a linked file is embedded, as Crop Image does
delete_artboardDelete an artboard. Its artwork stays on the canvas. The last artboard cannot be deleted
delete_data_setsDelete data sets by name, or all of them. Variables and the artwork stay as displayed
delete_empty_artboardsDelete every artboard that no artwork touches (Artboards panel menu > Delete Empty Artboards). Hidden and locked artwork and guides count as artwork. One artboard always remains
delete_graphic_stylesDelete graphic styles from the document (Graphic Styles panel menu > Delete Graphic Style). Items keep their appearance; only the saved style goes
delete_itemsDelete items from the document (Illustrator's Edit > Undo can restore them)
delete_layerDelete a layer and everything on it
delete_swatchesDelete swatches by name
delete_symbolsDelete symbols by name, or every unused symbol (Symbols panel > Select All Unused, then Delete Symbol). A symbol with instances is refused unless instances says to delete them or turn them into ordinary artwork (expand)
delete_text_stylesDelete character or paragraph styles by name (Delete Character Style, Delete Paragraph Style). Text using them keeps its look as local formatting; the [Normal] styles cannot be deleted
delete_variablesDelete variables by name. Their bound items stay in the document, no longer dynamic
deselect_allDeselect everything in the active document
distort_itemsDistort items by moving the corners of their bounding box, as the Free Transform tool's Free Distort and Perspective Distort do. free: give corners as [x, y] fractions of the box (0,0 top-left, 1,1 bottom-right). perspective: one edge narrows (positive amount) or widens (negative) symmetrically. Applied as the Free Distort effect; expand (default) makes it plain artwork
distribute_itemsDistribute items evenly (Object > Distribute, Align panel): by left, horizontal centre or right edges, top, vertical centre or bottom edges, or equal horizontal or vertical space between them. The outermost items stay put. With spacing (hspace, vspace), items are set exactly that many points apart, starting from the key object (or the first item), which does not move
duplicate_itemsDuplicate items, offsetting each copy by dx, dy points. With count > 1, each copy is offset from the previous one (step and repeat)
duplicate_swatchesDuplicate swatches (Swatches panel > Duplicate Swatch). Each copy is named "<name> copy" (then "copy 2" and so on) and goes in the same swatch group; a global or spot swatch becomes a new global or spot colour and a gradient swatch a new gradient. Pattern swatches cannot be duplicated by script
duplicate_symbolCopy a symbol under a new name (Symbols panel > Duplicate Symbol). The copy is registered at its centre
edit_anchor_pointsEdit anchor points of paths: remove them without splitting the path (Object > Path > Remove Anchor Points), convert them to corner points (handles retracted) or smooth points (handles aligned; retracted handles are pulled out a third of the way to the neighbouring anchors), or set one point's anchor and handles. Choose points by index (from get_path_info) on one path, or the anchors selected with the Direct Selection tool
edit_clipping_maskSelect the clipping path of clip groups (Object > Clipping Mask > Edit Mask) or their contents (Edit Contents), so other tools can change them; returns their ids
edit_colorsRecolour the targets with an Edit > Edit Colors command: convert to CMYK, RGB or grayscale, invert, or blend the fills between the frontmost and backmost (or leftmost and rightmost, topmost and bottommost) objects
edit_envelopeWork with envelopes (Object > Envelope Distort): release (separate the contents from the envelope shape), expand (apply the distortion as plain artwork), or edit_contents (switch between editing the contents and the envelope; run again to switch back)
edit_patternEnter pattern editing mode for the pattern that fills the target (Object > Pattern > Edit Pattern), or leave it (mode exit, like Done). In the mode, the tile options are set by hand in the Pattern Options panel and other tools act on the pattern's artwork
edit_slicesRun an Object > Slice command: make (object-based slices from the targets), release, create_from_selection, create_from_guides, duplicate, combine, clip_to_artboard (toggle), delete_all; or View > Show / Hide Slices (toggle_visibility) and Lock Slices (toggle_lock). create_region makes a slice over a rectangle, as dragging the Slice Tool does
edit_swatchChange a swatch the way Swatch Options does (Swatches panel > Swatch Options): rename it, change its colour, or change its type between process, global process and spot. Changing a global or spot swatch's colour updates every object that uses it. Making a process swatch global or spot recreates it as a new global or spot colour; making a global or spot swatch process deletes the global colour, and objects that used it keep its colour as a process colour
edit_swatch_groupChange a colour group (swatch group): rename it, move swatches into it, delete some of its swatches, or delete the group with its swatches, as the Swatches panel and Recolor Artwork's colour groups do
edit_text_styleChange a character or paragraph style (Character Style Options, Paragraph Style Options): rename it and set attributes. reset first removes every attribute the style holds, so it keeps only the ones given
execute_illustrator_codeRun your own ExtendScript in Illustrator and return its last expression. It runs unrestricted: it can change or delete anything and read or write files. Prefer the specific tools
execute_menu_commandRun an Illustrator menu command by its executeMenuCommand name (e.g. "outline" = Type > Create Outlines, "expandStyle" = Object > Expand Appearance). Illustrator reports nothing back and silently ignores names it does not know, so the result is the selection and document state afterwards. Commands that open a dialog wait for the user. Use find_menu_commands to look names up
expand_blendExpand blends so every step becomes an ordinary object (Object > Blend > Expand)
expand_live_paintExpand Live Paint groups into ordinary filled and stroked paths that keep their painted look (Object > Live Paint > Expand)
expand_objects_on_pathTurn objects attached to a path into independent objects in place (Object > Objects on Path > Expand; Illustrator 2025 or later). Attaching and the Objects on Path options open a dialog or need clicks, so they are not offered
expand_traceExpand image tracings into ordinary paths that can be edited like any artwork (Object > Image Trace > Expand). The tracing and its source image are replaced
export_autocadExport as an AutoCAD drawing, DWG or DXF by the file extension (File > Export > Export As > AutoCAD): AutoCAD version, scale and units, line weights, colours, raster format, appearance or editability, selected art only, outlined text
export_data_setsExport every data set (or the ones named) as PNG or JPEG files: each data set is displayed in turn and its artboards exported as <data set>-<artboard>.<ext>. The data set on display before is shown again afterwards
export_for_screensExport artboards, collected assets (list_assets) and the full document in several formats and scales in one pass (File > Export > Export for Screens, and the Asset Export panel). Scales apply to PNG and JPEG
export_jpegExport artboards as JPEG files, one per artboard, at a quality and scale (100 = 72 ppi, 300 = 216 ppi). Transparent areas are filled with the matte colour
export_pdfSave a PDF copy of the document with a PDF preset (e.g. "[High Quality Print]", "[PDF/X-4:2008]"), optionally overriding its compatibility, PDF/X standard, image compression and downsampling, font subsetting, bleed, printer's marks, colour conversion, output intent, transparency flattening, passwords and permissions, thumbnails and Acrobat layers (Save Adobe PDF dialog). The document must be saved first; it is reopened afterwards so you keep working on the .ai file
export_perspective_presetsSave every perspective grid preset to a file (Edit > Perspective Grid Presets > Export), to load with import_perspective_presets
export_pngExport artboards as PNG files, one per artboard, at a scale (100 = 72 ppi, 300 = 216 ppi)
export_psdExport as a Photoshop file (File > Export > Export As > Photoshop): colour model, resolution, layers, editable text, maximum editability, anti-aliasing, ICC profile, one file per artboard
export_selectionExport the selected artwork on its own (File > Export Selection), as a PNG at 100% or as an Illustrator file. For other formats and scales, collect_assets and export_for_screens with the asset ids
export_selection_as_aiWrite only the selected artwork (or the items given) to a new Illustrator file, leaving the document as it is (File > Export Selection as AI)
export_svgSave artboards as SVG files with the full SVG Options (File > Save As > SVG): profile, font subsetting, encoding, editing data, slices, XMP, variables, text options, SVGZ compression. For lean SVG for the web use export_web_svg
export_textSave text to a plain text file (.txt, UTF-8): the stories of the given frames, or every story in the document, separated by blank lines (File > Export > Text Format)
export_tiffExport as TIFF (File > Export > Export As > TIFF): colour model, resolution, anti-aliasing, LZW compression, byte order, ICC profile, one file per artboard
export_variablesSave the document's variables and data sets as a variable library (Variables panel > Save Variable Library), an XML file
export_web_imageExport artboards as GIF or PNG-8 with a reduced colour table, one per artboard (File > Export > Save for Web (Legacy)): colours, reduction, dither, transparency, matte, web snap, lossy GIF, interlacing, scale, HTML
export_web_svgExport artboards as lean SVG for the web (File > Export > Export As > SVG): styling, object IDs, decimals, minify, responsive
fill_placeholder_textFill text frames with placeholder text (Type > Fill With Placeholder Text). Area text is filled to the edge of its frame; point and path text get one sentence. Existing text is replaced
find_menu_commandsSearch the known executeMenuCommand names by command name or menu path
find_replace_textFind text across the document or in text frames, and optionally replace it (Edit > Find and Replace, Find Next), with Match Case and Whole Word. Without replace, matches are listed, and selectMatch selects one of them in the text, like Find Next. Formatting is kept; threaded frames are searched as one story
find_unused_swatchesList the swatches no artwork uses, as Swatches panel > Select All Unused finds them (a script cannot select swatches in the panel; delete them with delete_swatches). Scans the fills and strokes of every path and text character and the gradients in use; a process swatch counts as used when an object has its exact colour values. Colours used only inside symbols, brushes, graphic styles or effects are not seen, so check the list before deleting
fit_artboard_to_artworkResize an artboard to the bounds of the given artwork (Object > Artboards > Fit to Selected Art), or without target, to all the artwork on it (Fit to Artwork Bounds)
flatten_transparencyFlatten transparency in the targets permanently (Object > Flatten Transparency), without the dialog: transparent artwork becomes opaque vector and raster pieces. Resolution is the one setting offered; the dialog's other settings stay at the values published scripts record for this command
get_appearanceRead the fill, stroke, opacity and blending mode of items
get_boundsReport items' geometric bounds (paths only), visible bounds (with strokes and effects) and control bounds (with handles), in points from an artboard's top-left corner
get_color_settingsList the colour settings files Illustrator offers (Edit > Color Settings), the default for this locale, and the active document's colour mode and assigned profile (Edit > Assign Profile shows it)
get_default_fill_strokeRead the document's default fill and stroke, the attributes new objects get, and whether the Fill or the Stroke box is in front in the toolbar's Fill and Stroke controls
get_document_infoDescribe the active document: name, file, colour mode, artboards with their sizes, layers, item counts and selection
get_document_setupReport the active document's Document Setup values the object model exposes: units, colour mode, large canvas, Show Images in Outline Mode, and each artboard's ruler origin
get_file_infoRead the active document's metadata (File > File Info): title, authors, description, keywords, copyright, and the dates and creator tool, from its XMP packet
get_item_dataRead items' tags (name-value labels scripts attach to artwork) and notes (Attributes panel > Note). Without target, lists every item in the document that has a tag or a note
get_path_infoDescribe paths (inside groups and compound paths too): closed, fill rule, guide, anchor count, area and length, and optionally every anchor point with its handles and type, in artboard coordinates
get_preferencesDescription is built at runtime.
get_selectionDescribe the current selection
get_text_attributesRead the formatting of text frames or the selected text: character and paragraph attributes (of the first character and paragraph of the range), tab stops, the character and paragraph styles in use, and the frame's area type options and threads
get_trace_infoReport image tracings: their paths, anchors and colours (Image Trace panel info) and every option they use
go_to_linkSelect a linked or embedded image and centre the view on it (Links panel > Go To Link)
group_itemsGroup items. The group is created where the frontmost item is
helpList the tools by area, or describe one tool's parameters
hide_itemsHide artwork (Object > Hide): scope selection hides the targets, above hides the artwork stacked above them, others hides everything except them. show_all shows it again. The result lists what was hidden
illustrator_statusCheck that Illustrator is reachable: platform, how the server addresses Illustrator, whether it is running, its version and open documents. Use this first when a call fails to connect
import_brushesBring brushes from a brush library file (an .ai file, such as one saved with save_brush_library or a library from Illustrator's Presets folder) into the active document's Brushes panel, as Window > Brush Libraries > Other Library does. Give names to import only those; brushes the document already has are skipped
import_csv_dataImport a CSV data source into data sets (Variables panel > Import, data merge): the first row names the fields, prefixed @ for an image variable (absolute file paths) and # for a visibility variable (true or false); other fields are text. Fields are separated by commas or tabs. Each row becomes a data set; a row that names an existing data set updates it. Each field must match a variable already bound to artwork (create_variable); graph (%) fields are not supported. Use show_data_set to preview and run_batch or export_data_sets for the output
import_perspective_presetsLoad perspective grid presets from a file exported by export_perspective_presets or Edit > Perspective Grid Presets > Export. Give preset to load only that one, and select to make it the document's grid
import_textBring a plain text file (.txt, UTF-8) into the document: into a new point or area text frame at x, y, or replacing the text of one frame (File > Place for text). Line breaks become paragraphs
import_variablesLoad a variable library (Variables panel > Load Variable Library): an XML file of variables and data sets, e.g. one saved by export_variables or another Illustrator document. Variables bind to objects by name
insert_special_characterInsert a special, white space or break character into text frames (Type > Insert Special Character, Insert White Space Character, Insert Break Character): symbols, dashes, quotation marks, spaces and forced line break. At the start, at the end, or at a character index
intertwineObject > Intertwine (Illustrator 2023 or later). make puts overlapping objects in an Intertwine group; choosing which overlaps swap front and back is done by the user afterwards, by clicking or drawing around each overlap. release returns the objects to their original stacking
list_actionsList the action sets and their actions in the Actions panel (Window > Actions), as Illustrator stores them in its preferences. A set loaded or changed since Illustrator last stored its preferences may not show yet. With filePath, describe an .aia file instead: its set, actions and numbered steps (with each step's on/off and dialog settings), without loading it
list_artboardsList artboards with their position and size in points. x and y are measured from artboard 0's top-left corner
list_assetsList the assets collected for export in the document (Window > Asset Export): id, name and the file name they export as. Pass the ids to export_for_screens to export them
list_brushesList the brushes in the active document's Brushes panel, by name. Illustrator's scripting does not report a brush's type (calligraphic, scatter, art, pattern, bristle) or its settings
list_document_fontsList the fonts used in the document's text, with how many characters use each and whether each is missing (not installed or activated)
list_document_presetsList the new-document presets (Print, Web, Mobile, Film & Video, Art & Illustration and saved custom presets) with their size, units and colour mode, for create_document_from_preset
list_documentsList the open documents and which one is active
list_fontsList installed fonts whose name, family or style contains the query
list_graphic_stylesList the graphic styles in the document (Graphic Styles panel), in panel order
list_graphsList the document's graphs (made with the graph tools) with their position and the graph variable each is bound to, plus the data sets that can redraw them
list_imagesList linked and embedded images and other non-native art (the Links panel and Links information): file name, path, format, size on disk, modified date, missing links, effective resolution, colour space and bits per channel of embedded images, embedded files, non-native art and plug-in art such as tracings
list_itemsList items with their id, name, type, layer and position. Filter by layer, artboard or type. Ids are what other tools take in target.ids
list_layersList top-level layers and their sublayers, with visibility, lock state, Layer Options and item counts
list_meshesList the document's gradient mesh objects with their id, position and size. Mesh points and colours are not reachable by script
list_print_settingsList what printing can use: printers with their capabilities, PPD files, print presets, transparency flattener presets and PDF presets
list_slicesList object-based slices (items made into slices with Object > Slice > Make) and sliced layers, with each slice's URL. User slices drawn with the Slice Tool are not listed
list_storiesList the document's stories (the text in one frame, or flowing through threaded frames), with their frames, length and the start of their text, plus how many legacy text objects need updating
list_swatchesList the document's swatches with their kind (process, global, spot), colour values and swatch group
list_symbolsList the document's symbols (Symbols panel) with how many instances each has; unused symbols are marked (Symbols panel > Select All Unused)
list_text_stylesList the document's character and paragraph styles (Character Styles and Paragraph Styles panels), optionally with their attributes
list_tracing_presetsList the Image Trace presets Illustrator has: the built-in ones (in brackets) and any saved (Image Trace panel > Preset, Edit > Tracing Presets)
list_variablesList the document's variables with their kind and the items bound to them, its data sets, the data set on display, and whether variables are locked
load_actionsLoad an action set from an .aia file (Actions panel > Load Actions, or Replace Actions with replace: "all"). Before loading, the file can be edited: load the set under a new name, rename actions (Action Options), remove actions or steps, switch steps on or off (Toggle Item On/Off) and their dialogs (Toggle Dialog On/Off). Step numbers come from list_actions with filePath. The file on disk is not changed; saveAs writes the edited set to a new .aia file. Function keys and colours are not changed
load_color_settingsApply a colour settings file (Edit > Color Settings > Settings): a name from get_color_settings, such as "North America General Purpose 2", or an absolute path to a .csf file. This changes Illustrator's colour management for every document
load_swatch_libraryCopy swatches from a swatch library into the document, the way dragging them from a library panel does: a built-in library (Window > Swatch Libraries, e.g. "Gradients > Wood", including the gradient presets) or a library .ai file. Keeps the library's swatch groups. Colour books (.acb) and pattern swatches cannot be copied by script
load_text_stylesLoad character styles, paragraph styles or both from another Illustrator file (Load Character Styles, Load Paragraph Styles, Load All Styles). Styles with the same name are replaced
lock_itemsLock artwork so it cannot be selected or edited (Object > Lock): scope selection locks the targets, above locks the artwork stacked above them, others locks everything except them. The result lists what was locked
make_blendBlend two or more objects (Object > Blend > Make), optionally setting the number of steps and the orientation. The objects blend in stacking order. For text designs, outlineText converts text to outlines first
make_clipping_maskClip items with a path: the clipping path shows only the artwork inside it. clipPath must be a path id; it is moved above the other items
make_compound_pathCombine paths into one compound path (Object > Compound Path > Make): overlapping areas become holes
make_envelopeDistort items into the shape of a top object (Object > Envelope Distort > Make with Top Object). Give the contents as target and the shape as shapeId; the shape is brought to the front of the first item's layer or group, so keep them together. Without shapeId, the frontmost target is the shape. Make with Warp and Make with Mesh open dialogs and are not offered
make_live_paintMake a Live Paint group from paths (Object > Live Paint > Make), or add paths to an existing Live Paint group (Object > Live Paint > Merge) when into is given. Painting its faces and edges stays interactive (select_tool "Planar Paintbucket Tool")
make_repeatRepeat the targets as a live radial, grid or mirror repeat (Object > Repeat > Radial, Grid, Mirror; Illustrator 2023 or later), optionally setting its options: instances, radius and reverseOverlap for radial; horizontalSpacing, verticalSpacing, gridType, flipRows and flipColumns for grid; axisAngle for mirror
make_trap_strokeTrap paths by hand (spread traps): give each filled path an overprinting stroke in its own fill colour, so the colour spreads into the inks around it by half the stroke weight. Paths with gradient, pattern or no fill are skipped
merge_swatchesMerge swatches into the first one named (Swatches panel > Merge Swatches): every fill, stroke, text colour and gradient stop that uses one of the other swatches is repainted with the first, then the others are deleted. A global or spot swatch is matched wherever it is used, keeping each use's tint; a process swatch is matched by colour value. Works on colour swatches, not gradients or patterns
move_itemsMove items by dx, dy points, or place their top-left corner at x, y on an artboard
move_items_to_layerMove items to the top of another layer, or of the active layer when layer is omitted (Object > Arrange > Send to Current Layer)
new_from_templateStart an untitled document from an Illustrator template (.ait) file (File > New from Template). The template itself is not changed
nudge_itemsMove items as the arrow keys do: by the Keyboard Increment preference, times steps, times 10 with large (Shift + arrow)
open_brush_libraryOpen one of the brush libraries Illustrator ships as a panel (Window > Brush Libraries), for the user to pick brushes from. Clicking a brush there adds it to the document; to bring brushes in by script, use import_brushes with the library's file
open_documentOpen a file as a new document (File > Open): Illustrator (.ai, .ait template), PDF, EPS, SVG/SVGZ, AutoCAD DWG/DXF, images (PSD, TIFF, PNG, JPEG, JPEG 2000, GIF, BMP, WebP, AVIF, HEIC, TGA, PCX, PXR), CGM, CorelDRAW, EMF/WMF, and Word, RTF or text (opened with Illustrator's last-used import options). PDF and AutoCAD import options are set for this call only
open_document_with_optionsOpen a file with Illustrator's open options: update legacy text and gradient meshes, convert a pre-CS4 document's crop area, print tiles or artwork bounds to artboards, keep it off the recent files list, or open it as a swatch, brush, symbol or graphic style library. Use open_document for a plain open
open_graphic_stylesShow the Graphic Styles panel (Window > Graphic Styles), or open one of Illustrator's built-in graphic style libraries as a panel (Window > Graphic Style Libraries). A style used from a library is added to the document. Like every Window menu command, this hides a panel that is already showing at the front
open_swatch_libraryOpen a built-in swatch library panel (Window > Swatch Libraries), e.g. "Gradients > Water", "Color Books > PANTONE+ Solid Coated". The panel only shows the library; load_swatch_library copies its swatches into the document
open_symbol_libraryOpen a symbol library as a panel: one of Illustrator's built-in libraries (Window > Symbol Libraries), or a library file such as one saved with save_symbol_library (Window > Symbol Libraries > Other Library). Drag or copy its symbols into the document from the panel
organize_layersRun a Layers panel menu command: merge layers (Merge Selected), flatten every layer into one (Flatten Artwork), collect items or layers in a new layer (Collect in New Layer), give each object of a layer or group its own sublayer (Release to Layers (Sequence) or (Build)), or reverse the stacking order of layers (Reverse Order)
overprint_blackSet or clear overprint on black, as Edit > Edit Colors > Overprint Black does, by script: fills and strokes whose black is at least the given percentage. By default only pure black (no cyan, magenta or yellow) and gray qualify; includeCmyBlacks adds rich blacks and includeSpotBlacks adds spot colours whose CMYK equivalent holds that much black. Overprint matters in separated CMYK output
paste_artworkPaste the clipboard directly in front of or behind the selected objects, on their layer (Edit > Paste in Front, Paste in Back). With target, those items are copied first, so the pasted copies sit exactly over or under them
path_operationRun an Object > Path command on the targets: outline_stroke (stroke to filled shape), join (connect open paths' end points), add_anchor_points (one between each pair), reverse_direction, divide_objects_below (cut everything beneath with the target's shape), release_compound_path, make_pixel_perfect, expand_appearance
pathfinderCombine shapes as the Pathfinder panel does: unite, minus front, intersect, exclude, divide, trim, merge, crop, outline, minus back, and the Effect > Pathfinder colour operations hard mix, soft mix and trap. The items are grouped and the Pathfinder effect applied; with expand (default) the result becomes plain paths, otherwise it stays a live effect on the group
place_imagePlace an image or other file at x, y on an artboard, linked or embedded (File > Place): PNG, JPEG, JPEG 2000, TIFF, PSD, GIF, BMP, WebP, AVIF, HEIC, TGA, PCX, PXR, PDF (a chosen page), EPS and DCS, SVG/SVGZ, AI, AutoCAD DWG/DXF, CGM, CorelDRAW, EMF/WMF. Give width to scale it proportionally. Text files go through place_text_file
place_imagesPlace several files at once (File > Place with multiple files), laid out in a grid from x, y on an artboard, linked or embedded. Photoshop files take the Photoshop Import Options: convert layers to objects (needs embed), import hidden layers, slices, image maps and a layer comp; Illustrator's own options are restored afterwards
place_symbolPlace instances of a symbol (Symbols panel > Place Symbol Instance). x and y are the instance's top-left corner; without them it goes in the centre of the artboard
place_text_filePlace the contents of a plain-text (.txt) file as type at x, y on an artboard (File > Place with a text file): point text, or area text when width and height are given
play_actionPlay an action from a loaded set (Actions panel > Play Current Selection). The action acts on the active document and its selection; give target to select items first. Steps run without their dialogs; recorded values are used. The result is the document and selection afterwards
print_documentPrint the active document to a printer, or to a PostScript file with outputFile. A print preset is the base; options are grouped like the Print dialog's pages and override it
rasterize_itemsRasterize the targets into an embedded image (Object > Rasterize), with the dialog's options: colour model, resolution, background, anti-aliasing, clipping mask, space added around the object, spot colours, text to outlines and layer attributes. By default the targets become one image; clipBounds limits it to a rectangle. The vector originals are removed
rearrange_artboardsArrange all artboards in a grid, row or column
reflect_itemsFlip items horizontally or vertically around their centre
release_blendRelease blends back into their original objects (Object > Blend > Release)
release_clipping_maskRelease clip groups (Object > Clipping Mask > Release): the contents show in full again and the clipping path stays as a path with no fill or stroke
release_live_paintRelease Live Paint groups back into plain paths with a thin black stroke and no fill (Object > Live Paint > Release)
release_perspectiveTake objects out of perspective, keeping how they look (Object > Perspective > Release with Perspective)
release_repeatRelease radial, grid or mirror repeats back into their source artwork (Object > Repeat > Release)
release_traceRelease image tracings: discard the traced result and keep the original image (Object > Image Trace > Release)
relink_imagesRelink or replace linked files (Links panel > Relink). Give target and filePath to point the targets at another file; with allInstances, every placement of the same file is relinked too. Give folder to replace missing links at once: each missing link is relinked to the file with the same name in that folder
remove_assetsRemove assets from the Asset Export panel. The artwork stays in the document
remove_from_clipping_maskTake items out of their clip group, keeping their position: they are placed just in front of the group and are no longer clipped. The clipping path itself cannot be removed this way (use release_clipping_mask)
rename_assetRename an asset in the Asset Export panel. The name is the exported file name
rename_graphic_styleRename a graphic style (Graphic Styles panel menu > Graphic Style Options)
rename_patternRename a pattern swatch (the Name field of the Pattern Options panel)
rename_symbolRename a symbol (Symbols panel > Symbol Options: name). A symbol's type, registration point and 9-slice guides cannot be changed by script
reorder_artboardsChange the artboards' numbering order, which sets their page order when exporting (Artboards panel: move up, move down, or drag). Positions and artwork do not change
repeat_pathfinderApply the last Pathfinder panel operation again to the targets (Repeat Pathfinder, Cmd/Ctrl+4). It repeats what was last done in the panel, not the pathfinder tool here; if nothing was, nothing happens
repeat_transformRepeat the last transformation on the targets (Object > Transform > Transform Again), count times. It repeats what Illustrator recorded as the last move, scale, rotate, reflect, shear or Transform Each, usually one made by hand or in a Transform dialog; transformations made by other tools may not be recorded
replace_blend_spineMake a blend follow a path (Object > Blend > Replace Spine): the path becomes the blend's spine and the steps are spread along it
replace_fontReplace fonts in the document's text (Type > Find/Replace Font, and the replace step of Type > Resolve Missing Fonts): every run in the from fonts, or in every missing font, gets the to font. Other formatting is kept. Activating fonts from Adobe Fonts is not done
replace_symbolMake symbol instances use another symbol (Symbols panel > Replace Symbol)
reset_bounding_boxSquare the bounding box of rotated items back to the page (Object > Transform > Reset Bounding Box). The artwork does not move
reset_fill_strokeGive paths, compound paths and groups (every path inside) a white fill and a black 1 pt solid stroke, as the toolbar's Default Fill and Stroke button does for selected objects
resize_itemsSet items' width and height in points (Transform panel W and H) around a reference point. With constrainProportions and one dimension, the other follows. With relative, the values are added to the current size (e.g. width: 10 makes it 10 pt wider). For percentages use scale_items
reverse_blendReverse a blend's spine (the order along the path) or its stacking order (front to back)
revert_documentDiscard the active document's unsaved changes by reloading its saved file (File > Revert). Undo history is lost
rotate_itemsRotate items by an angle in degrees (counter-clockwise, as in Illustrator)
run_batchPlay an action on every file in a folder, or on every data set of the active document, and save the results (does what Actions panel > Batch does, by script). Folder: each .ai, .pdf, .eps or .svg file is opened, the action played, and the file left open (destination none), saved in place and closed (save_and_close), or saved as an .ai copy in destinationFolder and closed (folder; subfolders are recreated). Files already open are skipped with an error. Data sets: each data set is displayed, the action played, and with destination folder the document saved as an .ai file named by fileNaming; the…
run_image_commandRun an Object menu image command on the targets: remove_background (Object > Remove Background, Illustrator 30.4 and later: keeps the subject of an image), make_mockup (Object > Mockup > Make / Preview: wrap the vector art onto the image beneath it; select both), release_mockup (Object > Mockup > Release). These features may download components or contact Adobe services on first use, so a call can take a while
run_script_fileRun a script file (File > Scripts > Other Script, or a script installed in File > Scripts given by its path): .jsx, .js or .jsxbin. Like execute_illustrator_code it runs unrestricted: it can change or delete anything and read or write files. The coordinate system is left as the script expects; Illustrator's own alerts are suppressed while it runs. A script that opens its own dialog waits for the user. Returns the script's last value as text. The file must be inside the allowed folders (add Illustrator's Scripts folder to ILLUSTRATOR_ALLOWED_DIRS to run installed scripts)
run_type_commandRun a Type or Edit menu command that opens no dialog: convert_bullets_to_text (Type > Bullets and Numbering > Convert to text, on the targets), show_hidden_characters (Type > Show Hidden Characters) or auto_spell_check (Edit > Spelling > Auto Spell Check). The last two switch the setting on or off each time; Illustrator does not report which
save_brush_librarySave the active document's brushes as a brush library file (Brushes panel menu > Save Brush Library). Open it later with import_brushes or Window > Brush Libraries > Other Library
save_documentSave the active document. With filePath, save it as an Illustrator (.ai) or Illustrator EPS (.eps) file there; the document then refers to that file. Can also save each artboard to its own file
save_document_copyWrite a copy of the active document's saved file to another path; the document stays open and keeps referring to its own file (File > Save a Copy). The document must be saved with no unsaved changes, and the copy keeps its format
save_graphic_style_librarySave the document's graphic styles as a graphic style library file (Graphic Styles panel menu > Save Graphic Style Library), an .ai file other documents can open as a library
save_swatch_librarySave the document's swatches as a swatch library (Swatches panel > Save Swatch Library as AI): an Illustrator file holding just the swatches and their groups, which Window > Swatch Libraries > Other Library opens. Save it in Illustrator's user Swatches folder to see it under User Defined. With ifExists: "merge", adds the swatches to an existing library, replacing ones with the same name. Pattern swatches cannot be copied by script
save_symbol_librarySave the document's symbols, or some of them, as a symbol library file (Symbols panel > Save Symbol Library). Open it later with open_symbol_library; files saved in Illustrator's Symbols presets folder also appear under Window > Symbol Libraries > User Defined
scale_itemsScale items by a percentage. Give scale for uniform scaling, or scaleX and scaleY
select_allSelect all unlocked, visible objects in the document, or on one artboard (Select > All, All on Active Artboard)
select_by_typeSelect every object of one kind (Select > Object): all_text, point_type, area_type, clipping_masks, stray_points (lone anchor points), brush_strokes, bristle_brush_strokes, not_pixel_aligned, flash_dynamic_text, flash_input_text. Two kinds start from a selection, given as target: same_layers (everything on the targets' layers) and direction_handles (the handles of the targets' paths). The selection is replaced
select_itemsSelect items (replacing the current selection). Menu commands act on the selection
select_layer_artworkSelect all the artwork on layers, as clicking a layer's selection column or target circle in the Layers panel does. Appearance tools then act on it. Artwork on hidden or locked layers cannot be selected
select_nested_itemsSelect inside groups, as the Direct Selection and Group Selection tools do: children (the items directly inside each target group), all (every object inside the target groups at any depth, not the groups themselves) or parent (the group that holds each target, one level up). The selection is replaced
select_sameSelect every object that shares an attribute with the targets (Select > Same), e.g. all objects with the same fill colour. The targets are selected first and set the attribute
select_similar_itemsSelect every path whose stroke weight or opacity is within a tolerance of one reference path, optionally with the same blending mode (the Magic Wand's Stroke Weight, Opacity and Blending Mode options). Every option given must match. Unlocked, visible paths and compound paths on every layer are compared; guides and clipping paths are skipped. Colour tolerance is not offered: select_same matches fill or stroke colour exactly
select_symbol_instancesSelect every instance of the given symbols (Symbols panel > Select All Instances)
select_toolSwitch Illustrator to a tool, ready for the user to draw with it. Name it as Illustrator does, e.g. "Pen Tool", "Shape Builder Tool", "Width Tool", "Column Graph Tool", "Mesh Tool", "Blend Tool"
set_active_artboardMake an artboard active (the one Illustrator's artboard commands and menu commands act on)
set_active_layerMake a layer active: new artwork goes on it when a tool is not given a layer
set_artboardRename, move or resize an artboard, or switch it between portrait and landscape (Object > Artboards > Switch Orientation). Position is measured from artboard 0's top-left corner. scaleArtwork scales and moves the artwork on it with it
set_artboard_displayArtboard display options (Artboard Options: Show Center Mark, Show Cross Hairs, Show Video Safe Areas, Video Ruler Pixel Aspect Ratio, ruler origin), the artboard border and name display (application preferences, for every document), and the View menu's Show / Hide Artboards and Show / Hide Video Rulers. With no options, reports the current settings
set_asian_typeSet Japanese and other Asian composition on text frames: the Adobe Asian (Latin and CJK) composer, single-line or every-line; kinsoku shori and mojikumi sets (by the names the document defines) and the kinsoku order; and the character options tsume, aki, tate-chu-yoko and warichu
set_blend_optionsSet the number of steps and the orientation of existing blends (Object > Blend > Blend Options)
set_character_attributesSet Character panel, OpenType panel and CJK character attributes on text frames, a character range of each, or the selected text: font and style, size, leading, kerning, tracking, scales, baseline shift, rotation, language, caps, superscript and subscript, underline, strikethrough, fill and stroke, no break, overprint, ligatures, alternates, swashes, figure styles, fractions, ordinals, tsume, aki, tate-chu-yoko and warichu
set_color_viewColour display in the document window: choose the soft-proof condition (View > Proof Setup: working CMYK, legacy Mac RGB, sRGB, monitor RGB, or the protanopia and deuteranopia colour-blindness simulations), toggle View > Proof Colors, and toggle View > Show/Hide Gradient Annotator. Illustrator does not report whether a toggle is on, so each toggle flips the current state
set_default_fill_strokeSet the document's default fill and stroke, the attributes new objects get. reset gives a white fill and a black 1 pt solid stroke, as the toolbar's Default Fill and Stroke button does; other options apply after it
set_document_setupChange document settings: colour mode (File > Document Color Mode, converting every colour), an artboard's ruler origin, conversion to a large canvas, or switch to the Artboard tool (Document Setup > Edit Artboards). Units, bleed and the other Document Setup options can only be set in the dialog; create_document_from_preset sets units and bleed for a new document
set_file_infoSet the active document's metadata (File > File Info). Each field given replaces the stored value; an empty value removes it. Or pass xmp to replace the whole XMP packet. Saved with the document
set_fillSet the fill of paths, compound paths, groups (every path inside) and text frames. "none" removes the fill; a gradient swatch name fills with the gradient
set_isolation_modeEnter or leave isolation mode: enter isolates one group or object (Isolate Selected Object) so the rest of the artwork is dimmed and cannot be edited; exit leaves it (Exit Isolation Mode)
set_item_dataSet items' tags (name-value labels scripts attach to artwork; not shown in Illustrator's panels) and note (Attributes panel > Note). tags maps names to text values; null removes a tag. Tag names use letters, digits and underscores
set_item_urlSet the URL of items (Attributes panel URL, used for image maps, and the URL of object-based slices). An empty url clears it
set_layer_propertiesRename a layer, show or hide it, lock it, set whether it prints, its opacity, Layer Options (colour, preview, dim images), knockout group, or move it in the stack
set_opacitySet the opacity and blending mode of items
set_other_layersHide, lock or outline every top-level layer except the ones holding the chosen layers or items (Object > Hide > Other Layers, Object > Lock > Other Layers, Layers panel menu > Outline Others), or show, unlock or preview them again
set_overprintSet Overprint Fill and Overprint Stroke (Attributes panel) on paths, compound paths, groups and text frames, so the colour prints over the inks beneath instead of knocking them out
set_paragraph_attributesSet Paragraph panel attributes on text frames, some of their paragraphs, or the selected text: alignment, indents, space before and after, hyphenation (the Hyphenation dialog), word and letter spacing, glyph scaling and auto leading (the Justification dialog), single-word justification, composer, Roman hanging punctuation, kashida width, and the CJK options (kinsoku, mojikumi, burasagari, bunri-kinshi, kurikaeshi moji shori, leading type)
set_path_optionsSet path attributes on paths (inside groups and compound paths too): even-odd or non-zero fill rule, closed or open, make or release guides, and align to pixel grid (Transform panel)
set_path_textChange type on a path (Type > Type on a Path and Type on a Path Options): apply an effect (rainbow, skew, 3D ribbon, stair step, gravity), slide the text along the path with start and end, set spacing, flip the text to the other side of the path, or update legacy path type. Align to Path (baseline, ascender, descender, centre) is only in the dialog and is not offered
set_perspective_gridSet up the perspective grid (View > Perspective Grid): choose a preset (one_point, two_point, three_point or a saved preset's name), show or hide the grid, set the active plane, move the plane to match an object, and flip the grid's toggles (Show Rulers, Snap to Grid, Lock Grid, Lock Station Point). While the grid is shown with an active plane, create_* tools draw in perspective on that plane. Viewing angle, horizon and gridline settings come only from a preset: use import_perspective_presets for presets saved in Illustrator
set_preferencesChange Illustrator preferences. They persist, as if set in the Preferences dialog. Pass an object of name: value
set_raster_effect_settingsSet the document raster effects settings (Effect > Document Raster Effects Settings): the colour model, resolution, background, anti-aliasing, clipping mask, added space and spot colours that raster effects such as drop shadows, glows, blurs and Rasterize use. Give only what should change; called with nothing, it reports the current settings
set_repeat_optionsChange the options of radial, grid or mirror repeats (Object > Repeat > Options): instances, radius and reverseOverlap for radial; horizontalSpacing, verticalSpacing, gridType, flipRows and flipColumns for grid; axisAngle for mirror. With no options, report the current ones
set_right_to_left_textSet up Arabic and Hebrew text on text frames: paragraph direction, the Middle Eastern composer, digit set, kashidas and character direction
set_strokeSet the stroke of paths, compound paths and groups: colour, weight, caps, joins and dashes. A gradient swatch name as the colour puts the gradient on the stroke
set_tab_stopsSet the tab stops of text frames, some of their paragraphs, or the selected text (Tabs panel): left, centre, right and decimal tabs, leaders, the decimal character, and Repeat Tab. Replaces the existing stops; an empty list clears them
set_text_contentsReplace the text of text frames. Character formatting of the first character is kept
set_text_frame_optionsSet text frame options: convert between point and area type (Type > Convert To Area Type / Point Type), resize the type area without scaling the text, Area Type Options (rows, columns, gutters, inset spacing, first baseline, text flow), Optical Margin Alignment and anti-aliasing
set_text_orientationMake text frames horizontal or vertical (Type > Type Orientation)
set_text_styleSet font, size, colour, justification, leading or tracking on whole text frames
set_text_wrapMake or release text wrap on objects (Object > Text Wrap > Make, Release, Text Wrap Options): text in frames below the object flows around it, at an offset, or inside it with invert. The object must be above the text
set_trace_optionsChange the options of existing image tracings, which re-traces them (Image Trace panel): load a preset and set any option, then optionally save the result as a preset (Image Trace panel > Save as New Preset). Returns the new counts
set_transform_optionsSet Transform panel options: the reference point, Scale Corners, and whether the bounding box shows (View > Show / Hide Bounding Box). Returns the current options, including Scale Strokes & Effects, Transform Patterns and Use Preview Bounds (set those with set_preferences); call with no options just to read them
set_transparency_groupSet Knockout Group and Isolate Blending (Transparency panel) on groups, other items or layers. Knockout stops the objects inside from showing through each other; Isolate Blending keeps blending modes inside the group or layer
set_variables_lockedLock or unlock the document's variables (Variables panel > Lock Variables). Locked variables cannot be created, bound or deleted
shear_itemsShear (slant) items by an angle along a horizontal, vertical or angled axis (Object > Transform > Shear). On a horizontal axis a positive angle leans the item's vertical edges to the right
show_allShow every hidden object in the document (Object > Show All). Illustrator selects the objects it shows; the result lists them
show_data_setDisplay a data set: its values replace the bound items' current content (Variables panel > previous/next data set)
simplify_pathReduce the anchor points of paths while keeping their shape (Object > Path > Simplify), with Simplify's curve precision, corner angle threshold and straight lines options. Runs Illustrator's own Simplify through a temporary Action, with its dialog closed
split_into_gridSplit each target into a grid of rectangles (Object > Path > Split Into Grid): rows and columns with gutters, taking the target's fill, stroke and opacity. The target is replaced. Optionally add guides along the grid
split_pathCut a path at one of its anchor points (like the Scissors tool). An open path becomes two paths; a closed path opens there. Point indexes come from get_path_info
swap_fill_strokeSwap the fill and stroke colours of paths, compound paths and groups (every path inside), as the toolbar's Swap Fill and Stroke button does. A missing fill becomes a missing stroke and the other way round
switch_documentBring an open document to the front by name or by its list_documents index, or move to the next or previous document or document group (Window menu document navigation)
thread_text_framesThread text between area or path type frames (Type > Threaded Text): link flows text through the frames in the order given; release takes the frames out of their threads, keeping the rest linked (Release Selection); remove breaks every thread through them, leaving the text in place (Remove Threading)
toggle_corner_widgetShow or hide the corner widget, the on-canvas control for rounding live-shape corners (View > Show / Hide Corner Widget). It flips the current state; Illustrator does not report which state results
toggle_global_editStart or stop Global Edit (Select > Start/Stop Global Edit): with an object selected it starts, and edits to that object then apply to every similar object; run it again to stop. Illustrator does not report whether Global Edit is on; the result shows the selection afterwards. The matching options (appearance, size, artboards) are set in the Properties panel
toggle_prepress_viewToggle a prepress view or panel: overprint_preview (View > Overprint Preview), print_tiling (View > Show/Hide Print Tiling), separations_preview, flattener_preview or attributes (Window menu panels). Illustrator does not report whether Overprint Preview or a panel is showing, so those simply switch; print_tiling can be set with show
toggle_view_optionShow or hide the transparency grid (View > Show / Hide Transparency Grid) or Live Paint gap highlighting (View > Show / Hide Live Paint Gaps). Each call switches the option; Illustrator does not report which state it is in
trace_imageTrace placed or embedded images into vector artwork (Object > Image Trace > Make, or Make and Expand with expand: true), with a preset and any Image Trace panel option: mode, palette, colours, grays, threshold, paths, corners, noise, method, fills, strokes, stroke width, snap curves to lines, ignore white and view. Returns each tracing with its path, anchor and colour counts
transform_eachScale, move, rotate and flip each item around its own reference point (Object > Transform > Transform Each). With random, each item gets a random amount between none and the value given. With copy, transformed copies are made and the originals stay
transform_patternMove, scale, rotate, reflect or shear the pattern inside objects without changing the objects (like the Transform options with Transform Objects off and Transform Patterns on, or dragging with the ` key held). Steps apply in that order: reflect, scale, rotate, shear, move
ungroup_itemsUngroup groups, leaving their contents in place. With allLevels, ungroup every level of nested groups at once (Object > Ungroup All, Illustrator 29.3 or later)
unload_actionsRemove action sets or actions from the Actions panel (Delete Selection), or every set (Clear Actions). Removed sets are gone from the panel; save them first if they are not in a file. all: true removes the sets list_actions reports
unlock_allUnlock every locked object in the document (Object > Unlock All). Illustrator selects the unlocked objects; the result lists them
update_legacy_textUpdate legacy text (from Illustrator 10 or earlier) so it can be edited (Type > Legacy Text > Update All Legacy Text, or Update Selected Legacy Text for the targets). Line breaks and spacing can shift as the text is recomposed
update_linksUpdate linked files that changed on disk (Links panel > Update Link), or embed them (Embed Image). Acts on the targets, or every linked file with all: true. Embedding replaces each placed item with native art, so its id changes
use_clipboardCut or copy items, or paste the clipboard (Edit > Cut, Copy, Paste, Paste in Place, Paste on All Artboards, Paste without Formatting). Pasted items are selected and returned
view_artboardShow an artboard in the document window: make it active and fit it in the window, fit all artboards, or zoom on its centre (View > Fit Artboard in Window, Fit All in Window)
Signals
- Stars
- 26
- Forks
- 10
- Open issues
- 22
- Contributors
- 1
- Last commit (this folder)
- Oct 20, 2026 (8 days ago)
- Last release
- Oct 15, 2026 (13 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.zachshallbetter/adobe-mcp-illustrator- Version
- 0.9.0
- Auth
- No auth
- Packages
- npm adobe-mcp-illustrator
- License
- MIT
- Repository
- github.com/zachshallbetter/adobe-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from zachshallbetter
- 0.661score
After Effects MCP Server
zachshallbetter
Drive Adobe After Effects from any MCP client: compositions, layers, animation and rendering.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
Photoshop MCP Server
zachshallbetter
Drive Adobe Photoshop from any MCP client: layers, selections, adjustments, type and export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
InDesign MCP Server
zachshallbetter
Drive Adobe InDesign from any MCP client: 135+ tools for layout, styles, books and PDF export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.661score
Premiere Pro MCP Server
zachshallbetter
Drive Adobe Premiere Pro from any MCP client: projects, sequences, timeline edits, effects, export.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.658score
Adobe MCP Suite
zachshallbetter
Local MCP coordinator for cross-app Adobe workflows.
ConnectorAFreshness: ALocal★ 26Claude Code +5 - 0.513score
github-projects
zachshallbetter
Govern GitHub Issues, ProjectsV2, pull requests, claims, evidence, and status transitions through ACP.
SkillBFreshness: BClaude Code +9
Cite this page
Illustrator MCP Server. Agent Mart. https://agentmart.dev/connectors/zachshallbetter-adobe-mcp-illustrator (last updated 2026-10-24)