Agent skill

reminders

Search, create, and complete Apple Reminders. Use when user asks about tasks, todos, reminders, grocery lists, or wants to add/complete items.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/productivity/reminders

SKILL.md

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

Didn't find tool you were looking for?

Be as detailed as possible for better results