Reminders

Reminders fire in one of two modes: relative (N minutes before an anchor like a flight, hotel, or event) or absolute (a specific datetime). For relative reminders, always discover valid anchors via list_reminder_anchors before calling add_reminder — don't guess anchor ids.

Delivery defaults to email; pass "channel": "sms" for SMS (requires a phone number on the user's account).

Anchors

list_reminder_anchors

Returns the set of valid anchors for a trip — trip start, events with resolvable times, flights, hotels, transports. Each anchor has { kind, id, label, anchorAt }. Call this before creating a relative reminder.

{ "tripId": "trp_..." }

Reading

list_reminders

Returns reminders for a trip ordered by triggerAt ascending. Each includes id, triggerAt, offsetMinutes, anchorKind, anchorId, channel, and status (pending, sent, or dismissed).

{ "tripId": "trp_..." }

Writing

add_reminder — relative mode

Fires N minutes before an anchor. A positive offsetMinutes fires before the anchor; a negative value fires after.

{
  "tripId": "trp_...",
  "title": "Check in for flight",
  "mode": "relative",
  "offsetMinutes": 1440,
  "anchor": { "kind": "flight", "id": "flt_..." },
  "channel": "email"
}

For kind: "trip" the id is omitted — the anchor is the trip's start date.

add_reminder — absolute mode

Fires at a specific ISO 8601 datetime.

{
  "tripId": "trp_...",
  "title": "Renew ESTA",
  "mode": "absolute",
  "triggerAt": "2026-05-01T09:00:00Z",
  "channel": "email"
}

update_reminder

Full replacement of the reminder's schedule. Provide title, mode, and the fields required for that mode (offsetMinutes + anchor for relative; triggerAt for absolute).

{
  "reminderId": "rmd_...",
  "title": "Check in 2h before flight",
  "mode": "relative",
  "offsetMinutes": 120,
  "anchor": { "kind": "flight", "id": "flt_..." }
}

dismiss_reminder

Marks the reminder as dismissed so it won't fire. Keeps the row for audit.

{ "reminderId": "rmd_..." }

delete_reminder

Permanently deletes a reminder.

{ "reminderId": "rmd_..." }