macOS Apple Reminders CLI for listing lists, filtering tasks, and creating, editing, completing, or deleting reminders.
$brew install steipete/tap/remindctl
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
remindctl is a macOS CLI for Apple Reminders built on EventKit. It gives the shell direct access to reminder lists, task filters, and reminder mutations on the local Mac.
What It Enables
- Show reminders by time filter or list, including today, tomorrow, overdue, upcoming, completed, all, or a specific date.
- Create reminder lists, rename or delete lists, and add reminders with due dates, notes, priorities, and list targeting.
- Edit existing reminders, mark one or many complete, delete reminders, and check or request Reminders authorization from the terminal.
Agent Fit
- Shared
--jsonoutput across reads, writes, and permission checks makes it practical for inspect-then-act loops without scraping colored text. - The command surface is small and flag-driven, and
--plain,--quiet, and--no-inputhelp it fit scripts and unattended local automations. - It is only useful on a Mac that has Apple Reminders data and permissions, and destructive list or delete flows still prompt unless you pass
--forceor disable input.
Caveats
- Requires macOS 14+ and Reminders access on the machine running the command.
- This is a local Apple Reminders control layer, not a cross-platform sync service or shared team task system.