reminders

Read, create, complete, and delete Apple Reminders via the reminders CLI on macOS.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/dbbaskette/herald --skill reminders-dbbaskette
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reminders
Source: https://github.com/dbbaskette/herald/tree/main/skills/reminders
Command: npx skills add https://github.com/dbbaskette/herald --skill reminders-dbbaskette

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read, create, complete, and delete Apple Reminders via the reminders CLI on macOS, enabling automation and scripting of personal reminders.

Core Features & Use Cases

  • List incomplete reminders across lists without opening Reminders.app.
  • Create new reminders with titles and optional due dates and notes via the reminders CLI.
  • Mark reminders as complete or delete them to streamline task management from scripts or prompts.
  • Guardrails include macOS privacy checks and platform compatibility guidance.

Quick Start

Install the reminders CLI, grant Reminders access, then ask me to read, add, complete, or delete a reminder.

Frequently Asked Questions about reminders

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

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

You can manage Apple Reminders from the command line by using the reminders CLI on macOS to read, create, complete, and delete tasks across your lists without opening the Reminders app.

Can I add reminders with due dates using a CLI on macOS?

Yes, you can create new reminders with titles, optional due dates, and notes directly from the CLI on macOS, enabling task management automation and scripting for personal reminders.

Does the reminders CLI work on operating systems other than macOS?

No, the reminders CLI requires macOS to interface with the native Reminders.app, and the Skill includes guardrails to ensure safe operation and platform compatibility guidance for non-macOS environments.

What privacy permissions are needed to control Reminders.app via the CLI?

To control Reminders.app via the CLI, you must grant macOS privacy permissions for Reminders access, ensuring the command line can securely read, create, complete, and delete your task lists.

How do I automate task management by listing incomplete Apple Reminders?

You can automate task management by running a command to list incomplete Apple Reminders across multiple lists, streamlining your workflow without needing to manually open the Reminders.app interface.

Why do I need Homebrew to use this command line reminders tool?

You need Homebrew to install the reminders CLI, which acts as the underlying bridge allowing the command line to interact directly with your macOS Reminders.app database for task automation.