Manage Apple Reminders and Calendar events via the event-kit-cli command-line tool. Use when the user wants to create, list, update, delete, or search reminders and calendar events on macOS. Handles installation and permission setup automatically. Requires macOS 14+.
Command-line interface for Apple's native Reminders and Calendar on macOS.
Before using any commands, verify the tool is installed and has permissions.
which event-kit-cli
If not found, run the install script:
bash scripts/install.sh
event-kit-cli status --json
If permissions are missing, run setup:
event-kit-cli setup
The user may need to grant access in System Settings > Privacy & Security > Reminders / Calendars.
| Task | Command |
|---|---|
| List reminders | event-kit-cli reminder list [--list NAME] [--completed] [--json] |
| Add reminder | event-kit-cli reminder add "TITLE" [--due DATE] [--priority N] [--list NAME] [--notes TEXT] |
| Complete reminder | event-kit-cli reminder complete ID |
| Delete reminder | event-kit-cli reminder delete ID |
| Update reminder | event-kit-cli reminder update ID [--title T] [--notes N] [--due D] [--priority P] |
| Search reminders | event-kit-cli reminder search "QUERY" [--list NAME] [--completed] |
| List reminder lists | event-kit-cli reminder lists |
| List events | event-kit-cli calendar events [--from DATE] [--to DATE] [--calendar NAME] [--json] |
| Add event | event-kit-cli calendar add "TITLE" --start DATE --end DATE [--calendar NAME] [--notes T] [--location T] [--all-day] |
| Update event | event-kit-cli calendar update ID [--title T] [--start D] [--end D] [--notes T] [--location T] |
| Delete event | event-kit-cli calendar delete ID |
| List calendars | event-kit-cli calendar list |
| Check permissions | event-kit-cli status [--json] |
| Setup permissions | event-kit-cli setup [--reset] [--open-settings] |
2026-03-16T14:00:00 (for --due, --start, --end)2026-03-16 (for --from, --to)--json): Structured JSON with ISO 8601 dates — use this when you need to parse output programmaticallyAlways use --json when processing results. Use default output when showing results directly to the user.
event-kit-cli reminder list --json
event-kit-cli calendar events --json
event-kit-cli reminder add "Finish report" --due 2026-03-20T17:00:00 --priority 1 --json
event-kit-cli calendar add "Team standup" --start 2026-03-16T09:00:00 --end 2026-03-16T09:30:00 --calendar "Work" --json
event-kit-cli reminder search "report" --json
# Get the ID from the result, then:
event-kit-cli reminder complete <ID> --json
| Value | Meaning |
|---|---|
| 0 | None |
| 1-4 | High |
| 5 | Medium |
| 6-9 | Low |
event-kit-cli setup or event-kit-cli setup --open-settings2026-03-16T14:00:00)See references/COMMANDS.md for complete documentation of every command, flag, and output format.