šŸŽ Get the FREE AI Skills Starter Guide ā€” Subscribe ā†’
BytesAgainBytesAgain
BytesAgain ā€ŗ Skills ā€ŗ Icloud Calendar Skill
šŸ¦€ ClawHub

Icloud Calendar Skill

by @teenlucifer

Add events to iCloud Calendar via CalDAV. Syncs to iPhone automatically with alarm reminders.

Versionv0.1.0
Downloads813
Installs5
#devops#legal#automation#communication
TERMINAL
clawhub install icloud-calendar

šŸ“– About This Skill

name: icloud-calendar description: Add events to iCloud Calendar via CalDAV. Syncs to iPhone automatically with alarm reminders. homepage: https://github.com/TeenLucifer/icloud-calendar-skill metadata: clawdbot: emoji: "šŸ“…" requires: env: ["ICLOUD_EMAIL", "ICLOUD_PASSWORD"] bins: ["python3"] primaryEnv: "ICLOUD_EMAIL" files: ["scripts/*"]

iCloud Calendar

Add events to iCloud Calendar via CalDAV. Automatically syncs to iPhone with alarm reminders.

Features

  • āœ… Add events to iCloud Calendar
  • āœ… iPhone push notifications via calendar alerts
  • āœ… Customizable reminder times (default 15 min + 5 min)
  • āœ… Works with any iCloud account
  • āœ… Credentials stored in local .env file

    • Setup

    1. Get iCloud App Specific Password

    1. Go to appleid.apple.com 2. Sign in ā†’ "Sign-In and Security" 3. Click "App-Specific Passwords" ā†’ "+" 4. Create a new password and save it

    2. Configure Credentials

    cp secrets/.env.example secrets/.env

    Edit secrets/.env with your credentials

    Or set environment variables directly:

    export ICLOUD_EMAIL="your-email@icloud.com"
export ICLOUD_PASSWORD="your-app-specific-password"

    Usage

    python3 scripts/add_event.py "Event Title" "YYYY-MM-DDTHH:MM:SS" "YYYY-MM-DDTHH:MM:SS" "Description"

    Examples

    # Add a simple event
python3 scripts/add_event.py "å›¢é˜Ÿä¼šč®®" "2026-03-10T14:00:00" "2026-03-10T15:00:00" "č®Øč®ŗ锹ē›®čæ›åŗ¦"
    Add event with default 1 hour duration
    
python3 scripts/add_event.py "医ē”Ÿé¢„ēŗ¦" "2026-03-15T09:00:00"

    Security & Privacy

  • Credentials: Stored locally in secrets/.env (gitignored, never committed)
  • Data in transit: Credentials sent only to Apple's iCloud CalDAV servers
  • No external services: Only communicates with caldav.icloud.com
  • User control: Users must provide their own iCloud credentials

    • External Endpoints

    | Endpoint | Data Sent | Purpose | |----------|-----------|---------| | https://caldav.icloud.com | iCloud email + App-Specific Password (Base64 auth), Event data (.ics) | Create calendar events |

    Trust Statement

    This skill sends your iCloud credentials to Apple's iCloud servers to create calendar events. Only install if you trust Apple with your iCloud account. The skill does not store or exfiltrate any data beyond direct communication with iCloud.

    Technical Details

  • Uses iCloud CalDAV API (PROPFIND + PUT methods)
  • Calendar path format: //calendars/home/
  • Creates iCalendar (.ics) events with VALARM reminders
  • Supports multiple alarm triggers

    • License

    MIT License

    šŸ’” Examples

    # Add a simple event
python3 scripts/add_event.py "å›¢é˜Ÿä¼šč®®" "2026-03-10T14:00:00" "2026-03-10T15:00:00" "č®Øč®ŗ锹ē›®čæ›åŗ¦"
    Add event with default 1 hour duration
    
python3 scripts/add_event.py "医ē”Ÿé¢„ēŗ¦" "2026-03-15T09:00:00"

    āš™ļø Configuration

    1. Get iCloud App Specific Password

    1. Go to appleid.apple.com 2. Sign in ā†’ "Sign-In and Security" 3. Click "App-Specific Passwords" ā†’ "+" 4. Create a new password and save it

    2. Configure Credentials

    cp secrets/.env.example secrets/.env

    Edit secrets/.env with your credentials

    Or set environment variables directly:

    export ICLOUD_EMAIL="your-email@icloud.com"
export ICLOUD_PASSWORD="your-app-specific-password"