46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
---
|
|
name: apple-calendar
|
|
description: Apple Calendar.app integration for macOS. CRUD operations for events, search, and multi-calendar support.
|
|
metadata: {"clawdbot":{"emoji":"📅","os":["darwin"]}}
|
|
---
|
|
|
|
# Apple Calendar
|
|
|
|
Interact with Calendar.app via AppleScript. Run scripts from: `cd {baseDir}`
|
|
|
|
## Commands
|
|
|
|
| Command | Usage |
|
|
|---------|-------|
|
|
| List calendars | `scripts/cal-list.sh` |
|
|
| List events | `scripts/cal-events.sh [days_ahead] [calendar_name]` |
|
|
| Read event | `scripts/cal-read.sh <event-uid> [calendar_name]` |
|
|
| Create event | `scripts/cal-create.sh <calendar> <summary> <start> <end> [location] [description] [allday] [recurrence]` |
|
|
| Update event | `scripts/cal-update.sh <event-uid> [--summary X] [--start X] [--end X] [--location X] [--description X]` |
|
|
| Delete event | `scripts/cal-delete.sh <event-uid> [calendar_name]` |
|
|
| Search events | `scripts/cal-search.sh <query> [days_ahead] [calendar_name]` |
|
|
|
|
## Date Format
|
|
|
|
- Timed: `YYYY-MM-DD HH:MM`
|
|
- All-day: `YYYY-MM-DD`
|
|
|
|
## Recurrence
|
|
|
|
| Pattern | RRULE |
|
|
|---------|-------|
|
|
| Daily 10x | `FREQ=DAILY;COUNT=10` |
|
|
| Weekly M/W/F | `FREQ=WEEKLY;BYDAY=MO,WE,FR` |
|
|
| Monthly 15th | `FREQ=MONTHLY;BYMONTHDAY=15` |
|
|
|
|
## Output
|
|
|
|
- Events/search: `UID | Summary | Start | End | AllDay | Location | Calendar`
|
|
- Read: Full details with description, URL, recurrence
|
|
|
|
## Notes
|
|
|
|
- Read-only calendars (Birthdays, Holidays) can't be modified
|
|
- Calendar names are case-sensitive
|
|
- Deleting recurring events removes entire series
|