Apple Reminders

Name: Apple Reminders
Author: steipete

steipete/clawdis

3.7k installs
385k repo stars
Updated August 3, 2026
steipete/clawdis

apple-reminders is an agent skill that lists, adds, edits, completes, and deletes Apple Reminders and lists via the remindctl CLI on macOS.

About

apple-reminders is an agent skill for managing Apple Reminders through the remindctl terminal CLI on macOS. It covers viewing today, tomorrow, week, overdue, or date-filtered reminders, creating and deleting lists, adding items with optional due dates, and completing or deleting reminders by ID. Output formats include JSON for scripting, plain TSV, and quiet counts. Setup requires Homebrew install of steipete/tap/remindctl, Reminders permission, and authorize via remindctl status and remindctl authorize. The skill distinguishes Apple Reminders sync to iPhone and iPad from OpenClaw cron alerts, calendar events, and project task tools like Notion or GitHub Issues. When users say remind me, the agent should clarify whether they want a Reminders app entry or an in-session alert. Accepted due date formats include today, tomorrow, YYYY-MM-DD, and ISO 8601 timestamps for scheduled personal tasks.

Manages Apple Reminders via remindctl list, add, complete, and delete commands.
Supports today, tomorrow, week, overdue, all, and specific date reminder views.
Outputs JSON, plain TSV, or quiet counts for scripting workflows.
Requires macOS, Homebrew install, and Reminders permission authorization.
Clarifies Apple Reminders versus OpenClaw cron alerts when users say remind me.

Apple Reminders by the numbers

3,682 all-time installs (skills.sh)
+165 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #54 of 550 CLI & Terminal skills by installs in the Skillselion catalog
Security screen: LOW risk (skills.sh audit)
Data as of Aug 3, 2026 (Skillselion catalog sync)

At a glance

apple-reminders capabilities & compatibility

Capabilities: list reminders by today, date, week, or overdue · create, complete, and delete reminders and lists · output json, plain tsv, or quiet counts for scri · clarify reminders app tasks versus in session al
Use cases: planning · orchestration
Platforms: macOS
Runs: Runs locally
Pricing: Free

npx skills add https://github.com/steipete/clawdis --skill apple-reminders

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/steipete/clawdis/apple-reminders.svg)](https://skillselion.com/skills/steipete/clawdis/apple-reminders)

Installs	3.7k
repo stars	★ 385k
Security audit	3 / 3 scanners passed
Last updated	August 3, 2026
Repository	steipete/clawdis ↗

How do I create or check Apple Reminders that sync to my phone without leaving the terminal session?

List, add, edit, complete, or delete Apple Reminders and reminder lists via the remindctl CLI on macOS.

Who is it for?

macOS users who want terminal-driven personal to-dos that sync to the Reminders app on iPhone and iPad.

Skip if: Skip for OpenClaw timed alerts, calendar appointments, or project task systems like Notion or GitHub Issues.

When should I use this skill?

User explicitly mentions Reminders app tasks, personal to-dos with due dates, or managing Apple reminder lists.

What you get

Reminders created, listed, completed, or deleted in Apple Reminders with optional due dates and list assignment via remindctl.

Created or updated reminders
List views in JSON, TSV, or human-readable output

By the numbers

macOS-only skill requiring remindctl via steipete/tap/remindctl Homebrew formula

Files

SKILL.mdMarkdownGitHub ↗

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

Related skills

Lark SharedWire Feishu/Lark Open Platform auth, tokens, and shared API helpers into agent-built bots and internal tools.493k

Runcomfy CliLet their coding agent call any RunComfy model from the terminal or scripts without managing separate SDKs.298k30

Skills CliDiscover, install, update, and manage reusable agent capabilities from the open Skillselion ecosystem directly inside their coding agent.270k72

TzstCreate, extract, list, and script `.tzst` / `.tar.zst` archives from the terminal with the right compression, streaming, and conflict flags.267k72

XdropPull files from an Xdrop share URL, decrypt them locally, and land outputs in a chosen directory with optional JSON for automation.266k72

WizardAuthor interactive bash setup wizards that open URLs, capture secrets, write .env upserts, and set GitHub Actions secrets step by step.92.1k193k

Forks & variants (2)

Apple Reminders has 2 known copies in the catalog totaling 21 installs. They canonicalize to this original listing.

beita6969 - 16 installs
firecrawl - 5 installs

How it compares

Use apple-reminders over generic shell scripts when you need native Apple Reminders CRUD through the supported remindctl CLI.

FAQ

How is apple-reminders installed?

Run brew install steipete/tap/remindctl, then remindctl authorize when macOS prompts for Reminders access.

When should I not use apple-reminders?

Do not use for OpenClaw cron alerts, calendar events, or project trackers; clarify intent when the user says remind me.

What date formats does remindctl accept?

today, tomorrow, yesterday, YYYY-MM-DD, YYYY-MM-DD HH:mm, and ISO 8601 timestamps.

Is Apple Reminders safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

CLI & Terminalworkflownotes