Loading...

apple-reminders

Original：🇺🇸 English

Translated

Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

3installs

Sourcesteipete/clawdis

Added on2026-02-07

NPX Install

npx skill4agent add steipete/clawdis apple-reminders

Tags

Translated version includes tags in frontmatter

remindctl-cli apple-reminders macos-utilities terminal-tool task-management

SKILL.md Content

View Translation Comparison →

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.