gws-mcp__calendar_list_events
Read-only
List upcoming events from a Google Calendar. By default returns a compact view per event: id, title, start/end, location, plain-text description (HTML stripped, truncated), organizer email, attendee count plus your own response status, the full attendee roster when the meeting has 10 or fewer people, a recurring flag, attachments, and the video join link (Meet or conference-data providers like Zoom). Only large-meeting rosters, reminders, and raw HTML are dropped — use full for the raw Calendar API payload, or calendar_get_event for one event's complete detail.
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": "gws-mcp__calendar_list_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Return the raw Calendar API response instead of the compact view: full attendee rosters, reminders, conferenceData, htmlLink, and original (often HTML) descriptions. On busy calendars this can be very large — prefer the default compact view for triage and agenda use. | |
| query | No | Free-text search query to filter events | |
| account | No | Optional email address of the connected account to use (e.g. 'user@gmail.com'). If omitted, the default account is used. | |
| order_by | No | "startTime" (default) orders events by when they start; "updated" orders them by when they were last changed. | |
| time_max | No | End of time range (ISO 8601, e.g., "2024-06-30T23:59:59Z"). Defaults to 7 days from now. | |
| time_min | No | Start of time range (ISO 8601, e.g., "2024-06-01T00:00:00Z"). Defaults to now. | |
| page_token | No | The nextPageToken from an earlier call with the same calendar, time range and query, to read the page of events after it. | |
| calendar_id | No | Calendar ID (default: "primary" for the user's main calendar) | |
| max_results | No | Maximum number of events to return (default: 20) | |
| updated_min | No | Only events changed at or after this time (RFC 3339, e.g. "2024-06-01T00:00:00Z"), for reading what changed since an earlier call. The time range still applies. Google refuses a time too far in the past (410 updatedMinTooLongAgo), and then a full read is the way back. Optional. | |
| show_deleted | No | When true, cancelled and deleted events are included, each with status "cancelled". Defaults to false. | |
| max_description_chars | No | In the compact view, truncate each event's plain-text description to this many characters (default: 500; adds a truncation marker). Set to 0 to omit descriptions entirely. Ignored when full is true. |