apple-calendar - Setup Guide

Prerequisites

• macOS with Calendar app configured (iCloud, Exchange, or Google)
• Hermes Agent installed
• CalDAV access enabled on your calendar account
• Node.js 18+ with npx available

Capabilities

Capability	Description
CRUD Events	Create, read, update, delete calendar events
Reminders & Alerts	Set time-based and location-based alerts
Availability Query	Find open time slots across multiple calendars
Multi-Calendar Support	iCloud, Exchange, Google (via CalDAV), local
Natural Language	"Schedule a meeting tomorrow at 2pm for 1 hour"
Recurring Events	Daily, weekly, monthly, custom recurrence rules

Installation

npx skills add sundial-org/awesome-openclaw-skills/apple-calendar

Configuration

Grant Calendar access in macOS:

# System Settings → Privacy & Security → Calendars → Terminal / Hermes

Or via command line (requires admin):

# Add Hermes to calendar access
sudo sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db \
  "INSERT OR REPLACE INTO access VALUES('kTCCServiceCalendar','com.hermes.agent',0,2,2,1,NULL,NULL,NULL,'UNUSED',NULL,0,0);"

Configure in ~/.hermes/config.yaml:

skills:
  apple-calendar:
    default_calendar: "Work"        # Default calendar name
    default_duration_minutes: 60    # Default meeting duration
    default_alert_minutes: 15       # Default reminder before event
    working_hours:
      start: "09:00"
      end: "17:00"
      timezone: "America/Phoenix"
      days: [1, 2, 3, 4, 5]        # Mon-Fri
    read_only_calendars:
      - "Holidays"
      - "Birthdays"

Usage Examples

Create Events

Create a calendar event "CorpusIQ Sprint Review" tomorrow at 3pm for 45 minutes
Schedule "Team Standup" every weekday at 9:30am starting next Monday
Add "Content Calendar Review" to my Work calendar Friday 2pm with a 10-minute reminder

Query Availability

What's on my calendar tomorrow?
Find a 30-minute slot this week for a meeting with 3 attendees
Check my availability Thursday afternoon

Manage Events

Reschedule tomorrow's "Sprint Review" to Friday at 11am
Cancel the "Coffee Chat" on Thursday
Add "Prep slides" as a reminder for my Monday presentation at 8am

How It Works

┌──────────┐     ┌──────────────┐     ┌──────────────┐
│  Hermes   │────▶│  apple-      │────▶│  macOS        │
│  Agent    │     │  calendar    │     │  Calendar     │
└──────────┘     │  skill        │     │  (CalDAV)     │
                 └──────────────┘     └──────────────┘
                        │                      │
                        ▼                      ▼
                 ┌──────────────┐     ┌──────────────┐
                 │  Natural Lang │     │  iCloud /     │
                 │  → CalDAV API │     │  Exchange /   │
                 └──────────────┘     │  Google       │
                                      └──────────────┘

The skill uses CalDAV (the standard calendar protocol) to communicate with macOS Calendar. This provides a uniform interface regardless of which backend you use (iCloud, Exchange, Google).

CorpusIQ Use Cases

1. Content Calendar Management: Schedule social posts, blog publications, and video releases directly from Hermes. "Schedule the UGC video #47 for Thursday at 6pm"

2. Meeting Coordination: Hermes can find mutually available slots for team meetings across multiple calendars.

3. Deadline Tracking: Set reminders for product milestones, launch dates, and customer deliverables. "Set a reminder for 'CorpusIQ v2 launch' on August 1st with 1-week and 1-day alerts"

4. Daily Standup Automation: Automatically schedule daily standups that respect working hours and existing commitments.

5. Client Follow-up Calendar: Create calendar events for follow-up tasks based on email conversations.

Integration with CorpusIQ

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects

Limitations

• macOS Only: This skill uses CalDAV via macOS - not available on Linux or Windows.
• Calendar Permissions: macOS privacy settings may require manual approval on first use.
• Read-Only External: Some shared calendars may be read-only depending on permissions.

Troubleshooting

Symptom	Likely Cause	Fix
"Calendar access denied"	macOS privacy permissions	Grant access in System Settings → Privacy → Calendars
"Calendar not found"	Calendar name mismatch	List calendars: hermes calendar list
Events not syncing	CalDAV sync delay	Wait 30-60 seconds; check internet connection
"Invalid recurrence rule"	Complex custom rule syntax	Use simple recurrence patterns (daily/weekly/monthly)
Working hours not respected	Timezone mismatch in config	Verify timezone matches systemsetup -gettimezone

---

← Skills Catalog | Marketplace → ↑ Skills Home

---

Curated by CorpusIQ - one MCP endpoint, all your business tools.