reminders

Manage Apple Reminders from the command line.

Installation

If the reminders CLI is not installed, install it:

bash

brew install cardmagic/tap/reminders
# or
npm install -g @cardmagic/reminders

Requirements:

•macOS with Apple Reminders
•Node.js 22+
•Full Disk Access for terminal (System Settings > Privacy & Security > Full Disk Access)

Triggers

Use this skill when user asks about:

•Viewing reminders, tasks, or todos
•Adding or creating reminders
•Completing or marking tasks as done
•Grocery lists or shopping lists
•What's due soon or overdue

Proactive triggers: "reminders", "tasks", "todos", "grocery list", "add reminder", "remind me", "mark done", "complete task", "what's on my list", "due soon"

Browse Commands

bash

# Show pending reminders (default)
reminders

# Show all reminder lists with counts
reminders lists

# Show reminders in a specific list
reminders list "Groceries"
reminders list "Work" --all  # include completed

# Show pending/completed/flagged
reminders pending
reminders completed
reminders flagged

# Show reminders due within N days
reminders due --days 7

Create Reminders

The add command auto-detects the appropriate list based on content:

bash

# Auto-detects list from content
reminders add "Buy milk"                    # → Groceries list
reminders add "Call mom"                    # → Family list (if exists)

# Specify list explicitly
reminders add "Review PR" --list "Work"

# With due date
reminders add "Doctor appointment" --due 2024-01-15
reminders add "Morning standup" --due tomorrow --time 09:00

# With priority and flags
reminders add "Urgent task" --priority high --flagged

# Full options
reminders add "Project deadline" --list "Work" --due 2024-02-01 --priority high --notes "Final review"

Complete Reminders

The done command marks reminders as completed:

bash

# Search all lists for matching reminder
reminders done "Buy milk"

# Search in specific list (faster)
reminders done "meeting notes" --list "Work"

Search Commands

bash

# Fuzzy search across all reminders
reminders search "milk"

# Filter by list or status
reminders search "meeting" --list "Work"
reminders search "groceries" --pending
reminders search "project" --completed

Options Reference

Option	Description	Example
`--list, -l`	Filter by list name	`--list "Groceries"`
`--due, -d`	Due date (YYYY-MM-DD, today, tomorrow)	`--due tomorrow`
`--time, -t`	Due time (HH:MM)	`--time 09:00`
`--priority, -p`	Priority level	`--priority high`
`--notes, -n`	Add notes	`--notes "Don't forget!"`
`--flagged, -f`	Mark as flagged	`--flagged`
`--pending`	Show only pending	`--pending`
`--completed`	Show only completed	`--completed`
`--all, -a`	Include completed	`--all`
`--days`	Days to look ahead	`--days 7`

Tips

•Use quotes around titles with spaces: reminders add "Buy groceries"
•The done command uses fuzzy matching - partial titles work
•Auto-detect works best with clear keywords like "groceries", "work", "family"
•Rebuild index after bulk changes: reminders index