TimerHome for ChatGPT and Claude
What it does
Use TimerHome inside ChatGPT or Claude. Ask for a timer in your own words and get a live countdown card.
Connect
Connection URL: https://timerhome.com/api/mcp
No sign-in or API key is needed.
Tools
set_timer Set a timer
Starts a countdown timer from 1 second up to 24 hours with an optional label. Takes the duration as text such as "10 min" or "1h 30m", or as hours, minutes and seconds, and the user time zone. Returns the duration, the clock time when it ends and a link to the same timer on timerhome.com.
Read-only
Inputs
duration | string? | Duration in the user words, for example "10 min", "1h 30m", "90s" or "1:30". |
hours | number? | Hours, for example 1. |
minutes | number? | Minutes, for example 10. Fractions such as 1.5 are allowed. |
seconds | number? | Seconds, for example 30. |
label | string? | What the timer is for, for example "Tea" or "Plank". |
timezone | string? | IANA time zone of the user, for example "Europe/Madrid", to show clock times in the reply. |
locale | string? | Language for the reply (BCP 47). |
Returns
text: string
countdown_to_date Countdown to a date
Counts the days, hours and minutes left until a date and time or until the next holiday such as Christmas, New Year or Ramadan. Takes a date with an optional time and time zone, or a holiday id, and an optional title. Returns the time left, the exact moment and a shareable countdown link with an embeddable widget.
Read-only
Inputs
date | string? | Target date as YYYY-MM-DD, for example 2026-12-25. |
time | string? | Target time as HH:mm in 24-hour format, 00:00 by default. |
holiday | new-year | chinese-new-year | valentines-day | ramadan | st-patricks-day | eid-al-fitr | easter | mothers-day | summer | independence-day | halloween | diwali | thanksgiving | black-friday | christmas? | A holiday to count down to; its next date is used and date is ignored. |
title | string? | Name of the event, for example "Our wedding". |
timezone | string? | IANA time zone of the user, for example "Europe/Madrid", to show clock times in the reply. |
locale | string? | Language for the reply (BCP 47). |
Returns
text: string
pomodoro_timer Pomodoro timer
Starts a Pomodoro session: focus blocks with short breaks and a long break after every few rounds, 25/5/15 minutes by default. Takes the focus and break lengths, the number of rounds, an optional task list and the user time zone. Returns the schedule with clock times and a link to the Pomodoro timer on timerhome.com.
Read-only
Inputs
focus_minutes | integer? | Length of each focus block in minutes, 25 by default. |
short_break_minutes | integer? | Short break in minutes, 5 by default. |
long_break_minutes | integer? | Long break in minutes, 15 by default. |
rounds | integer? | Number of focus blocks, 4 by default. |
long_break_every | integer? | A long break comes after this many focus blocks, 4 by default. |
tasks | array? | Tasks to work on during the session, one per item. |
timezone | string? | IANA time zone of the user, for example "Europe/Madrid", to show clock times in the reply. |
locale | string? | Language for the reply (BCP 47). |
Returns
text: string
Try asking
- Set a timer for 10 minutes
- Pasta timer, 9 minutes
- Remind me in 1 hour 30 minutes
- Start a 90 second timer
Interactive view
The timer appears in a small card that counts down and links to the full-screen timer.
Your data
The app does not store your questions. The duration you send is used only to set the timer.
- Your timer presets, last timer, settings (sound, theme, view) and pomodoro statistics — Only in your browser (localStorage)
- A countdown or clock you choose to share: its title, date, time zone and style, without any account — Our server
- The domain of a website that shows a TimerHome widget, sent by the widget once a day — Our server
- Anonymous usage events (page views, timer starts, which tool was used) — Sent to PostHog