macos_mouse_drag
Press, drag to an absolute target, and release on macOS to control sliders, selections, resizing, drawing, and drag-and-drop, with optional waypoints, held modifiers, and pauses.
Instructions
macOS only. Press the mouse button at the current cursor position, drag to an absolute target in logical coordinates, and release. Use for sliders, selections, resizing, drawing and drag-and-drop, optionally through waypoints, with modifiers held, and with pauses after the press and before the release. Position the cursor at the drag start first (macos_mouse_move). Inside a browser tab, tab_drag targets page elements exactly instead. Requires Accessibility permission.
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": {
"x": "<x>",
"y": "<y>"
},
"name": "macos_mouse_drag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Absolute target X in logical points (top-left origin). | |
| y | Yes | Absolute target Y in logical points (top-left origin). | |
| path | No | Points the pointer passes through, in order, between the start and the target, without stopping: draw a stroke or go around an obstacle. A pause on the way (hovering over a folder until it springs open) is not supported; dwellMs pauses on the final target, then releases. Defaults to a straight line. | |
| button | No | Which button to hold during the drag. Defaults to left. | |
| holdMs | No | Milliseconds the button stays down before the pointer moves. Defaults to 10; give 300 to 600 for a list or app that starts a drag only after a long press. | |
| dwellMs | No | Milliseconds the pointer rests on the target before the release. Defaults to 10; give 300 or more for a target that reacts to hovering (a sortable list making room, a folder springing open). | |
| modifiers | No | Modifiers held for the whole drag: Shift (constrain), Alt/Option (duplicate in design tools), Meta/Command, Control. They go down before the button and come up after it. |