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): INLINECODE1
• From source: pnpm install && pnpm build (binary at ./bin/remindctl)
• macOS-only; grant Reminders permission when prompted.

Permissions

• - Check status: INLINECODE4
• Request access: INLINECODE5

View Reminders

• - Default (today): INLINECODE6
• Today: INLINECODE7
• Tomorrow: INLINECODE8
• Week: INLINECODE9
• Overdue: INLINECODE10
• Upcoming: INLINECODE11
• Completed: INLINECODE12
• All: INLINECODE13
• Specific date: INLINECODE14

Manage Lists

• - List all lists: INLINECODE15
• Show list: INLINECODE16
• Create list: INLINECODE17
• Rename list: INLINECODE18
• Delete list: INLINECODE19

Create Reminders

• - Quick add: INLINECODE20
• With list + due: INLINECODE21

Edit Reminders

• - Edit title/due: INLINECODE22

Complete Reminders

• - Complete by id: INLINECODE23

Delete Reminders

• - Delete by id: INLINECODE24

Output Formats

• - JSON (scripting): INLINECODE25
• Plain TSV: INLINECODE26
• Counts only: INLINECODE27

Date Formats
Accepted by --due and date filters:

• - today, tomorrow, INLINECODE31
• INLINECODE32
• INLINECODE33
• 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.