Calendar

Calendar

Calendar management via CalDAV protocol or local ICS files.

Configuration

~/.echo-agent/calendar.yaml:

provider: caldav  # or "local"
caldav_url: https://caldav.icloud.com/
username: user@icloud.com
password_env: ECHO_CALDAV_PASS
local_ics: ~/.echo-agent/calendar.ics

Script

pip install caldav icalendar

python3 scripts/calendar_client.py --url https://caldav.icloud.com/ --user me@icloud.com --password xxx list
python3 scripts/calendar_client.py --url https://caldav.icloud.com/ --user me@icloud.com --password xxx upcoming --days 7
python3 scripts/calendar_client.py --url https://caldav.icloud.com/ --user me@icloud.com --password xxx add "Team meeting" "2026-06-14T10:00" --end "2026-06-14T11:00"

CalDAV Endpoints

Local ICS (Offline)

from icalendar import Calendar, Event
from datetime import datetime

cal = Calendar()
event = Event()
event.add('summary', 'Meeting')
event.add('dtstart', datetime(2026, 6, 14, 10, 0))
event.add('dtend', datetime(2026, 6, 14, 11, 0))
cal.add_component(event)

with open('calendar.ics', 'wb') as f:
    f.write(cal.to_ical())

Integration

• Feeds into daily-briefing skill for morning agenda
• Works with reminder skill for event-based reminders