---
name: reminders
description: Schedule future reminders (subscriptions, renewals, one-off dates) via Calendar or email — finish the install, do not ask the user to import files.
---

# Reminders

Finish the outcome. Do not dump “download this .ics and import it” steps.

## Preference order

1. **Email MCP** — if Integrations → Email is On and the user asked for email, send (or schedule via a job that emails) using MCP.
2. **`schedule_reminder`** — for absolute dates (days/weeks/months out). Installs Apple Calendar events with alerts and writes an `.ics` artifact. Report what was installed.
3. **`job_create`** — only for recurring interval / heartbeat prompts (seconds–days), not calendar dates months away.

## How to call

Single:

```json
{"title":"Apple TV+ renews in 1 week","when":"2026-10-12","notes":"Renews Oct 19, 2026","alert_minutes_before":0}
```

Batch:

```json
{"reminders":[
  {"title":"Apple TV+ renews in 1 week (Oct 19)","when":"2026-10-12","notes":"Renewal Oct 19, 2026"},
  {"title":"Apple Music renews in 1 week (Oct 28)","when":"2026-10-21","notes":"Renewal Oct 28, 2026"}
]}
```

`when`: `YYYY-MM-DD` (defaults to 09:00 local) or `YYYY-MM-DDTHH:MM`.
`alert_minutes_before`: `0` = at start; `1440` = one day before.

## After success

Confirm titles + dates briefly. Mention Calendar alerts are set. Do not instruct the user to open or import the ICS unless `method` is `ics_only` / Calendar permission failed.