How do I install the Reminders skill?

Run npx skillmds add majiayu000/reminders in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reminders safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reminders?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reminders free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Reminders?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reminders by majiayu000 — Agent Skill

Name: Reminders
Rating: 4.5 (4 reviews)
Author: majiayu000

File contents

reminders

Manage Apple Reminders from the command line.

Installation

If the reminders CLI is not installed, install it:

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

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

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

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

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

Search Commands

# 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

---name: remindersdescription: Search, create, and complete Apple Reminders. Use when user asks about tasks, todos, reminders, grocery lists, or wants to add/complete items.--- # 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`

Frequently asked questions