| name | time-keep |
| description | Use the time-keep MCP for reliable time context - IANA timezone ops, date arithmetic, calendar queries, business days, offline holiday lookups (2000-2030), and local timers. |
time-keep
Open Cowork’s only agent time engine. Backed by the bundled
time-keep native MCP (stdio).
Always call the real tools (function calling). OpenCode exposes them as
time-keep_<tool> — for example time-keep_current_time. Prefer these over
shell date, bash, or inventing times from model memory.
If you do not see time-keep_* tools (for example time-keep_current_time)
in your tool list, say so briefly and stop — do not invent CLI fallbacks
or pretend to call MCP. The desktop app should list time-keep when the
bundled MCP is connected (status bar MCP count).
Tool Map
All tools are exposed as time-keep_<tool> (OpenCode MCP naming):
| Need | Tool id |
|---|
| Current time | time-keep_current_time |
| List timezones | time-keep_list_timezones |
| Timezone details + DST | time-keep_timezone_info |
| Convert between timezones | time-keep_convert_timezone |
| Calendar fields (weekday, ISO week, etc.) | time-keep_calendar_query |
| Date add/subtract | time-keep_date_arithmetic |
| Date difference | time-keep_date_diff |
| Parse/format dates | time-keep_date_format |
| Holiday check or list | time-keep_holidays |
| Business day counts | time-keep_business_days |
| Set a timer | time-keep_timer_set |
| Read a timer | time-keep_timer_get |
| List timers by tag | time-keep_timer_list |
| Delete a timer | time-keep_timer_delete |
| Check overdue timers | time-keep_timer_check |
Guardrails
- Default timezone is UTC — always be explicit when it matters.
- Holiday data is offline, bounded to 2000–2030. Mention this when used.
- Timers persist in local SQLite; setting or deleting a timer asks for the
user's approval by design.
- Use IANA timezone names. Do not silently accept bare city names.
- Do not hide DST ambiguity — report ambiguous local datetimes as invalid.
- MCP tool failures surface as
isError: true — inspect the JSON error
before retrying.
Output Standard
Include: tool used, input date, resolved timezone, date range, whether
holiday data was used, and any error details.
Sub-topics
- Calendar & dates:
calendar_query, convert_timezone,
date_arithmetic, date_diff, date_format, holidays,
business_days. See references/calendar.md.
- Timers:
timer_set, timer_get, timer_list, timer_check,
timer_delete. See references/timers.md.
- CLI transport: last-resort only if MCP tools are missing.
See references/cli.md.
- Output contracts: JSON (default), table, CSV, and error envelopes.
See references/output-contracts.md.
