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.