home / utilities / remindctl

remindctl

140

macOS Apple Reminders CLI for listing lists, filtering tasks, and creating, editing, completing, or deleting reminders.

$brew install steipete/tap/remindctl
Language
Swift
Stars
140
Category
Utilities
Agent
Ready
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 --json output 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-input help 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 --force or 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.