GOOGLESUPER_LIST_FILES
Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria.
This record as markdown: /tools/googlesuper/googlesuper-list-files.md
What GOOGLESUPER_LIST_FILES does on Google Super
AI agents call GOOGLESUPER_LIST_FILES 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 | — | A query string for filtering the file results. Supports operators like 'and', 'or', 'not', and can filter on fields like 'name', 'mimeType', 'modifiedTime', 'st |
fields | string | — | Selector specifying which fields to include in a partial response. This can be used to retrieve only specific file metadata, improving performance. Example: 'ne |
spaces | string | — | A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. 'drive' represents files in My Drive and shared |
corpora | string | — | Specifies the bodies of items (files/documents) to which the query applies. Supported values are 'user', 'domain', 'drive', and 'allDrives'. It's generally more |
driveId | string | — | The ID of the shared drive to search. This is used when `corpora` is set to 'drive'. |
orderBy | string | — | A comma-separated list of sort keys. Valid keys include 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', ' |
folderId | string | — | ID of a specific folder to list files from. This is a convenience parameter that automatically adds "'folder_id' in parents" to the query. Cannot be used togeth |
pageSize | integer | — | The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100. |
pageToken | string | — | The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. |
includeLabels | string | — | A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file. |
supportsAllDrives | boolean | — | Whether the requesting application supports both My Drives and shared drives. Defaults to false. If true, then `includeItemsFromAllDrives` can be used to extend |
includeItemsFromAllDrives | boolean | — | Whether to include items from both My Drive and shared drives. This is relevant when `corpora` is 'user' or 'domain'. Defaults to false. |
Parameters from the server's own tool schema.
Why GOOGLESUPER_LIST_FILES is rated Low
This tool performs a read-only query operation against Google Drive to enumerate and search for files and folders. It retrieves data without side effects, modifying, deleting, or executing any operations. It falls squarely into the Read category with low severity since the blast radius of misuse is limited to unauthorized information disclosure of file metadata and listings.
From the tool's definition Tool description states it is used to 'list a user's files and folders in Google Drive' and 'search or browse for files and folders based on various criteria.' These are purely retrieval operations with no modification, deletion, or execution of code.
Risk signalsHigh parameter count (13 properties)
Attacks that exploit this kind of access
The rule that runs GOOGLESUPER_LIST_FILES 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_LIST_FILES, this is the rule to start with:
GOOGLESUPER_LIST_FILES 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_LIST_FILES call is checked against it from then on.
Questions about GOOGLESUPER_LIST_FILES
Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria. It is categorised as a Read tool in the Google Super MCP Server, which means it retrieves data without modifying state.
GOOGLESUPER_LIST_FILES accepts 12 parameters: q, fields, spaces, corpora, driveId, orderBy, folderId, pageSize, pageToken, includeLabels, supportsAllDrives, includeItemsFromAllDrives. 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_LIST_FILES: 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_LIST_FILES 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_LIST_FILES 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_LIST_FILES. 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_LIST_FILES 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