macOS Calendar & Reminders

VerifiedSafe

Manage Apple Calendar events and Apple Reminders on macOS using calctl.py and remindctl.py CLI tools. Create, query, update, or delete events and reminders.

Sby Skills Guide Bot
ProductivityIntermediate
207/24/2026
Claude CodeCursorWindsurf
#macos#calendar#reminders#eventkit#cli

Recommended for

Our review

Manages Apple Calendar events and Reminders via self-contained CLI scripts using EventKit.

Strengths

  • Native interaction with macOS calendars and reminders without GUI
  • Automation of scheduling and task tracking
  • Supports creation, update, deletion, and search operations

Limitations

  • Requires macOS and the uv tool
  • Requires manual authorization via system permissions
  • Not available on Windows or Linux
When to use it

When you need to programmatically create, modify, or query calendar events or reminders on macOS.

When not to use it

If you are on a different operating system or prefer a graphical interface for calendar management.

Security analysis

Safe
Quality score90/100

The skill only runs local Python scripts (calctl.py, remindctl.py) via uv to manage macOS Calendar and Reminders. It uses allowed-tools Bash and Read, and the scripts require explicit user-granted permissions through macOS. No dangerous operations such as arbitrary code execution, data exfiltration, or system modifications are present.

No concerns found

Examples

Create a calendar event
Create a calendar event on my Work calendar titled 'Team standup' tomorrow from 9:00 to 9:30 AM.
List today's reminders
Show me all my reminders for today.
Search calendar events
Search my calendar for events containing 'review' next week.

name: macos-calendar-reminders-skill description: Manage Apple Calendar events and Apple Reminders on macOS via calctl.py and remindctl.py — self-contained EventKit CLI scripts. Use when the user wants to create, query, update, or delete calendar events or reminders on macOS. compatibility: macOS only (darwin). Requires uv (brew install uv). Python 3.12+ auto-resolved by uv. metadata: author: openclaw version: "3.0.0" allowed-tools: Bash(uv:*) Read

macOS Calendar & Reminders

Two CLI tools for Apple Calendar (calctl.py) and Apple Reminders (remindctl.py). Dependencies auto-installed by uv.

Full reference: calctl.md · remindctl.md · authorization.md


Routing

| Scenario | Tool | |----------|------| | Time blocks (meetings, appointments, events) | calctl — Calendar | | Tasks / deadlines / todos | remindctl — Reminder |

Use list to discover available calendars and reminder lists before creating items.


Quick Reference

# Calendar
uv run scripts/calctl.py list
uv run scripts/calctl.py get --calendar all --start 2026-03-16 --end 2026-03-22
uv run scripts/calctl.py create --calendar Work --title "Meeting" --start 2026-03-20T14:00:00 --end 2026-03-20T15:00:00
uv run scripts/calctl.py search --query "review"
uv run scripts/calctl.py update --id "<event_id>" --start 2026-03-20T15:00:00 --end 2026-03-20T16:00:00
uv run scripts/calctl.py delete --calendar Work --id "<event_id>"

# Reminders
uv run scripts/remindctl.py list
uv run scripts/remindctl.py get today
uv run scripts/remindctl.py get week --list Work
uv run scripts/remindctl.py create --title "Submit report" --list Work --due 2026-03-20T23:59:00 --priority high
uv run scripts/remindctl.py search --query "assignment"
uv run scripts/remindctl.py update --id "<id>" --due 2026-03-21T23:59:00
uv run scripts/remindctl.py complete --id "<id>"
uv run scripts/remindctl.py delete --id "<id>" --confirm

Authorization

On first use, run status --authorize to trigger the macOS permission prompt:

uv run scripts/calctl.py status --authorize
uv run scripts/remindctl.py status --authorize

If permission is denied or the prompt doesn't appear, read authorization.md to guide the user through manual setup. Do not retry in a loop.

Related skills