batch_actions
Execute multiple macOS actions (clicks, typing, app launches) in one batch. Stops on first error. Returns a screenshot by default.
Instructions
PREFERRED: Always use this tool instead of calling individual action tools (click_at, type_text, press_key, launch_app, etc.) one at a time. Combine multiple steps into a single batch call — this is dramatically faster. Returns a single screenshot by default (disable with return_screenshot=false). Only use individual tools when you need to read the result of one action before deciding the next. Stops on first error. Max 20 actions per call.
Example — open Notes and write text (1 call instead of 6): [{ "action": "launch_app", "name": "Notes" }, { "action": "key", "key": "n", "modifiers": ["command"] }, { "action": "set_clipboard", "text": "Hello\nWorld" }, { "action": "key", "key": "v", "modifiers": ["command"] }]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actions | Yes | Array of actions to execute sequentially | |
| delay_between_ms | No | Delay between actions in ms (default 100) | |
| return_screenshot | No | Return one screenshot at the end (default true). Set false for faster/smaller responses. |