macos-reminders

Manage macOS Reminders via shell commands with JSON output.

4|Updated Mar 12, 2026

Search Tags:#automation #applescript #shell-scripts #json-output #public-interface #macos-reminders #reminderkit

Ready to run

npx skills add https://github.com/vinitu/macos-reminders-skill --skill macos-reminders

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: macos-reminders
Source: https://github.com/vinitu/macos-reminders-skill/tree/main
Command: npx skills add https://github.com/vinitu/macos-reminders-skill --skill macos-reminders

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, remindctl, reminderkit-helper, and includes scripts (resource) components.

What problem does it solve?

Manage macOS Reminders programmatically using a public scripts/commands interface to automate common reminder workflows without manual UI interactions.

Core Features & Use Cases

Public command surface under scripts/commands to list, create, edit, delete, and query Reminders.
Fallbacks with AppleScript + ReminderKit ensure reliability across macOS versions.
Optional acceleration via remindctl for speed, while preserving a working fallback path.

Quick Start

Run any of the public commands under scripts/commands to create, list, or modify reminders without opening Reminders.app.

Frequently Asked Questions about macos-reminders

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

FAQPage Schema

How do I control macOS Reminders from the command line?▼

You can control macOS Reminders from the command line by running public shell scripts that create, list, edit, and delete reminders. This public interface automates workflows without opening the Reminders.app UI.

Can I automate Apple Reminders using shell scripts and get JSON output?▼

Yes, you can automate Apple Reminders using shell scripts that return JSON output. The scripts expose account, list, and reminder operations, making it easy to integrate macOS Reminders data into automated agents.

Do I need remindctl installed to automate macOS Reminders?▼

You do not need remindctl installed to automate macOS Reminders. It is an optional dependency for acceleration; the Skill falls back to AppleScript and ReminderKit to ensure reliability if remindctl is missing.

How does the macOS Reminders automation handle different macOS versions?▼

macOS Reminders automation handles different versions by using a multi-path backend. It attempts a fast path via remindctl and automatically falls back to AppleScript and ReminderKit to maintain reliability across environments.

What dependencies are required to use shell scripts for macOS Reminders?▼

The required dependency to use shell scripts for macOS Reminders is jq for parsing JSON output. Optional dependencies include remindctl for speed, and a ReminderKit helper is compiled automatically if needed.

Why use a shell-based interface instead of AppleScript for Reminders automation?▼

Using a shell-based interface for Reminders automation provides a standardized public command surface with JSON output. While it utilizes AppleScript as a fallback, the shell interface ensures easier integration into agents than raw AppleScripts.