Google Super
GOOGLESUPER_FIND_FILE
The comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q="mimeType = 'application/pdf'" - Find recent files: q="modifiedTime > '2024-01-01T00:00:00'" - Search by name: q="name contains 'report'" - Files in folder: folderId="abc123" or q="'FOLDER_ID' in parents"
Remote googlesuper
Other tools also called GOOGLESUPER_FIND_FILE?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"title": "Q",
"default": null,
"examples": [
"name = 'Budget 2024'",
"name contains 'report'",
"mimeType = 'application/pdf'",
"mimeType = 'application/vnd.google-apps.folder'",
"'FOLDER_ID' in parents",
"modifiedTime > '2024-01-01T00:00:00'",
"modifiedTime > '2024-10-01T14:30:00' and modifiedTime < '2024-10-01T18:00:00'",
"createdTime > '2024-10-02T00:00:00' and createdTime < '2024-10-02T23:59:59'",
"starred = true and mimeType = 'application/pdf'",
"trashed = false",
"'[email protected]' in owners",
"fullText contains 'quarterly results'",
"name contains 'report' and not name contains 'draft'",
"(mimeType contains 'image/' or mimeType contains 'video/')",
"name contains 'invoice' and modifiedTime > '2024-01-01T00:00:00' and trashed = false"
],
"nullable": true,
"description": "Query string to filter file results. Syntax: 'field operator value' combined with 'and', 'or', 'not'.\n\n **Operators:** =, !=, <, >, <=, >=, contains, in\n\n **Common Fields:**\n - `name`, `fullText` - File name or content\n - `mimeType` - File type (e.g., 'application/pdf', 'application/vnd.google-apps.folder')\n - `modifiedTime`, `createdTime` - Dates (RFC 3339: '2024-01-01T00:00:00')\n - `trashed`, `starred`, `sharedWithMe` - Boolean flags\n - `parents` - Folder IDs containing the file\n - `owners`, `writers` - User email addresses\n - `properties`, `appProperties` - Custom metadata\n\n **Special Syntax:**\n - Dates: RFC 3339 format (time zone defaults to UTC)\n - Escaping: Use backslash for special chars: \"name contains 'owner\\'s file'\"\n - Grouping: Use parentheses for OR: \"(mimeType contains 'image/' or mimeType contains 'video/')\"\n - Custom properties: \"properties has { key='department' and value='sales' }\"\n \n **Common Use Cases:**\n - Find files modified after timestamp: \"modifiedTime > '2024-10-01T14:30:00'\"\n - Search file content: \"fullText contains 'quarterly results'\"\n "
},
"fields": {
"type": "string",
"title": "Fields",
"default": "*",
"examples": [
"*",
"nextPageToken,files(id,name,mimeType)",
"files(id,name,modifiedTime,size)",
"nextPageToken,files(id,name,parents,permissions)"
],
"nullable": true,
"description": "Selector specifying which fields to include in a partial response. Use '*' for all fields or a comma-separated list, e.g., 'nextPageToken,files(id,name,mimeType)'."
},
"spaces": {
"type": "string",
"title": "Spaces",
"default": "drive",
"examples": [
"drive",
"appDataFolder",
"photos",
"drive,appDataFolder"
],
"nullable": true,
"description": "A comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'."
},
"corpora": {
"enum": [
"user",
"drive",
"domain",
"allDrives"
],
"type": "string",
"title": "Corpora",
"default": "allDrives",
"examples": [
"user",
"domain",
"drive",
"allDrives"
],
"nullable": true,
"description": "Specifies which collections of files to search. Defaults to 'allDrives' (searches My Drive + all accessible shared drives).\n\n **Values:**\n - `user` - Search only user's personal My Drive\n - `domain` - Search all files shared within Google Workspace domain\n - `drive` - Search specific shared drive (requires 'driveId' parameter and 'includeItemsFromAllDrives' must be true)\n - `allDrives` - Search My Drive + all accessible shared drives (DEFAULT, requires 'includeItemsFromAllDrives' to be true)\n\n **When to Use:**\n - Personal files only: Use 'user'\n - Organization-wide: Use 'domain'\n - Specific shared drive: Use 'drive' with 'driveId'\n - Maximum coverage: Use 'allDrives' (auto-enables supportsAllDrives and includeItemsFromAllDrives)\n "
},
"driveId": {
"type": "string",
"title": "Drive Id",
"default": null,
"nullable": true,
"description": "ID of the shared drive to search. Required if 'corpora' is 'drive'."
},
"orderBy": {
"type": "string",
"title": "Order By",
"default": null,
"examples": [
"modifiedTime desc",
"createdTime",
"name",
"name_natural",
"viewedByMeTime desc",
"quotaBytesUsed desc",
"folder,modifiedTime desc,name",
"starred desc,name"
],
"nullable": true,
"description": "Comma-separated sort keys. Ascending by default; add 'desc' for descending. Cannot be used when query (q) contains fullText search terms.\n\n **Valid Keys:**\n - `createdTime`, `modifiedTime`, `modifiedByMeTime` - Dates\n - `viewedByMeTime`, `sharedWithMeTime` - Activity dates\n - `name`, `name_natural` - File name (natural: file1, file2, file10)\n - `folder` - Folder hierarchy\n - `quotaBytesUsed` - Storage size\n - `starred`, `recency` - Starred status, recent activity\n \n **Restriction:** Sorting is not supported when the query contains fullText searches (e.g., \"fullText contains 'keyword'\"). Omit orderBy when using fullText queries.\n "
},
"pageSize": {
"type": "integer",
"title": "Page Size",
"default": 100,
"maximum": 1000,
"minimum": 1,
"examples": [
10,
50,
100,
500,
1000
],
"nullable": true,
"description": "The maximum number of files to return per page."
},
"folder_id": {
"type": "string",
"title": "Folder Id",
"default": null,
"examples": [
"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
],
"nullable": true,
"description": "ID of a specific folder to search within. This automatically adds \"'folder_id' in parents\" to the query. Can be combined with the 'q' parameter to further filter results within the folder."
},
"pageToken": {
"type": "string",
"title": "Page Token",
"default": null,
"nullable": true,
"description": "The token for continuing a previous list request on the next page."
},
"include_labels": {
"type": "string",
"title": "Include Labels",
"default": null,
"examples": [
"label_abc123",
"label_xyz789,label_def456",
"priority_label,status_label,department_label"
],
"nullable": true,
"description": "A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file."
},
"supportsAllDrives": {
"type": "boolean",
"title": "Supports All Drives",
"default": true,
"nullable": true,
"description": "Whether the requesting application supports both My Drives and shared drives. If 'includeItemsFromAllDrives' is true, this must also be true."
},
"includeItemsFromAllDrives": {
"type": "boolean",
"title": "Include Items From All Drives",
"default": true,
"nullable": true,
"description": "Whether both My Drive and shared drive items should be included in results. Must be true when corpora is 'drive' or 'allDrives'. If true, 'supportsAllDrives' should also be true."
},
"include_permissions_for_view": {
"type": "string",
"title": "Include Permissions For View",
"default": null,
"examples": [
"published"
],
"nullable": true,
"description": "Specifies which additional view's permissions to include in the response. Currently, only 'published' is supported, which includes permissions for files with published content."
}
}
}