macOS Reminders Skill for Openclaw

An AI-driven interface for managing native macOS Reminders through simple CLI commands and JSON responses.

sheldenshi
v0.1.1
Feb 10, 2026
0
0
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install 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 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 macOS Reminders Skill?

The macOS Reminders skill provides a powerful bridge between your AI coding agent and the native macOS Reminders application. By leveraging built-in system tools, it allows for seamless task management without any external dependencies. This integration is designed to be used proactively by agents, enabling them to capture to-dos, set deadlines, and track progress within the familiar Apple ecosystem.

As part of the Openclaw Skills library, it emphasizes automation and native integration for a streamlined developer workflow. The skill is highly responsive and returns data in structured formats, making it easy for agents to parse information and provide clear status updates to users. Whether you are managing complex project milestones or simple daily errands, this skill ensures your tasks are always synchronized with your operating system.

macOS Reminders Skill Use Cases

  • Capturing tasks mentioned during a coding session or conversation.
  • Scheduling follow-up reminders with specific due dates and priorities.
  • Listing and summarizing incomplete to-dos across multiple reminder lists.
  • Marking tasks as complete using natural language triggers like I finished that.
  • Organizing project workflows by creating new reminder lists dynamically.

How macOS Reminders Skill Works

  1. The AI agent locates the shell script relative to the skill documentation within the Openclaw Skills directory.
  2. Commands are issued to the script with specific flags for searching, adding, or editing reminders.
  3. The script interacts with the macOS Reminders database via native system APIs, requiring no third-party libraries.
  4. Operation results, such as created tasks or search findings, are returned as structured JSON objects.
  5. The agent parses the JSON and provides a natural language confirmation or list summary to the user.

macOS Reminders Skill Setup

Define the path to the reminders script in your environment and ensure the file has execution permissions. On the first run, macOS will prompt you to grant the necessary permissions.

# Set the path to the reference script
REMINDERS="$(dirname "<path-to-this-SKILL.md>")/references/reminders.sh"

# Test the installation by listing your current reminder lists
$REMINDERS lists

If you encounter a permission error, navigate to System Settings > Privacy & Security > Reminders and ensure your terminal or agent has access.

macOS Reminders Skill Data Schema & Taxonomy

The skill returns structured JSON for all operations to ensure compatibility with modern AI workflows. The following table describes the primary data fields:

Field Type Description
name String The title of the reminder or list.
body String The notes or description associated with the reminder.
completed Boolean The current completion status of the task.
dueDate ISO 8601 The absolute timestamp for when the task is due.
priority String The importance level (high, medium, low, or none).
list String The name of the parent list where the reminder resides.

macOS Reminders Skill Advanced Features

  • Proactive task recognition: The agent can identify intent in conversation and offer to create reminders automatically.
  • Relative date parsing: Supports converting phrases like tomorrow at 9am into absolute ISO 8601 timestamps for the system.
  • Search-first editing: Allows finding reminders by query before applying updates to notes, priority, or due dates.
  • Interactive safety: Includes flags like --yes to bypass confirmation prompts for automated deletion workflows.
  • Cross-list management: Capability to search across all lists or filter results by specific categories.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*