SKILL.md
readonly

apple-reminders

Author：openclaw
Category：
Productivity
330.8k
64.4k
GitHub
name: apple-reminders
description: Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
homepage: https://github.com/steipete/remindctl

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

Actions

install --global skills.sh
npx skills add openclaw/openclaw/skills/apple-reminders

Usage Guide

  1. 1. Run Install Command

    Copy the installation command above and run it in your terminal to install globally.

  2. 2. Configure Environment

    Add the required environment variables to your MCP client according to the skill description.

  3. 3. Use in Client

    Configure and enable this skill in any MCP-compatible app (e.g. Claude or Cursor).