apple-reminders

Manage Apple Reminders from the terminal using the remindctl CLI with iCloud sync.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill apple-reminders-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/apple/apple-reminders
Command: npx skills add https://github.com/yakeworld/Synthos --skill apple-reminders-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Apple Reminders typically requires the GUI app, making it hard to create, list, complete, or delete reminders from a terminal or automated workflow. This Skill wraps the remindctl CLI so reminders can be handled programmatically while still syncing across all Apple devices via iCloud. ## Core Features & Use Cases - Full Reminder CRUD: View reminders by date (today, tomorrow, week, overdue), create reminders with titles, lists, and due dates, and complete or delete entries by ID. - List Management: List, create, and delete Reminders lists directly from the command line. - Scriptable Output: Use --json, --plain, or --quiet output formats for programmatic parsing and counting. - Intent Guardrails: Distinguishes Apple Reminders requests from agent cronjob alerts, calendar events, and project task tools before acting. - Use Case: A user says "remind me tomorrow at 3pm to prepare for the meeting" — the Skill confirms the content, list, and due date, then runs remindctl add --title "Meeting prep" --list Work --due "2026-02-15 15:00" so the reminder appears on their iPhone. ## Quick Start Ask the assistant to create an Apple Reminder such as "add a reminder to call mom tomorrow at 9am in my Personal list" and it will confirm the details and run the appropriate remindctl command.

Frequently Asked Questions about apple-reminders

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

FAQPage Schema
How do I create an Apple Reminder from the terminal?

Use remindctl add with a title, optional list, and due date, for example: remindctl add --title "Call mom" --list Personal --due tomorrow. The reminder syncs to all Apple devices via iCloud once created.

How do I list overdue Apple Reminders in a script?

Run remindctl overdue --json to get machine-readable output that can be parsed with standard JSON tools. Use --quiet for counts only or --plain for TSV format when JSON is not needed.

What date formats does remindctl accept for due dates?

The --due flag accepts relative values like today, tomorrow, and yesterday, absolute dates as YYYY-MM-DD, date-times as YYYY-MM-DD HH:mm, and full ISO 8601 timestamps such as 2026-01-04T12:34:56Z.

Does remindctl work on Linux or Windows?

No, remindctl requires macOS with the Reminders.app installed, since it reads and writes the system Reminders database. Install it via brew install steipete/tap/remindctl and grant Reminders permission when prompted.

Why does remindctl fail with a permission error?

The error occurs when terminal access to Reminders has not been authorized. Check the current state with remindctl status, then run remindctl authorize and approve the permission prompt before retrying your command.

When should I use Apple Reminders versus a cronjob alert?

Use Apple Reminders when the task should sync to your iPhone or iPad as a personal to-do. Use an agent cronjob when you want the agent itself to notify you at a scheduled time, and use calendar or project tools for events and team tasks.