Show focus timer
show_focus_timerUse this when the user wants a timer now: a pomodoro timer (25/5, 50/10, pomodoro timer for studying), a countdown timer ("10-minute timer"), or an interval timer (work/rest repeats, e.g. 45 s on, 15 s off). Returns the full phase plan (focus blocks, short and long breaks, totals) and shows a live timer with a progress ring, play, pause, skip and reset controls, and an optional chime. With a clock time for the first block and a time zone (IANA name such as Europe/Warsaw, a city, or an abbreviation such as EST), each phase also gets wall-clock times that stay correct across daylight-saving changes. Limits: up to 24 hours and 96 rounds; no phone notifications, alarms when the chat is closed, or music. Do not use for reminders about future appointments, questions about how long something takes (e.g. boiling an egg), or unit conversions.
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": {
"mode": "<mode>"
},
"name": "show_focus_timer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional date of start_time as YYYY-MM-DD, e.g. 2026-10-02. Defaults to today in time_zone. | |
| mode | Yes | Timer type: "pomodoro" (focus blocks with short and long breaks, e.g. 25/5), "countdown" (one countdown, e.g. 10 minutes), or "interval" (repeating work/rest, e.g. 45 s on, 15 s off). | |
| label | No | What the user is focusing on, shown on the timer, e.g. "Biology chapter 3" or "Presentation practice". | |
| sound | No | Play a short chime when each phase ends. Default true. | |
| rounds | No | Number of focus blocks, e.g. 4 (pomodoro default). Ignored for countdown. | |
| time_zone | No | Optional time zone for start_time: an IANA name (e.g. Europe/Warsaw, America/New_York), a city (e.g. Warsaw), or an abbreviation (e.g. EST, CET). Makes the clock times correct across daylight-saving changes. | |
| start_time | No | Optional clock time the session starts, as HH:MM (24-hour) or 9:30 am, e.g. 14:00. When given, every phase gets wall-clock start and end times. | |
| auto_advance | No | Start the next phase automatically when one ends. Default true; false pauses after each phase until the user presses Start. | |
| work_minutes | No | Length of each focus or work block in minutes, e.g. 25 for a classic pomodoro or 50 for 50/10. For countdown this is the countdown length, e.g. 10. Decimals allowed: 0.5 = 30 seconds. Default 25 for pomodoro. | |
| long_break_every | No | Take the long break after this many blocks, e.g. 4 (pomodoro default). 0 = never. | |
| long_break_minutes | No | Longer break taken after every long_break_every blocks, in minutes, e.g. 15 (pomodoro default). | |
| short_break_minutes | No | Break between blocks in minutes, e.g. 5 (pomodoro default) or 10 for 50/10. For interval mode this is the rest, e.g. 0.25 = 15 seconds. 0 = no break. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| label | Yes | ||
| notes | Yes | ||
| phases | Yes | ||
| totals | Yes | ||
| summary | Yes | ||
| schedule | Yes | ||
| settings | Yes | ||
| downloads | Yes | ||
| phase_count | No | ||
| spare_minutes | Yes | ||
| phases_truncated | No |