mcpField
A
apple-reminders

apple-reminders

github.com/openclawProductivity393.3k6.1k installsUpdated today
Repository

About apple-reminders

apple-reminders is a skill for managing Apple Reminders from the terminal with remindctl. It is intended for personal to-dos and lists that should appear in the Apple Reminders app.

Key features

  1. 01View reminders by date or status
  2. 02Create and manage reminder lists
  3. 03Add reminders with due dates
  4. 04Complete or delete reminders by ID
  5. 05Output JSON, TSV, or counts

Use cases

  1. 01Add a personal task with a due date
  2. 02Review overdue or upcoming reminders
  3. 03Organize tasks into Apple Reminders lists

Install

Copy the command and run it in a terminal.

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

After installing, type/apple-remindersin Claude Code to confirm it loaded.

Details

From the project README

Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal.

When to Use

Use 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

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

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

Comments

Markdown supported