OpenClaw · Skill
Apple Reminders
Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install steipete/apple-remindersClawHub installer
npx clawhub@latest install steipete/apple-remindersOpenClaw CLI
openclaw skills install steipete/apple-remindersDirect OpenClaw install
openclaw install steipete/apple-remindersWhat this skill does
Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
Why it matters
Provides full terminal access to Apple Reminders, enabling scripting and automation that the native GUI and Shortcuts app don't support directly.
Typical use cases
- Checking today's and upcoming reminders without opening the Reminders app
- Adding a reminder with a due date from a terminal script
- Listing overdue tasks to review what was missed
- Exporting reminders as JSON for scripting or automation
- Managing multiple reminder lists from the command line
Source instructions
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,yesterdayYYYY-MM-DDYYYY-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.