Get information about the current OmniGraffle document: name, canvases, current canvas, and graphics count

Create a new OmniGraffle document, optionally from a built-in template

Save the current OmniGraffle document

List all available OmniGraffle templates

Create a new canvas in the current document

List all canvases in the current document with their graphics count

Switch to a different canvas by index (0-based)

Set the size of the current canvas

Create a shape on the current canvas with position, size, text, and styling

Create multiple shapes at once. Returns an array of created shape IDs. More efficient than calling create_shape multiple times.

Update properties of an existing graphic by ID

Delete one or more graphics by ID

List all graphics on the current canvas with their properties (ID, type, position, size, text, style)

Remove all graphics from the current canvas

Connect two shapes with a line/arrow. The line automatically routes between the shapes.

Connect multiple pairs of shapes at once with full styling. Supports auto-routing: when line_type is 'auto', picks straight for vertical/horizontal neighbors, orthogonal for cross-column, curved for feedback loops.

Create a standalone line between two points (not attached to shapes)

Set magnet (connection) points on a shape. Magnets define where lines can attach.

Apply automatic layout to the current canvas. OmniGraffle will arrange all connected shapes.

Create a new layer on the current canvas

List all layers on the current canvas

Group multiple graphics together

Ungroup a group graphic

Align multiple graphics relative to each other

Export the current canvas to an image file (PNG, PDF, or SVG)

Execute arbitrary Omni Automation JavaScript inside OmniGraffle. The code runs in OmniGraffle's JS context with access to the full Omni Automation API. Use for operations not covered by other tools.

Execute JXA (JavaScript for Automation) code via osascript. Use for operations that need the macOS scripting bridge, such as file system access combined with OmniGraffle control.

Execute AppleScript code. Use for operations that work better with AppleScript syntax.

Search IconPark icons by keyword. Returns matching icon names that can be used with insert_icon. 2658 icons available across 38 categories.

List all IconPark icon categories with their icon counts

Get icon suggestions for a scientific diagram context. Provide a description and get relevant icon names.

Insert an IconPark icon onto the OmniGraffle canvas as an image. The icon is rendered as a PNG with optional color customization.

Create a labeled shape with an icon inside — perfect for scientific diagram nodes. The icon is placed above the text label within the shape.

List available scientific color palettes (Nature, Science, Cell, Lancet, Minimal, Vibrant)

Get a specific color palette with all color values ready to use

List available scientific diagram templates with their node structures and suggested palettes/icons

Get full details of a diagram template including nodes, suggested icons, and palette