---
name: Apple Reminders CLI
slug: apple-reminders-cli
category: Automation
description: Apple Reminders CLI manages Apple Reminders from the terminal with remindctl on macOS. Use it to list, add, edit, complete, delete, and script reminders with date filters and JSON or plain output.
github: "https://github.com/hAcKlyc/MyAgents/tree/main/bundled-workspaces/mino/.claude/skills/apple-reminders"
language: TypeScript
stars: 851
forks: 99
install: "npx degit https://github.com/hAcKlyc/MyAgents/tree/main/bundled-workspaces/mino/.claude/skills/apple-reminders ~/.claude/skills/apple-reminders"
installs_to: ~/.claude/skills/apple-reminders
source_path: bundled-workspaces/mino/.claude/skills/apple-reminders/SKILL.md
collection_size: 23
category_size: 1523
collection_url: "https://dirskills.com/collections/hAcKlyc/MyAgents"
added: 2026-08-22T05:21:59.122Z
last_synced: 2026-08-22T05:21:59.122Z
canonical_url: "https://dirskills.com/skills/apple-reminders-cli"
---

# Apple Reminders CLI

Apple Reminders CLI manages Apple Reminders from the terminal with remindctl on macOS. Use it to list, add, edit, complete, delete, and script reminders with date filters and JSON or plain output.

**Install:**

```bash
npx degit https://github.com/hAcKlyc/MyAgents/tree/main/bundled-workspaces/mino/.claude/skills/apple-reminders ~/.claude/skills/apple-reminders
```

## README

# 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.