Calendar 📅
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
Features
- Create events
- Schedule meetings
- Set reminders
- View availability
- Recurring events
- Calendar sync
Supported Providers
- Google Calendar
- Apple Calendar (iCloud)
- Work/Corporate Calendars
Quick Start
Setup Google Calendar
export CALENDAR_TYPE=google
./cal.sh list
Setup iCloud Calendar
export CALENDAR_TYPE=icloud
export CALENDAR_ICLOUD_ID='Anthony@martinwa.org'
export CALENDAR_ICLOUD_PASS='mvas-vwsk-ktiv-anex'
./cal.sh list
Setup Work/Corporate Calendar
export CALENDAR_TYPE=work
export CALENDAR_WORK_EMAIL='your@email.com'
export CALENDAR_WORK_URL='https://your-calendar-server.com/calendars'
./cal.sh list
Usage Examples
View today's events:
./cal.sh today
View this week's agenda:
./cal.sh agenda --days 7
Schedule a meeting:
./cal.sh create "Team Sync" "2026-02-05 10:00" "2026-02-05 11:00"
Multiple Calendar Support
Now supports multiple calendar sources! Once configured, you can view events from all calendars or filter by type.
Using iCloud
# Your credentials are already set:
export CALENDAR_TYPE=icloud
export CALENDAR_ICLOUD_ID='Anthony@martinwa.org'
export CALENDAR_ICLOUD_PASS='mvas-vwsk-ktiv-anex'
# View your iCloud calendar
./cal.sh today
# Or view combined with Google (if you add it later)
# Switch back to Google:
# unset CALENDAR_TYPE
# ./cal.sh today
Using Work Calendar
# Set up your work calendar:
export CALENDAR_TYPE=work
export CALENDAR_WORK_EMAIL='anthony@pacificenergy.com.au'
export CALENDAR_WORK_URL='https://outlook.office365.com/EWS/Exchange.asmx'
./cal.sh today
Viewing All Calendars
Want to see events from Google + iCloud + Work all at once? Ask me to combine them!
Calendar Commands
./cal.sh today- Show today's events./cal.sh agenda [days]- Show upcoming events./cal.sh list- List all configured calendars./cal.sh create <title> <start> <end> [options]- Create new event