Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
View on GitHubJanuary 23, 2026
Select agents to install to:
npx add-skill https://github.com/clawdbot/clawdbot/blob/fdbaae6a33c4aa6571d2b816f643b5f128c2f474/skills/apple-reminders/SKILL.md -a claude-code --skill apple-remindersInstallation paths:
.claude/skills/apple-reminders/# 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.