| name | icloud-cli |
| description | Manage iCloud calendars, events, and email using the icloud CLI. Use when users mention iCloud, Apple calendar, iCloud email, calendar events, or scheduling tasks. |
iCloud CLI
CLI tool for interacting with iCloud calendar and email services.
Prerequisites
The icloud binary must be available in PATH. At least one iCloud account must be configured before use.
Account Management
icloud account add [-e EMAIL] [-p PASSWORD] [-n NAME] [--alias ALIAS]
icloud account list
icloud account set-default <account>
icloud account remove <account>
Calendar Management
icloud calendar list -a ACCOUNT
icloud calendar create <name> -a ACCOUNT
icloud calendar update <calendar-id> -n <new-name> -a ACCOUNT
icloud calendar delete <calendar-id> -a ACCOUNT
Event Management
icloud event list -a ACCOUNT [-s START] [-e END] [-c CALENDAR_ID] [-o FORMAT]
icloud event get <event-uid> -c CALENDAR_ID -a ACCOUNT [-o FORMAT]
icloud event create -t TITLE -s START -c CALENDAR_ID [-e END] [-l LOCATION] [-d DESCRIPTION] [-r RRULE] -a ACCOUNT
icloud event update <event-uid> -c CALENDAR_ID [-t TITLE] [-s START] [-e END] [-l LOCATION] [-d DESCRIPTION] [-r RRULE] [-S] [-o OCCURRENCE] -a ACCOUNT
icloud event delete <event-uid> -c CALENDAR_ID -a ACCOUNT [-S] [-o OCCURRENCE]
Recurrence Rules (RRULE)
FREQ=DAILY # Every day
FREQ=WEEKLY;BYDAY=MO,WE,FR # Mon, Wed, Fri
FREQ=WEEKLY;INTERVAL=2 # Every 2 weeks
FREQ=MONTHLY;BYMONTHDAY=15 # 15th of each month
FREQ=DAILY;COUNT=10 # Daily for 10 occurrences
FREQ=WEEKLY;UNTIL=20251231T235959Z # Weekly until end of 2025
Email Management
Mailbox Operations
icloud email mailbox list -a ACCOUNT
icloud email list -a ACCOUNT [-m MAILBOX] [-n LIMIT] [-o FORMAT]
icloud email get <uid> -m MAILBOX -a ACCOUNT [-o FORMAT]
icloud email search <query> -a ACCOUNT [-m MAILBOX] [-n LIMIT] [-o FORMAT]
Send & Reply
icloud email send -t TO -s SUBJECT [-c CC] [-b BCC] [-B BODY] [-f FILE] -a ACCOUNT
icloud email reply <uid> -m MAILBOX [-B BODY] [-f FILE] [--all] -a ACCOUNT
Email Management
icloud email move <uid> -m SOURCE -d DESTINATION -a ACCOUNT
icloud email delete <uid> -m MAILBOX -a ACCOUNT [-f]
icloud email mark <uid> -m MAILBOX --read|--unread -a ACCOUNT
icloud email flag <uid> -m MAILBOX --set|--unset -a ACCOUNT
Draft Management
icloud email draft create -t TO -s SUBJECT [-c CC] [-B BODY] -a ACCOUNT
icloud email draft list -a ACCOUNT [-n LIMIT] [-o FORMAT]
icloud email draft get <uid> -a ACCOUNT [-o FORMAT]
icloud email draft update <uid> [-t TO] [-s SUBJECT] [-c CC] [-B BODY] -a ACCOUNT
icloud email draft delete <uid> -a ACCOUNT [-f]
icloud email draft send <uid> -a ACCOUNT
Common Workflows
Schedule a meeting
icloud event create -a ACCOUNT -t "Team Standup" -s "2025-01-15 09:00" -e "2025-01-15 09:30" -c <calendar-id> -l "Zoom" -r "FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR"
Find and reply to email
icloud email search "FROM:boss@company.com UNSEEN" -a ACCOUNT -m INBOX
icloud email reply <uid> -a ACCOUNT -m INBOX -B "Thanks for the update!"
Move emails to archive
icloud email move <uid> -a ACCOUNT -m INBOX -d Archive