Calendar and Reminder Tool Integration

[ajay-bhargava]

Add calendar access and reminder functionality for time-based queries and scheduling.

Capabilities:

• "What's on my calendar today?"
• "Remind me to call John at 3pm"
• "When is my next meeting?"
• "Add lunch with Sarah to my calendar for tomorrow"

Integration Options:

• Google Calendar API
• Apple Calendar (via MentraOS if available)
• Generic iCal format support

Implementation:

1. Tool Creation (src/utils/tools/calendarCall.ts):

• OAuth flow for calendar access
• Read calendar events
• Create/update events
• Reminder management

2. BAML Routing & Formatting (baml_src/calendar.baml):

• Add CALENDAR route to Router enum
• Format calendar events as concise text
• Handle reminder confirmations

3. Handler (src/utils/handlers/calendar.ts):

• Query calendar and format results
• Create events from natural language
• Set reminders with time parsing

4. Time Parsing:

• Natural language date/time parsing ("tomorrow at 3pm", "next Monday")
• Timezone handling
• Relative time expressions

Effort Estimate: 2-3 days

• OAuth and API integration: 1 day
• BAML and handler implementation: 1 day
• Time parsing and edge cases: 0.5-1 day
• Testing: 0.5 day