macos-reminders
Create, list, and manage macOS Reminders via AppleScript. Use when the user asks to create a reminder, add a to-do, make a task, set a reminder for something, or anything involving Apple Reminders on macOS. Triggers on requests like "remind me to buy milk", "add a to-do to call the dentist", "create a reminder for Friday", "add to my shopping list", "flag this as important". macOS only.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/lucaperret/macos-remindersmacOS Reminders
Manage Apple Reminders via $SKILL_DIR/scripts/reminders.sh. All date handling uses relative math (current date + N * days) to avoid locale issues (FR/EN/DE date formats).
Quick start
List reminder lists
Always list reminder lists first to find the correct list name:
"$SKILL_DIR/scripts/reminders.sh" list-lists
Create a reminder
echo '<json>' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
JSON fields:
| Field | Required | Default | Description |
|---|---|---|---|
name | yes | - | Reminder title |
list | no | default list | Reminder list name (from list-lists) |
body | no | "" | Notes/details |
offset_days | no | - | Due date as days from today (0=today, 1=tomorrow) |
iso_date | no | - | Absolute due date YYYY-MM-DD (overrides offset_days) |
hour | no | 9 | Due time hour (0-23) |
minute | no | 0 | Due time minute (0-59) |
priority | no | 0 | Priority: 0=none, 1=high, 5=medium, 9=low |
flagged | no | false | Mark as flagged |
List reminders
echo '<json>' | "$SKILL_DIR/scripts/reminders.sh" list-reminders
JSON fields:
| Field | Required | Default | Description |
|---|---|---|---|
list | no | all lists | Filter by list name |
include_completed | no | false | Include completed reminders |
Interpreting natural language
Map user requests to JSON fields:
| User says | JSON |
|---|---|
| "remind me tomorrow at 2pm" | offset_days: 1, hour: 14 |
| "remind me in 3 days" | offset_days: 3 |
| "add to my shopping list" | list: "Shopping" (match closest list name) |
| "high priority" or "important" | priority: 1, flagged: true |
| "remind me on February 25 at 3:30pm" | iso_date: "2026-02-25", hour: 15, minute: 30 |
| "remind me next Monday" | Calculate offset_days from today to next Monday |
| "flag this" | flagged: true |
For "next Monday", "next Friday" etc: compute the day offset using the current date. Use date command if needed:
# Days until next Monday (1=Monday)
target=1; today=$(date +%u); echo $(( (target - today + 7) % 7 ))
Example prompts
These are real user prompts and the commands you should run:
"Remind me to buy milk"
"$SKILL_DIR/scripts/reminders.sh" list-lists
Then:
echo '{"name":"Buy milk","list":"Reminders"}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
"Add a to-do to call the dentist tomorrow at 10am"
echo '{"name":"Call the dentist","offset_days":1,"hour":10}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
"Remind me to submit the report on February 28 — high priority"
echo '{"name":"Submit the report","iso_date":"2026-02-28","hour":9,"priority":1,"flagged":true}' | "$SKILL_DIR/scripts/reminders.sh" create-reminder
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-lucaperret-macos-reminders": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
macos-calendar
Create, list, and manage macOS Calendar events via AppleScript. Use when the user asks to add a reminder, schedule an event, create a calendar entry, set a deadline, or anything involving Apple Calendar on macOS. Triggers on requests like "remind me in 3 days", "add to my calendar", "schedule a meeting next Monday at 2pm", "create a recurring weekly event". macOS only.
macos-notes
Create, read, search, and manage macOS Notes via AppleScript. Use when the user asks to take a note, jot something down, save an idea, create meeting notes, read a note, search notes, or anything involving Apple Notes on macOS. Triggers on requests like "note this down", "save this as a note", "create a note about X", "show my notes", "search my notes for X", "what did I write about X". macOS only.