apple-reminders

Manage Apple Reminders from the terminal using the remindctl CLI on macOS.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill apple-reminders-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-reminders
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/apple-reminders
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill apple-reminders-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires remindctl.

What problem does it solve? Managing Apple Reminders normally requires the GUI app, which blocks scripting and automation. This Skill lets an agent list, add, edit, complete, and delete reminders directly from the terminal via the remindctl CLI. ## Core Features & Use Cases - View and filter reminders: Query today, tomorrow, week, overdue, upcoming, completed, or a specific date, with JSON, plain TSV, or quiet count output for scripting. - Full CRUD operations: Create reminders with lists and due dates, edit titles and due dates, complete or delete reminders by ID, and manage reminder lists (create, rename, delete). - Use Case: Ask the agent to add "Call mom" to your Personal list due tomorrow, then get a JSON dump of all overdue reminders to feed into a daily planning workflow. ## Quick Start Use the apple-reminders skill to add a reminder titled "Buy milk" due tomorrow and then show me everything due today.

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 add with a title, for example remindctl add "Buy milk". You can attach a list and due date with flags like --list Personal --due tomorrow, accepting natural dates or ISO 8601 formats.

How to list overdue reminders in macOS terminal?

Run remindctl overdue to show all overdue reminders. Other date views include today, tomorrow, week, upcoming, and completed, and you can append --json for machine-readable output.

Does remindctl work on Linux or Windows?

No, remindctl is macOS-only because it reads the Apple Reminders database. It also requires Reminders permission granted in System Settings under Privacy & Security.

Why does remindctl say access is denied to Reminders?

macOS blocks Reminders access until permission is granted. Run remindctl status to check and remindctl authorize to request access, or enable it manually in System Settings → Privacy & Security → Reminders.

Can I get Apple Reminders output as JSON for scripting?

Yes, append --json to any view command such as remindctl today --json. A --plain flag outputs TSV and --quiet returns counts only, which suits shell pipelines and automation.