apple-reminders

Manage Apple Reminders from the terminal using the remindctl command-line tool.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill apple-reminders-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/apple/apple-reminders
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill apple-reminders-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remindctl.

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS, which breaks terminal-based workflows. This Skill lets you create, list, complete, and delete reminders directly from the command line via remindctl, with tasks syncing across all Apple devices through iCloud. ## Core Features & Use Cases - Create and Schedule Reminders: Add reminders with due dates, alarms, and list assignments using natural date formats like "tomorrow" or ISO 8601. - Query and Filter Tasks: View today's, tomorrow's, overdue, or date-specific reminders, with JSON, TSV, or count-only output for scripting. - List Management: Create, view, and delete Reminders lists to organize personal and work tasks. - Use Case: A user says "remind me to call mom tomorrow" — the Skill runs remindctl add --title "Call mom" --due tomorrow, and the reminder appears on their iPhone via iCloud sync. ## Quick Start Ask the assistant to add a reminder with a title and due date, for example: create a reminder to buy milk due tomorrow using Apple Reminders.

Frequently Asked Questions about apple-reminders

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an Apple Reminder from the command line?

Use remindctl with the add command, for example: remindctl add --title "Call mom" --list Personal --due tomorrow. It accepts date formats like today, tomorrow, YYYY-MM-DD, and ISO 8601, and the reminder syncs to your Apple devices via iCloud.

How do I install remindctl on macOS?

Install remindctl via Homebrew with brew install steipete/tap/remindctl. After installation, run remindctl status to check authorization and remindctl authorize to request Reminders permission when prompted.

What is the difference between due date and alarm in Apple Reminders?

The --due flag sets the reminder's actual due date and time, while --alarm sets the EventKit notification trigger. To get an early nudge, set the alarm earlier than the due time, and verify both fields with remindctl today --json.

Can I use remindctl output in scripts?

Yes, remindctl supports machine-readable output formats. Use --json for structured JSON parsing, --plain for TSV, and --quiet for counts only, making it suitable for shell scripting and automation pipelines.

When should I not use Apple Reminders for a reminder request?

Do not use it for agent scheduling alerts, which belong in a cronjob tool, or for calendar events, which belong in Apple or Google Calendar. It is meant for personal to-dos that should sync to iOS devices, not project management.