Apple Reminders CLI for Openclaw

A robust command-line interface for managing Apple Reminders on macOS using the remindctl utility.

steipete
v1.0.0
Jan 5, 2026
56
31.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install apple-reminders

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install apple-reminders using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Apple Reminders CLI?

The Apple Reminders CLI skill provides a direct bridge between your terminal and the native macOS Reminders application. By utilizing the remindctl tool, this skill allows users and AI agents to programmatically list, create, edit, and delete reminders without opening a GUI. It is designed for developers who want to integrate their system-level task management into their coding workflows using Openclaw Skills.

This integration is particularly valuable for maintaining a high-velocity environment where tasks can be captured as soon as they are identified during development. Whether you are filtering by date, managing multiple lists, or outputting data for scripts, this skill ensures your Apple Reminders ecosystem remains accessible and automated.

Apple Reminders CLI Use Cases

  • Creating quick reminders for code reviews or bug fixes directly from the terminal.
  • Generating automated daily task summaries using JSON output for reporting.
  • Bulk completing or deleting tasks based on specific IDs or lists.
  • Managing project-specific to-do lists using dedicated CLI commands.
  • Filtering upcoming or overdue tasks to stay on top of deadlines during development sessions.

How Apple Reminders CLI Works

  1. The skill invokes the remindctl binary to interact with the macOS EventKit framework.
  2. Commands are parsed to determine actions such as adding a task, listing reminders, or modifying lists.
  3. The tool requests the necessary privacy permissions from macOS to access the Reminders database.
  4. Tasks are retrieved or modified in the local database, and the results are returned in the requested format (Plain, TSV, or JSON).
  5. Users can then leverage these results within larger automation pipelines or Openclaw Skills workflows.

Apple Reminders CLI Setup

To get started with this skill, ensure you are on macOS and follow these steps:

# Install the remindctl utility via Homebrew
brew install steipete/tap/remindctl

# Verify the installation and check permission status
remindctl status

# Authorize the CLI to access your Reminders
remindctl authorize

If access is denied, navigate to System Settings > Privacy & Security > Reminders and ensure your terminal emulator or remindctl is enabled.

Apple Reminders CLI Data Schema & Taxonomy

The skill handles data using structured outputs to ensure compatibility with other tools. Below is the primary data organization:

Feature Details
Output Formats Supports --json for automation, --plain for TSV, and --quiet for counts.
Date Formats Accepts today, tomorrow, YYYY-MM-DD, and ISO 8601 strings.
Task Metadata Includes Title, List Name, Due Date, and unique ID for targeting.
List Operations Supports creating, renaming, and deleting entire named lists.

Apple Reminders CLI Advanced Features

  • Scripting-ready JSON output to pipe task data into other Openclaw Skills.
  • Advanced date filtering including specific timestamps and relative keywords like yesterday or week.
  • Multi-reminder completion by passing multiple IDs in a single command string.
  • Headless operation support for SSH sessions, provided permissions are granted on the host Mac.
  • Custom list management to organize tasks into specific project buckets via the CLI.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*