skills.rest
wopal-cn
wopal-cnOFFICIAL
Explore all skills by this author →
GitHub

mac-reminder

Manage personal todos in macOS Reminders.app via AppleScript shell commands.

3|1|Updated Feb 26, 2026
Search Tags:#automation#reminders#task management#personal productivity#macos#todo#applescript
One-click install
npx skills add https://github.com/wopal-cn/wopal-space-ontology --skill mac-reminder-wopal-cn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mac-reminder
Source: https://github.com/wopal-cn/wopal-space-ontology/tree/main/skills/mac-reminder
Command: npx skills add https://github.com/wopal-cn/wopal-space-ontology --skill mac-reminder-wopal-cn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Managing personal daily tasks often requires switching to the Reminders app manually. This Skill lets you add, list, complete, and delete personal todos directly through conversation, with changes syncing to iPhone and iPad via iCloud. ## Core Features & Use Cases - Full Todo CRUD: Add reminders with optional due dates and priorities, list by status (pending/done/all), complete or delete with fuzzy name matching. - Smart Time Interpretation: Relative phrases like "tomorrow" or "tonight" map to sensible default hours (9:00 AM, 20:00) instead of midnight. - Use Case: You say "帮我记一下明天买牛奶" and the reminder appears in your macOS Reminders list, syncing to your iPhone within minutes. Later, saying "买牛奶完成了" marks it done via fuzzy matching. ## Quick Start Ask the assistant to add a personal reminder such as "remind me to call the dentist tomorrow" and it will create the item in your macOS Reminders list.

Frequently Asked Questions about mac-reminder

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

FAQPage Schema
How do I add a reminder to macOS Reminders from the command line?▼

Run reminder.sh add with the task name, optionally passing --due for a date and --priority (1=low, 5=medium, 9=high). The script uses AppleScript to create the reminder in the configured list and returns its unique ID.

How do I complete or delete a reminder by partial name?▼

Use reminder.sh complete or delete with any substring of the task name. The script performs case-insensitive fuzzy matching; a single match is applied immediately, while multiple matches prompt you to be more specific.

Does this work with iPhone and iPad reminders?▼

Yes, changes made through AppleScript sync to iPhone and iPad automatically via iCloud. Small changes appear almost instantly, while bulk operations may take one to two minutes to propagate.

Why do I get a permission error when running the script?▼

macOS requires Automation permission before a terminal app can control Reminders. Approve the prompt on first run, or enable Reminders access for your terminal under System Settings > Privacy & Security > Automation.

Can I use a different Reminders list than the default?▼

Yes, set the REMINDER_LIST environment variable to any existing list name, such as REMINDER_LIST="Work". If the list is missing, the script prints all available list names to help you choose.

Related Skills

Explore More Personal & Entrepreneur Skills→
GenproMMGenproMM

gsd-note

Capture notes and convert them to todos in local markdown files.

Official
Basic
Shakudo-ioShakudo-io

personal-todo

Manage personal tasks in a single markdown file at ~/.todos.md.

Official
Intermediate
nathanabaynathanabay

frappe-core-notifications

Configure and dispatch email and real-time notifications within Frappe.

Community
Intermediate
guccangguccang
3

apple-reminders

Manage Apple Reminders tasks and lists via remindctl CLI on macOS.

Community
Intermediate