claude-world Apple Reminders
Manage native macOS Apple Reminders using the remindctl CLI. macOS only.
Prerequisites
brew install steipete/tap/remindctl
After install, grant Reminders access when macOS prompts. If not prompted: System Settings → Privacy & Security → Reminders → allow Terminal.
Commands
| Command | Description |
|---|---|
remindctl list |
List all reminder lists |
remindctl list "<List Name>" |
Show reminders in a specific list |
remindctl add "<List>" "<Title>" [--due "YYYY-MM-DD HH:MM"] |
Add a reminder |
remindctl complete "<List>" "<Title>" |
Mark a reminder as complete |
remindctl delete "<List>" "<Title>" |
Delete a reminder |
remindctl edit "<List>" "<Title>" --title "<New Title>" |
Rename a reminder |
Usage Examples
List today's reminders:
remindctl list "Reminders"
Add a reminder with due date:
remindctl add "Reminders" "Call dentist" --due "2026-03-25 10:00"
Complete a reminder:
remindctl complete "Reminders" "Call dentist"
Add to a custom list:
remindctl add "Work" "Submit report by EOD"
Rules
- Always check if CLI is installed first:
which remindctl - If not installed, show the brew install command and stop
- macOS only — if not on macOS, inform the user and stop
- When listing, default to the "Reminders" list unless user specifies another
- When adding without a due date, add without
--dueflag - Parse natural language times (e.g., "tomorrow at 9am") into
YYYY-MM-DD HH:MMformat before passing to CLI - Keep output concise: confirm action taken in one line
- If a list name is ambiguous, run
remindctl listfirst to show available lists