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.