Manage Apple Reminders with remindctl

How to use

Choose Apple Reminders when the item should sync to the user's iPhone or iPad.

This route creates an item in the Reminders app.

Use it for personal to-dos with due dates and list organization.

For scheduling OpenClaw tasks or alerts, use the cron tool with systemEvent instead.

For calendar events or appointments, use Apple Calendar instead.

For project or work task management, use Notion, GitHub Issues, or a task queue instead.

For one-time notifications, use the cron tool for timed alerts instead.

First clarify whether the user wants an Apple Reminders item or an in-chat alert.

An OpenClaw cron alert is the separate in-chat alternative.

If the user says remind me but may mean an OpenClaw alert, clarify first.

Install: brew install steipete/tap/remindctl

This is macOS-only; grant Reminders permission when prompted.

Check status: remindctl status

Request access: remindctl authorize

View reminders for today, tomorrow, this week, past due, all, or a specific date.

remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

List all reminder lists, show or create a specific list, or delete a list.

remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

Create reminders, optionally with a title, list, and due date.

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

Complete or delete reminders by ID.

remindctl complete 1 2 3     # Complete by ID
remindctl delete 4A83 --force  # Delete by ID

Choose an output format: JSON for scripting, TSV with --plain, or counts only with --quiet.

remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

Example: for Remind me to check on the deploy in 2 hours, ask whether the user wants this in Apple Reminders, which syncs to their phone, or as an OpenClaw alert where you message them here.