reminder
reminder.cancel
reminder.cancel
Effects: write
Cancel an active reminder by its trigger ID.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
agent_id | integer | no | Agent ID (required when calling from MCP; ignored in agentic mode). |
trigger_id | integer | yes | ID of the reminder to cancel |
reminder.list
reminder.list
Effects: read
List your active reminders (both one-time and recurring).
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
agent_id | integer | no | Agent ID (required when calling from MCP; ignored in agentic mode). |
include_fired | boolean | no | Include already-fired one-time reminders (default false) |
limit | integer | no | Max results (default 20) |
thread_id | integer | no | Filter by thread |
reminder.set
reminder.set
Effects: write
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.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
agent_id | integer | no | Agent ID (required when calling from MCP; ignored in agentic mode). |
datetime | string | no | ISO datetime for one_time (e.g. '2026-04-01T09:00:00+03:00'). Required for one_time. |
days_of_week | array | no | Days for weekly: 0=Mon, 1=Tue, 2=Wed, 3=Thu, 4=Fri, 5=Sat, 6=Sun. Required for weekly. |
interval_days | integer | no | For every_n_days: fire every N days (min 2). |
interval_minutes | integer | no | For interval: fire every N minutes (5-1440). |
reason | string | yes | What this reminder is for (you'll see this when it fires) |
schedule_type | string | 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. (one of one_time, daily, weekly, every_n_days, interval) |
target_agent_slug | string | no | Optional: activate a different staff member instead of yourself when the reminder fires. |
thread_id | integer | no | Optional thread ID to scope the reminder to. Omit for workspace-level reminders. |
time | string | no | Time of day HH:MM for daily/weekly/every_n_days (e.g. '09:00'). Required for daily/weekly/every_n_days. |
timezone | string | no | IANA timezone (e.g. 'Europe/Moscow'). Defaults to UTC. |