list_calendar_events
Retrieve upcoming Google Calendar events by specifying time ranges, search terms, or result limits to manage your schedule.
Instructions
List events from the user's Google Calendar.
This tool retrieves a list of upcoming events from the user's calendar.
Prerequisites:
- The user must be authenticated with Google Calendar access
Args:
max_results (int, optional): Maximum number of events to return. Defaults to 10.
time_min (str, optional): Start time for the search in ISO format or natural language.
Defaults to now.
time_max (str, optional): End time for the search in ISO format or natural language.
Defaults to unlimited.
query (str, optional): Free text search terms to find events that match.
Returns:
Dict[str, Any]: The list of events including:
- events: List of calendar events with details and links
- next_page_token: Token for pagination (if applicable)
Example usage:
1. List upcoming events:
list_calendar_events()
2. List events for a specific time range:
list_calendar_events(time_min="tomorrow", time_max="tomorrow at 11:59pm")
3. Search for specific events:
list_calendar_events(query="meeting")
Important:
- Always include the event_link when discussing specific events with the user
- The event_link allows users to directly access their events in Google Calendar
- When listing multiple events, include the event_link for each event
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | ||
| time_min | No | ||
| time_max | No | ||
| query | No |