Retrieves macOS system information including version, hardware model, processor, and memory

Gets battery percentage and charging status (MacBooks only, returns isDesktop: true for desktop Macs)

Lists connected displays with name, resolution, and main display indicator

Gets the current system volume as a percentage (0-100)

Sets the system volume to a specified percentage (0-100)

Checks if system audio is currently muted

Mutes or unmutes system audio

Reads current clipboard content (text, image paths, or file paths)

Sets clipboard to specified text content

Displays a macOS notification with title, optional message, subtitle, and sound

Lists all running GUI applications with name, bundle ID, and process ID

Launches an application by name (e.g., "Safari", "Finder")

Gracefully quits an application by name

Brings an application to the foreground

Opens Finder and selects the specified file or folder

Gets paths of files currently selected in Finder

Gets the path of the frontmost Finder window

Lists all visible windows with app name, title, position, and size. Optional: filter by app name

Brings a specific window to the front by app name and optional window index

Moves a window to specified x, y coordinates

Resizes a window to specified width and height

Minimizes a window to the Dock

Performs a mouse click at specified coordinates. Supports left, right, middle buttons and modifier keys

Performs a double-click at specified coordinates

Moves the mouse cursor to specified coordinates without clicking

Performs a drag operation from start to end coordinates

Types text at the current cursor position with optional delay between characters

Presses a key by name (Enter, Tab, Escape, F1-F12, Arrow keys, etc.)

Presses a focused-app or menu key combination with modifiers; OS-global hotkeys such as Electron globalShortcut are not guaranteed

Scrolls in a specified direction (up, down, left, right) at optional coordinates

Scrolls until a UI element with specified text or role becomes visible

Captures a screenshot of the screen, display, window, or region. Auto-resized to max 1600px and compressed to max 1.8MB for API compatibility (both file and base64 output). Use rawFile: true to save at full resolution, or maxDimension/maxFileSize: 0 to disable processing

Retrieves the UI element tree for an application. Use maxDepth to limit tree depth

Clicks a UI element by path (e.g., "window1/button1")

Gets the value of a UI element (text field content, checkbox state, etc.)

Sets the value of an editable UI element (text fields, sliders, etc.)

Sets keyboard focus to a UI element

Gets the menu hierarchy for an application

Clicks a menu item by path (e.g., "File > Save", "Edit > Copy")

Gets the enabled/checked state of a menu item

Lists visible status bar (menu bar extras) items

Clicks a status bar item to open its menu

Clicks a menu item within a status bar menu

Gets the complete menu bar hierarchy for a process by PID