Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Improved documentation in SKILL.md and README.md for clearer usage instructions. - Enhanced test coverage with updates to test_calendar.py and test_security.py. - Internal refinements in calendar.py for better maintainability. - Updated changelog with recent changes.
What This Skill Does
Performs iCloud Calendar CRUD operations from OpenClaw agents via CalDAV or macOS native Calendar.app bridge. Supports listing calendars, fetching events, creating, updating, and deleting events, including targeted updates to recurring event series. Credentials are managed through keyring, environment variables, or a config file.
Supports both direct CalDAV and macOS-native Calendar.app bridge with automatic fallback, so agents work reliably on macOS without requiring external calendar APIs or OAuth flows.
When to use it
- Add a meeting to iCloud Calendar from an agent workflow
- Fetch upcoming events for the next 7 days to brief the user
- Update a single instance of a recurring weekly standup
- Delete a cancelled appointment by event UID
- Set up iCloud credentials securely for headless automation
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: 'Schedule a dentist appointment on March 20 at 10am in my Personal calendar'
- 1Verify credentials are configured via keyring or environment variables
- 2Run list to confirm the 'Personal' calendar exists
- 3Construct JSON payload with summary, dtstart, and dtend in ISO format
- 4Run create with --calendar 'Personal' and the JSON payload
Event 'Dentist Appointment' created in iCloud Personal calendar for 2026-03-20T10:00:00
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.