How do I install the Apple Reminders skill?

Run npx skillmds@latest add yunseo-kim/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. This skill is licensed under Sustainable Use License 1.

Who published Apple Reminders?

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

Apple Reminders by yunseo-kim — Agent Skill

Name: Apple Reminders
Author: yunseo-kim

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 system tasks or alerts (use cron or other task scheduling tools)
Calendar events or appointments → use Apple Calendar
Project/work task management → use Notion, GitHub Issues, or task queue
One-time notifications → use cron tool for timed alerts
User says "remind me" but means a system alert (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 a system alert?"

Apple Reminders: use this skill
System alert: use cron or other task scheduling tools

---name: apple-remindersdescription: Manage Apple Reminders via remindctl CLI. List, add, edit, complete, and delete reminders with support for lists, date filters, and JSON/plain output.license: Sustainable Use License 1.0---# Apple Reminders CLI (remindctl)Use `remindctl` to manage Apple Reminders directly from the terminal.## When to UseUse 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 UseDon't use this skill when:- Scheduling system tasks or alerts (use cron or other task scheduling tools)- Calendar events or appointments → use Apple Calendar- Project/work task management → use Notion, GitHub Issues, or task queue- One-time notifications → use `cron` tool for timed alerts- User says "remind me" but means a system alert (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 a system alert?"- Apple Reminders: use this skill- System alert: use cron or other task scheduling tools

Frequently asked questions

Apple Reminders