Apple Reminders

Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.

Setup

• -Install (Homebrew): brew install steipete/tap/remindctl
• -From source: pnpm install && pnpm build (binary at ./bin/remindctl)
• -macOS-only; grant Reminders permission when prompted.

Permissions

• -Check status: remindctl status
• -Request access: remindctl authorize

View Reminders

• -Default (today): remindctl
• -Today: remindctl today
• -Tomorrow: remindctl tomorrow
• -Week: remindctl week
• -Overdue: remindctl overdue
• -Upcoming: remindctl upcoming
• -Completed: remindctl completed
• -All: remindctl all
• -Specific date: remindctl 2026-01-04

Manage Lists

• -List all lists: remindctl list
• -Show list: remindctl list Work
• -Create list: remindctl list Projects --create
• -Rename list: remindctl list Work --rename Office
• -Delete list: remindctl list Work --delete

Create Reminders

• -Quick add: remindctl add "Buy milk"
• -With list + due: remindctl add --title "Call mom" --list Personal --due tomorrow

Edit Reminders

• -Edit title/due: remindctl edit 1 --title "New title" --due 2026-01-04

Complete Reminders

• -Complete by id: remindctl complete 1 2 3

Delete Reminders

• -Delete by id: remindctl delete 4A83 --force

Output Formats

• -JSON (scripting): remindctl today --json
• -Plain TSV: remindctl today --plain
• -Counts only: remindctl today --quiet

Date Formats

Accepted by --due and date filters:

• -today, tomorrow, yesterday
• -YYYY-MM-DD
• -YYYY-MM-DD HH:mm
• -ISO 8601 (2026-01-04T12:34:56Z)

Notes

• -macOS-only.
• -If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
• -If running over SSH, grant access on the Mac that runs the command.