List calendar events
list_calendar_eventsList calendar events and recurring occurrences within a start/end window to check schedules, busy/free time, locations, attendees, and organizer details.
Instructions
Read the user’s calendar, agenda or schedule — what’s on their calendar, what meetings they have, when they are busy or free. With a start/end window (ISO 8601 with offset, both or neither; end exclusive, so a day runs to the next midnight), lists every event and every occurrence of a repeating series that falls inside it, each at its actual date and time; a moved occurrence says when it originally was. Without a window it lists each stored event once, a series at its first occurrence with its repeat rule — use a window to answer "what is on day X". Each entry has its title, time (dates only for all-day events), location, "showAs: free" on an event that does not count as busy time (every other event is busy), reminders, organizer (marked "(you)" when it is the user), attendees with their response status for that occurrence, uid, and for an occurrence its recurrenceId and the rule of the series it belongs to (repeats). Pass the uid (and recurrenceId, to touch one occurrence only) to update_calendar_event or delete_calendar_event; the returned attendee list is the current membership those tools edit, so read it here before removing or adding attendees rather than guessing. Defaults to the user’s default calendar. Birthdays are not calendar events here; for upcoming birthdays use list_upcoming_birthdays.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_calendar_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| start | No | ||
| calendarUrl | No |