A specialized automation skill for managing macOS Reminders through natural language processing and AppleScript.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-reminders
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install macos-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?
The macOS Reminders skill provides a robust interface for AI agents to interact directly with the native Apple Reminders application. By utilizing a combination of AppleScript and Python, this tool allows for the seamless creation, organization, and retrieval of tasks. It is an essential addition to any suite of Openclaw Skills, enabling developers to build powerful personal assistants that bridge the gap between AI reasoning and local system execution.
Designed specifically for the macOS ecosystem, this skill handles complex date math and localized formatting by using relative offsets and ISO standards. Whether you are managing a simple grocery list or a high-priority work project, this integration ensures that your tasks are perfectly synchronized across your Apple devices.
macOS Reminders Use Cases
- Creating quick to-do items from natural language prompts like "remind me to buy milk."
- Managing professional workflows by adding high-priority, flagged tasks to specific project lists.
- Automating the retrieval of pending tasks to provide daily morning briefings.
- Bulk-adding multiple items to a shopping or checklist simultaneously.
- Setting time-sensitive reminders with specific due dates and hours.
How macOS Reminders Works
- The AI agent parses a user request and maps it to a structured JSON payload based on Openclaw Skills standards.
- The system invokes the reminders.sh script, passing the JSON data via standard input to maintain data privacy.
- A Python-based parser validates the input fields, including names, priorities, and date offsets.
- The script executes AppleScript (osascript) to communicate directly with the macOS Reminders database.
- Results or confirmations are returned to the agent and logged locally for auditing purposes.
macOS Reminders Setup
To integrate this into your environment of Openclaw Skills, ensure you are running macOS with Reminders.app enabled. The skill requires python3 and osascript to be available in your system path.
# Navigate to your skill directory
# Test the connection by listing your current reminder lists
"$SKILL_DIR/scripts/reminders.sh" list-lists
macOS Reminders Data Schema & Taxonomy
The skill utilizes a structured JSON schema for all operations to ensure consistency across Openclaw Skills integrations.
| Field | Type | Description |
|---|---|---|
name |
String | The title of the reminder (Required) |
list |
String | The target list name (Defaults to system default) |
offset_days |
Integer | Relative due date from today (0=today, 1=tomorrow) |
iso_date |
String | Absolute date in YYYY-MM-DD format |
priority |
Integer | Priority level: 1 (High), 5 (Medium), 9 (Low) |
flagged |
Boolean | Marks the reminder as important |
macOS Reminders Advanced Features
- Localized Date Abstraction: Uses relative day math to bypass common locale and date format errors found in traditional AppleScript.
- Secure Input Handling: All data is passed through stdin to prevent sensitive task information from appearing in system process lists.
- Intelligent List Matching: Encourages the agent to query existing lists first to ensure tasks are filed in the correct category.
- Comprehensive Logging: Maintains a detailed history of all task modifications in logs/reminders.log.
- Multi-Task Support: Capable of processing and creating multiple individual reminders from a single compound user request.
SKILL.md
Loading
Related Openclaw Skills
macOS Notes
A bridge for AI agents to create, read, and search Apple Notes using AppleScript and Python-based automation.
macOS Calendar Management
A specialized skill for managing Apple Calendar events and schedules on macOS using natural language commands and programmatic AppleScript execution.
Snapmaker Printer Control
Control and monitor your Snapmaker U1 3D printer through AI-driven automation using the Moonraker API.
Apple TV Control
A comprehensive automation skill that enables AI agents to control Apple TV hardware via the pyatv library for media playback and app management.
Drip Billing Integration
A robust integration for tracking AI agent execution costs and metered usage via the Drip SDK.
Morning Briefing
A unified daily intelligence report that aggregates Apple Reminders and Notion tasks into a single, actionable morning briefing.
Featured*
