Configure TimerMCP
timer_configConfigure TimerMCP settings: announcement style, latency handicaps, runaway timer limit, and cloud sync. Read current config by calling without arguments.
Instructions
Read or update TimerMCP settings. Call with no args to read.
Settings:
announcer ('hype'|'zen'|'sergeant'|'sports'|'minimal'): Default announcement personality. Styles: hype, zen, sergeant, sports, minimal.
start_offset_ms / stop_offset_ms (number ≥ 0): Latency handicaps subtracted from every elapsed. Leave at 0 for most uses — symmetric pipeline latency already cancels because both timestamps are taken server-side on a monotonic clock. Set these only to bias out a known asymmetry (e.g. user reckons their "stop" reaches the server ~300ms slower than their "start").
max_hours (number): A running timer older than this is flagged runaway (default 4).
sync_token (string): Enables cloud auto-sync. The user gets this token from their dashboard at https://timermcp.vercel.app/app ("set my timer sync token to …"). Every finished run then syncs automatically. Pass an empty string to disable sync.
sync_url (string): Override the cloud endpoint (default https://timermcp.vercel.app).
Returns: { config: {announcer, start_offset_ms, stop_offset_ms, max_hours, sync_enabled, sync_token_tail?, sync_url?}, dashboard_url, data_dir }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sync_url | No | Cloud sync endpoint override | |
| announcer | No | Default announcement personality | |
| max_hours | No | Hours before a running timer is flagged runaway | |
| sync_token | No | Cloud sync token from the TimerMCP dashboard; empty string disables sync | |
| stop_offset_ms | No | Default stop-side handicap in ms | |
| start_offset_ms | No | Default start-side handicap in ms |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| config | Yes | ||
| data_dir | Yes | ||
| dashboard_url | Yes |