argentaios 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,yesterdayYYYY-MM-DDYYYY-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.