get_events
Retrieve a formatted list of events from a specified Google Calendar within a defined time range using user email and calendar ID. Supports custom queries with optional start, end, and result limits.
Instructions
Retrieves a list of events from a specified Google Calendar within a given time range.
Args:
user_google_email (str): The user's Google email address. Required.
calendar_id (str): The ID of the calendar to query. Use 'primary' for the user's primary calendar. Defaults to 'primary'. Calendar IDs can be obtained using `list_calendars`.
time_min (Optional[str]): The start of the time range (inclusive) in RFC3339 format (e.g., '2024-05-12T10:00:00Z' or '2024-05-12'). If omitted, defaults to the current time.
time_max (Optional[str]): The end of the time range (exclusive) in RFC3339 format. If omitted, events starting from `time_min` onwards are considered (up to `max_results`).
max_results (int): The maximum number of events to return. Defaults to 25.
Returns:
str: A formatted list of events (summary, start time, link) within the specified range.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| calendar_id | No | primary | |
| max_results | No | ||
| service | Yes | ||
| time_max | No | ||
| time_min | No | ||
| user_google_email | Yes |
Input Schema (JSON Schema)
{
"properties": {
"calendar_id": {
"default": "primary",
"title": "Calendar Id",
"type": "string"
},
"max_results": {
"default": 25,
"title": "Max Results",
"type": "integer"
},
"service": {
"title": "service",
"type": "string"
},
"time_max": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Max"
},
"time_min": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Min"
},
"user_google_email": {
"title": "User Google Email",
"type": "string"
}
},
"required": [
"service",
"user_google_email"
],
"title": "get_eventsArguments",
"type": "object"
}