Reminders

Orchard lets your AI client create and manage macOS Reminders directly — no manual data entry required. Reminders is one of the three apps enabled on the Free plan.

What you can do

“Remind me to call the dentist tomorrow at 10am.”
“Show me everything on my Groceries list that isn’t done yet.”
“Mark the ‘Submit expense report’ reminder as complete.”
“Create a new list called Home Renovation with an orange color.”
“Delete the reminder about renewing my passport.”

Available tools

Tool	Description
`reminder_create`	Create a reminder with title, list, due date, notes, and priority.
`reminder_update`	Update an existing reminder’s title, list, due date, notes, priority, or completion status.
`reminder_delete`	Delete a reminder by ID.
`reminder_info`	List reminder lists, or list reminders filtered by list, completion status, or due date range.
`reminder_list_create`	Create a reminder list with a title and optional color.
`reminder_list_update`	Rename a reminder list or change its color.
`reminder_list_delete`	Delete a reminder list and all its reminders.

reminder_create and reminder_update accept priority as an integer: 0 (none), 1 (high), 5 (medium), or 9 (low). New reminders with a due date get a system notification by default; pass enable_alarm: false (or --enable-alarm false from the CLI) to suppress it.

You can also browse this tool list inside Orchard: open the integrations list and click the info icon on the Reminders row.

Orchard's tool list popover for the Reminders integration

Finding IDs

reminder_info with type=lists returns list IDs, and type=reminders returns reminder IDs. Ask your AI client to look these up before updating or deleting an item — it usually does this automatically.

Required permissions

Reminders needs Reminders full access. macOS prompts for this the first time you use a reminder tool (or during onboarding if you selected Reminders on the Choose Your Features screen). Grant it in the system dialog, or check its status any time from Orchard’s more options page under Authorization.

macOS system permission dialog, shown here for Calendar; the Reminders prompt looks identical

CLI usage

The orchard reminder command exposes the same seven operations as subcommands.

orchard reminder create --title "Call the dentist" --due-date "2026-07-14T10:00:00"

orchard reminder info --type reminders --list-id ABC123 --status incomplete

Add --status all, --status incomplete, or --status completed to filter by completion state; leaving it off is the same as all. Passing anything else fails with a usage error instead of silently returning everything.

orchard reminder update --reminder-id XYZ789 --completed true
orchard reminder delete --reminder-id XYZ789

Moving a reminder to a different list works the same way as any other update — pass the target list’s ID with --list-id:

orchard reminder update --reminder-id XYZ789 --list-id DEF456

orchard reminder list-create --name "Home Renovation" --color "#FF9500"

Every subcommand accepts --json for machine-readable output. Run orchard reminder <subcommand> --help (or orchard help reminder <subcommand>) for the full flag list — see the CLI Reference for more.

Tips & limitations

Reminders is enabled by default alongside Calendar, so most users see it working immediately after onboarding.
reminder_list_update and reminder_list_delete refuse to touch lists that don’t allow content modifications (for example, some synced or shared lists).
Colors accept either a hex string like #FF0000 or a name (red, green, blue, yellow, orange, purple, pink, brown, gray, black, white).
If a due date is cleared by passing an empty string, any alarm and recurrence rule attached to the reminder is removed too.