apple-reminders

Manage Apple Reminders and reminder lists from the terminal via remindctl.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill apple-reminders-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/apple-reminders
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill apple-reminders-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remindctl.

What problem does it solve? Managing Apple Reminders normally requires opening the Reminders app on macOS or iOS, which breaks terminal-based and AI-assisted workflows. This Skill lets you list, add, edit, complete, and delete reminders and reminder lists directly from the command line using remindctl, with everything syncing to your iPhone and iPad. ## Core Features & Use Cases - View and filter reminders: Show today's, tomorrow's, this week's, overdue, or date-specific reminders, with JSON, TSV, or count-only output for scripting. - Full reminder management: Create reminders with due dates and target lists, complete or delete reminders by ID, and create or delete entire reminder lists. - Use Case: A user says "remind me to call mom tomorrow" and wants it on their iPhone. The Skill runs remindctl add --title "Call mom" --list Personal --due tomorrow, and the reminder appears in the iOS Reminders app. ## Quick Start Ask the assistant to add a reminder with a due date to your Apple Reminders, for example to buy milk tomorrow, and confirm it should sync to your phone rather than be an in-app alert.

Frequently Asked Questions about apple-reminders

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

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

Use remindctl with the add command, for example `remindctl add --title "Call mom" --list Personal --due tomorrow`. It accepts dates like today, tomorrow, YYYY-MM-DD, or ISO 8601, and the reminder syncs to your iOS devices.

How do I list today's reminders in the terminal on macOS?

Run `remindctl` or `remindctl today` to show today's reminders. You can also use `remindctl week`, `remindctl overdue`, or a specific date, and add `--json` or `--plain` for scriptable output.

Does remindctl work on Linux or Windows?

No, remindctl is macOS-only because it integrates with the Apple Reminders system database. Install it via Homebrew with `brew install steipete/tap/remindctl` and grant Reminders permission when prompted.

Why does remindctl say it cannot access Reminders?

macOS requires explicit permission for apps to access Reminders data. Run `remindctl status` to check authorization and `remindctl authorize` to request access, then approve the permission prompt in System Settings.

When should I use Apple Reminders instead of a scheduled alert?

Use Apple Reminders when you want a persistent to-do that syncs to your iPhone or iPad Reminders app. Use a scheduled alert or cron-style notification instead for one-time timed messages that do not belong in a task list.