Calendar Manager
Find availability and schedule meetings across timezones.
Core Functions
Find Availability
# Check for free slots between two datetime ranges
# Default: 9am-5pm local, 30/60min meeting slots
available_slots = find_free_slots(calendar_events, duration=30)
Timezone Conversion
# Convert between timezones
meeting_time = convert_timezone(meeting_time, "America/New_York", "Europe/London")
Generate ICS Files
Create calendar invites users can import:
ics_content = generate_ics(
summary="Meeting Title",
description="Meeting details",
start=datetime(2026, 4, 15, 14, 0),
duration_minutes=30,
attendees=["email@example.com"]
)
Workflow
- Get constraints - Duration, date range, participant timezones
- Check existing events - Parse calendar files or ask user
- Find slots - Algorithm: exclude busy times, respect working hours
- Suggest times - Offer 3 best options with timezone context
- Create invite - Generate .ics for selected time
Output Format
📅 Proposed Meeting Times
Option A: Tuesday, April 15 at 2:00 PM EST
→ 7:00 PM London | 9:00 AM Los Angeles
Option B: Wednesday, April 16 at 10:00 AM EST
→ 3:00 PM London | 7:00 AM Los Angeles
Option C: Thursday, April 17 at 3:00 PM EST
→ 8:00 PM London | 12:00 PM Los Angeles
Reply with A, B, or C to confirm - I'll send invites!
Timezone Reference
Common business timezones:
- EST (America/New_York)
- PST (America/Los_Angeles)
- GMT (Europe/London)
- CET (Europe/Paris)
- JST (Asia/Tokyo)
- IST (Asia/Kolkata)
- AEST (Australia/Sydney)
Use pytz or zoneinfo for conversions.