reminder_set
Schedule a reminder. One-time reminders fire at a specific datetime. Recurring reminders fire on a schedule (daily, weekly, every N days, or every N minutes). Optionally scope to a thread or target another agent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | No | Time of day HH:MM for daily/weekly/every_n_days (e.g. '09:00'). Required for daily/weekly/every_n_days. | |
| reason | Yes | What this reminder is for (you'll see this when it fires) | |
| agent_id | No | Agent ID (required when calling from MCP; ignored in agentic mode). | |
| datetime | No | ISO datetime for one_time. Required for one_time. Either with an offset ('2026-04-01T09:00:00+03:00') or without one plus `timezone` ('2026-04-01T09:00:00' + timezone 'Europe/Moscow'): a datetime with no offset is read in `timezone`, and in UTC only when that is omitted. | |
| timezone | No | IANA timezone (e.g. 'Europe/Moscow'). Defaults to UTC. | |
| thread_id | No | Optional thread ID to scope the reminder to. Omit for workspace-level reminders. | |
| days_of_week | No | Days for weekly: 0=Mon, 1=Tue, 2=Wed, 3=Thu, 4=Fri, 5=Sat, 6=Sun. Required for weekly. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| interval_days | No | For every_n_days: fire every N days (min 2). | |
| schedule_type | Yes | one_time = fires once at datetime. daily = fires daily at time. weekly = fires on specific days_of_week at time. every_n_days = fires every N days at time. interval = fires every N minutes. | |
| interval_minutes | No | For interval: fire every N minutes (5-1440). | |
| target_agent_slug | No | Optional: activate a different staff member instead of yourself when the reminder fires. |