search_drive_files
Search Google Drive and shared drives for files and folders using free text or structured queries. Filter by file type, order results, and paginate.
Instructions
Search Drive (including shared drives) for files and folders.
Free-text queries are auto-wrapped in fullText contains '...';
structured Drive queries pass through as-is. For listing a single
folder by parent use list_drive_items. For file content use
get_drive_file_content. Requires the drive.readonly OAuth scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | The user's Google email address (authenticated account). | |
| query | Yes | Free text (auto-wrapped) or a Drive query expression like `name contains 'Q3' and mimeType = 'application/pdf' and modifiedTime > '2026-01-01T00:00:00'`. Owner-based queries ("x@y.com in owners") do NOT work inside shared drives — search by modifiedTime and order_by="modifiedTime desc" instead. | |
| page_size | No | Max files returned, 1-1000. Default 10. | |
| page_token | No | Cursor from a prior response's `nextPageToken`. | |
| drive_id | No | Shared drive ID to restrict the search. Omit for My Drive + shared-with-me. | |
| include_items_from_all_drives | No | True (default) to include shared drive items when drive_id is omitted. | |
| corpora | No | Scope — "user", "domain", "drive", or "allDrives". Defaults to "drive" when drive_id is set. Prefer "user" or "drive" over "allDrives" for performance. | |
| file_type | No | Friendly alias ("folder", "doc", "sheet", "slides", "form", "drawing", "pdf", "shortcut", "script", "site", "jamboard") or raw MIME type ("application/pdf"). Adds a mimeType filter. | |
| detailed | No | True (default) includes size, modified time, webViewLink per file; False returns just name/ID/type. | |
| order_by | No | Comma-separated sort keys: createdTime, folder, modifiedByMeTime, modifiedTime, name, name_natural, quotaBytesUsed, recency, sharedWithMeTime, starred, viewedByMeTime. Append " desc" to reverse. Example: "folder,modifiedTime desc,name". |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |