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