Agent skill

apple-reminders

Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

View SKILL.md on GitHub Repository
Stars 355,710
Forks 72,004

Install this agent skill to your Project

npx add-skill https://github.com/openclaw/openclaw/tree/main/skills/apple-reminders

Metadata

Additional technical details for this skill

openclaw 
{
    "os": [
        "darwin"
    ],
    "emoji": "\u23f0",
    "install": [
        {
            "id": "brew",
            "bins": [
                "remindctl"
            ],
            "kind": "brew",
            "label": "Install remindctl via Homebrew",
            "formula": "steipete/tap/remindctl"
        }
    ],
    "requires": {
        "bins": [
            "remindctl"
        ]
    }
}

SKILL.md

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 OpenClaw tasks or alerts → use cron tool with systemEvent instead
  • 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 an OpenClaw 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

bash
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

bash
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

bash
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

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

Output Formats

bash
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 OpenClaw alert (I'll message you here)?"

  • Apple Reminders → use this skill
  • OpenClaw alert → use cron tool with systemEvent

Didn't find tool you were looking for?

Be as detailed as possible for better results