GOOGLESUPER_EVENTS_LIST
Returns events on the specified calendar.
This record as markdown: /tools/googlesuper/googlesuper-events-list.md
What GOOGLESUPER_EVENTS_LIST does on Google Super
AI agents call GOOGLESUPER_EVENTS_LIST to retrieve information from Google Super without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | — | Free text search terms to find events that match these terms in various fields. Optional. |
iCalUID | string | — | Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID. |
orderBy | string | — | The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: "startTime", "updated". When set t |
timeMax | string | — | Upper bound (exclusive) for an event's start time to filter by. Optional. If unset, no start-time upper bound is applied. Must be an RFC3339 timestamp with mand |
timeMin | string | — | Lower bound (exclusive) for an event's end time to filter by. Optional. If unset, no end-time lower bound is applied. Must be an RFC3339 timestamp with mandator |
timeZone | string | — | Time zone used in the response. Optional. Use an IANA time zone identifier (e.g., America/Los_Angeles). Defaults to the user's primary time zone. Offsets (e.g., |
pageToken | string | — | Token specifying which result page to return. Optional. |
syncToken | string | — | Token from nextSyncToken to return only entries changed since the last list. Cannot be combined with iCalUID, orderBy, privateExtendedProperty, q, sharedExtende |
calendarId | string | — | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use |
eventTypes | string | — | Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types. Acceptabl |
maxResults | integer | — | Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are |
updatedMin | string | — | Lower bound for an event's last modification time (RFC3339). When specified, entries deleted since this time are always included regardless of showDeleted. Opti |
Parameters from the server's own tool schema.
Why GOOGLESUPER_EVENTS_LIST is rated Low
This tool queries and retrieves calendar event data without creating, modifying, or deleting any information. It is a straightforward read operation with minimal security risk unless the calendar contains highly sensitive scheduling information, but the tool itself performs no destructive or state-changing actions.
From the tool's definition Tool name contains 'LIST' and description states 'Returns events on the specified calendar' — a retrieval operation with no modification or side effects.
Risk signalsHigh parameter count (19 properties)
Attacks that exploit this kind of access
The rule that runs GOOGLESUPER_EVENTS_LIST safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Google Super, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For GOOGLESUPER_EVENTS_LIST, this is the rule to start with:
GOOGLESUPER_EVENTS_LIST is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Google Super, apply this rule, and every GOOGLESUPER_EVENTS_LIST call is checked against it from then on.
Questions about GOOGLESUPER_EVENTS_LIST
Returns events on the specified calendar. It is categorised as a Read tool in the Google Super MCP Server, which means it retrieves data without modifying state.
GOOGLESUPER_EVENTS_LIST accepts 12 parameters: q, iCalUID, orderBy, timeMax, timeMin, timeZone, pageToken, syncToken, calendarId, eventTypes, maxResults, updatedMin. The full parameter table on this page comes from the server's own tool schema.
Register the Google Super MCP server in PolicyLayer and add a rule for GOOGLESUPER_EVENTS_LIST: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Google Super. Nothing to install.
GOOGLESUPER_EVENTS_LIST is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the GOOGLESUPER_EVENTS_LIST rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for GOOGLESUPER_EVENTS_LIST. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
GOOGLESUPER_EVENTS_LIST is provided by the Google Super MCP server (googlesuper). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Google Super, and thousands of servers like it.
This server
Across the catalogue