Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output. Use when the user asks about reminders, todos, tasks, to-do lists, "remind me", scheduling tasks, checking what is due today, completing or deleting reminders, or managing reminder lists on macOS.
Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
Setup
brew install steipete/tap/remindctlpnpm install && pnpm build (binary at ./bin/remindctl)Permissions
remindctl statusremindctl authorizeView Reminders
remindctlremindctl todayremindctl tomorrowremindctl weekremindctl overdueremindctl upcomingremindctl completedremindctl allremindctl 2026-01-04Manage Lists
remindctl listremindctl list Workremindctl list Projects --createremindctl list Work --rename Officeremindctl list Work --deleteCreate Reminders
remindctl add "Buy milk"remindctl add --title "Call mom" --list Personal --due tomorrowEdit Reminders
remindctl edit 1 --title "New title" --due 2026-01-04Complete Reminders
remindctl complete 1 2 3Delete Reminders
remindctl delete 4A83 --forceOutput Formats
remindctl today --jsonremindctl today --plainremindctl today --quietDate Formats
Accepted by --due and date filters:
today, tomorrow, yesterdayYYYY-MM-DDYYYY-MM-DD HH:mm2026-01-04T12:34:56Z)Notes