How do I install the Apple Reminders skill?

Run npx skillmds@latest add understudy-ai/apple-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 Apple Reminders safe to use?

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

Which AI agents work with Apple 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 Apple Reminders free to use?

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

Who published Apple Reminders?

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

Apple Reminders by understudy-ai — Agent Skill

Name: Apple Reminders
Author: understudy-ai

File contents

Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal.

When to Use

✅ USE this skill when:

User explicitly mentions "reminder" or "Reminders app"
Creating personal to-dos with due dates that sync to iOS
Managing Apple Reminders lists
User wants tasks to appear in their iPhone/iPad Reminders app

When NOT to Use

❌ DON'T use this skill when:

Scheduling Understudy chat alerts or recurring automations → use the schedule tool instead
Calendar events or appointments → use Apple Calendar
Project/work task management → use Notion, GitHub Issues, or task queue
One-time or recurring in-chat notifications → use the schedule tool
User says "remind me" but means an Understudy alert in this chat → clarify first

Setup

Install: brew install steipete/tap/remindctl
macOS-only; grant Reminders permission when prompted
Check status: remindctl status
Request access: remindctl authorize

Common Commands

View Reminders

remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

Manage Lists

remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

Create Reminders

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

Complete/Delete

remindctl complete 1 2 3     # Complete by ID
remindctl delete 4A83 --force  # Delete by ID

Output Formats

remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

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)

Example: Clarifying User Intent

User: "Remind me to check on the deploy in 2 hours"

Ask: "Do you want this in Apple Reminders (syncs to your phone) or as an Understudy scheduled alert here?"

Apple Reminders → use this skill
Understudy alert → use the schedule tool

---name: apple-remindersdescription: Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.---# Apple Reminders CLI (remindctl)Use `remindctl` to manage Apple Reminders directly from the terminal.## When to Use✅ **USE this skill when:**- User explicitly mentions "reminder" or "Reminders app"- Creating personal to-dos with due dates that sync to iOS- Managing Apple Reminders lists- User wants tasks to appear in their iPhone/iPad Reminders app## When NOT to Use❌ **DON'T use this skill when:**- Scheduling Understudy chat alerts or recurring automations → use the `schedule` tool instead- Calendar events or appointments → use Apple Calendar- Project/work task management → use Notion, GitHub Issues, or task queue- One-time or recurring in-chat notifications → use the `schedule` tool- User says "remind me" but means an Understudy alert in this chat → clarify first## Setup- Install: `brew install steipete/tap/remindctl`- macOS-only; grant Reminders permission when prompted- Check status: `remindctl status`- Request access: `remindctl authorize`## Common Commands### View Reminders```bashremindctl # Today's remindersremindctl today # Todayremindctl tomorrow # Tomorrowremindctl week # This weekremindctl overdue # Past dueremindctl all # Everythingremindctl 2026-01-04 # Specific date```### Manage Lists```bashremindctl list # List all listsremindctl list Work # Show specific listremindctl list Projects --create # Create listremindctl list Work --delete # Delete list```### Create Reminders```bashremindctl add "Buy milk"remindctl add --title "Call mom" --list Personal --due tomorrowremindctl add --title "Meeting prep" --due "2026-02-15 09:00"```### Complete/Delete```bashremindctl complete 1 2 3 # Complete by IDremindctl delete 4A83 --force # Delete by ID```### Output Formats```bashremindctl today --json # JSON for scriptingremindctl today --plain # TSV formatremindctl today --quiet # Counts only```## Date FormatsAccepted by `--due` and date filters:- `today`, `tomorrow`, `yesterday`- `YYYY-MM-DD`- `YYYY-MM-DD HH:mm`- ISO 8601 (`2026-01-04T12:34:56Z`)## Example: Clarifying User IntentUser: "Remind me to check on the deploy in 2 hours"**Ask:** "Do you want this in Apple Reminders (syncs to your phone) or as an Understudy scheduled alert here?"- Apple Reminders → use this skill- Understudy alert → use the `schedule` tool

Frequently asked questions

Apple Reminders