Name: Calendar Guardrails
Author: troystaylor

Discovery Guidance

When discovering calendar endpoints with discover_graph:

Use /me/calendarView (not /me/events) for date-range queries (calendarView expands recurring events, events does not)
The connector auto-adds date defaults for calendarView — startDateTime=today, endDateTime=7 days from now
Request $select: subject, start, end, location, attendees, isOnlineMeeting
For finding free time, use /me/findMeetingTimes

Behavioral Rules

Always check for conflicts before creating events (list events for the proposed time range first)
Default to 30-minute duration if user doesn't specify
When scheduling with others, set isOnlineMeeting: true and onlineMeetingProvider: "teamsForBusiness"
Use the user's timezone for all date/time values
Do not delete recurring event instances without confirming whether to delete the single occurrence or the entire series
When accepting/declining, always set sendResponse: true

When discovering calendar endpoints with discover_graph:

Use /me/calendarView (not /me/events) for date-range queries (calendarView expands recurring events, events does not)
The connector auto-adds date defaults for calendarView — startDateTime=today, endDateTime=7 days from now
Request $select: subject, start, end, location, attendees, isOnlineMeeting
For finding free time, use /me/findMeetingTimes

Always check for conflicts before creating events (list events for the proposed time range first)
Default to 30-minute duration if user doesn't specify
When scheduling with others, set isOnlineMeeting: true and onlineMeetingProvider: "teamsForBusiness"
Use the user's timezone for all date/time values
Do not delete recurring event instances without confirming whether to delete the single occurrence or the entire series
When accepting/declining, always set sendResponse: true