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"] }]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"actions": "<actions>"
},
"name": "batch_actions"
}
}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. |