press_button
Simulate pressing a Garmin device bezel button—select, back, up, down, or menu—with short clicks or long holds, then return the updated watch screen for verification.
Instructions
Press a physical bezel button on the active Garmin device (e.g. 'select', 'back', 'up', 'down', 'menu'). Supports short clicks or long-press holds, and returns the updated watch screen.
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": {
"button": "<button>"
},
"name": "press_button"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hold | No | Perform a long press (hold) instead of short click | |
| button | Yes | Button identifier or alias (e.g. 'select', 'enter', 'start', 'back', 'esc', 'up', 'down', 'menu') | |
| expect | No | Assert the outcome: 'change' fails with E_NO_CHANGE when the screen is identical, 'noop' fails with E_UNEXPECTED_CHANGE when it differs | |
| method | No | Input synthesis method: 'mouse' clicks bezel hitbox center; 'key' sends macOS virtual keycode (default: 'mouse') | |
| hold_ms | No | Custom hold duration in milliseconds (defaults to 1200ms for hold, 80ms for short click) | |
| wait_ms | No | Milliseconds to wait after button press before capturing screenshot (default: 350) | |
| device_id | No | Device profile ID to resolve button coordinates from (defaults to active device) | |
| settle_ms | No | Milliseconds to wait before the after-capture used for the receipt (default: 400) | |
| capture_after | No | Whether to capture and return a screenshot after the button press (default: true) |