Skip to content

System Actions

Native macOS automation capabilities.

App Control

system.open_app

Launch an application.

InputTypeDescription
nameStringApp name (e.g., "Safari")

system.quit_app

Close an application.

InputTypeDescription
nameStringApp name

system.focus_app

Bring app to foreground.

InputTypeDescription
nameStringApp name

Notifications

system.notification

Show macOS notification.

InputTypeDescription
titleStringNotification title
bodyStringNotification body
soundBooleanPlay sound

Audio

system.speak

Text-to-speech output.

InputTypeDescription
textStringText to speak
voiceString (optional)Voice name

system.volume

Set system volume.

InputTypeDescription
levelNumber0-100

Clipboard

system.clipboard_read

Get clipboard contents.

OutputTypeDescription
textStringClipboard text

system.clipboard_write

Set clipboard contents.

InputTypeDescription
textStringText to copy

Do Not Disturb

system.dnd_enable

Enable Do Not Disturb mode.

system.dnd_disable

Disable Do Not Disturb mode.

Screenshots

system.screenshot

Capture screen.

InputTypeDescription
regionString"full", "window", or "selection"
OutputTypeDescription
imageImageCaptured screenshot

File System

system.open_file

Open a file with default app.

InputTypeDescription
pathStringFile path

system.reveal_in_finder

Show file in Finder.

InputTypeDescription
pathStringFile or folder path