Google Drive integration: operations for AI agents
Google Drive connects to Type.com as an integration. This page lists the 15 operations documented for Claude and Codex in Type.com: 8 read, 5 write, 2 destructive.
About Google Drive
Find, upload, copy, move, rename and download files in Google Drive. The standard connection only sees files you pick or create through type.com; the full-access connection can search your whole Drive.
Categories: File management & storage
How to connect Google Drive to Type.com
- Connect
- Sign in with Google (OAuth)
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
15 operations. Your connection's permissions determine which operations are available.
- Read
google drive download file
Download a binary file stored in Google Drive, such as a PDF, DOCX, XLSX, image, CSV, ZIP, or other uploaded file. This streams the file into Type file delivery and returns a Type file ID instead of inlining bytes. Use google_drive_export_file for native Google Docs, Sheets, or Slides files. If the file is outside Type's current selected access, this tool returns a Select files card so the user can add access.
- Read
google drive export file
Export a native Google Docs, Sheets, or Slides file into Type file delivery and return a Type file ID instead of inlining bytes. Common export MIME types: Docs to application/vnd.openxmlformats-officedocument.wordprocessingml.document or text/markdown; Sheets to application/vnd.openxmlformats-officedocument.spreadsheetml.sheet or text/csv; Slides to application/pdf. If exportMimeType is omitted, Docs export as DOCX, Sheets as XLSX, and Slides as PDF. Google Drive caps exports at about 10MB; Google Docs markdown export can fall back to Type's markdown conversion path. If the file is outside Type's current selected access, this tool returns a Select files card so the user can add access.
- Read
google drive get file
Get detailed metadata for a specific file in Google Drive. Returns name, type, size, creation/modification times, sharing status, and permissions. Use file IDs from search results.
- Read
google drive list recent docs
List Google Docs files in Google Drive ordered by most recently modified time, newest first. Use limit for the number the user requested, such as limit 3 for their last three docs. With drive.metadata access, Drive can list metadata across files visible to the user; with only drive.file access, results are limited to documents the user opened, created, or selected for Type. If no accessible documents are returned, this tool returns a Select files card so the user can add more Drive access. When using this through the regular Google Drive & Docs service, access can be limited by selected Drive files. If regular Google Drive & Docs is not connected, recommend connecting Google Drive & Docs with provider google-drive-docs before suggesting full access. If regular Google Drive & Docs is connected but too limited, and Google Docs & Drive (full access) is connected, retry the same Drive tool with service google-docs-full. Only offer to connect Google Docs & Drive (full access) with provider google-docs-full when regular Google Drive & Docs is already connected and the task still needs broad Drive search, folder discovery, or repeated Drive file operations. If the user says this will be repeated or asks to do many Drive file/folder operations, use google_drive_request_full_access with a reason and optional query so the full-access card renders. If the user only needs specific files or folders, or prefers limited access, use google_drive_select_files with a reason and optional query so the user can select them, then retry.
- Read
google drive request full access
Show a Google Docs & Drive (full access) connection card. Use this instead of google_drive_select_files when regular Google Drive & Docs is already connected and the user says they will repeat this workflow, asks to do this often, needs broad Drive search or folder discovery, or needs to find/move/rename/edit many files and folders without selecting each one first. Do not use this for a one-off task that only needs a known specific file or folder; use google_drive_select_files for that narrower case. After the user connects full access, retry the relevant Drive or Docs operation with service google-docs-full.
- Read
google drive search docs
Search for Google Docs documents available to Type in Google Drive by name or content. With drive.metadata access, Drive search can find document metadata across files visible to the user; with only drive.file access, results are limited to documents the user opened, created, or selected for Type. Returns a list of matching documents with their IDs, titles, URLs, and metadata. Use the document ID with google_docs_get to read the full content. If no accessible documents match, this tool returns a Select files card so the user can add more Drive access. If results are partial, irrelevant, ambiguous, or likely missing files outside Type's selected access, decide between broad full access and selected-file access. When using this through the regular Google Drive & Docs service, access can be limited by selected Drive files. If regular Google Drive & Docs is not connected, recommend connecting Google Drive & Docs with provider google-drive-docs before suggesting full access. If regular Google Drive & Docs is connected but too limited, and Google Docs & Drive (full access) is connected, retry the same Drive tool with service google-docs-full. Only offer to connect Google Docs & Drive (full access) with provider google-docs-full when regular Google Drive & Docs is already connected and the task still needs broad Drive search, folder discovery, or repeated Drive file operations. If the user says this will be repeated or asks to do many Drive file/folder operations, use google_drive_request_full_access with a reason and optional query so the full-access card renders. If the user only needs specific files or folders, or prefers limited access, use google_drive_select_files with a reason and optional query so the user can select them, then retry. Large results may be truncated to fit context limits.
- Read
google drive search files
Search for files available to Type in Google Drive by name or content. With drive.metadata access, Drive search can find file metadata across files visible to the user; with only drive.file access, results are limited to files the user opened, created, or selected for Type. Can filter by file type (MIME type). Returns files of all types: documents, spreadsheets, images, PDFs, etc. If no accessible files match, this tool returns a Select files card so the user can add more Drive access. If results are partial, irrelevant, ambiguous, or likely missing files outside Type's selected access, decide between broad full access and selected-file access. When using this through the regular Google Drive & Docs service, access can be limited by selected Drive files. If regular Google Drive & Docs is not connected, recommend connecting Google Drive & Docs with provider google-drive-docs before suggesting full access. If regular Google Drive & Docs is connected but too limited, and Google Docs & Drive (full access) is connected, retry the same Drive tool with service google-docs-full. Only offer to connect Google Docs & Drive (full access) with provider google-docs-full when regular Google Drive & Docs is already connected and the task still needs broad Drive search, folder discovery, or repeated Drive file operations. If the user says this will be repeated or asks to do many Drive file/folder operations, use google_drive_request_full_access with a reason and optional query so the full-access card renders. If the user only needs specific files or folders, or prefers limited access, use google_drive_select_files with a reason and optional query so the user can select them, then retry. Use google_drive_search_docs for Google Docs specifically.
- Read
google drive select files
Show a Select files card so the user can grant Type access to additional Google Drive files or folders. Use this when the user only needs specific files or folders, or prefers limited access. If regular Google Drive & Docs is not connected, recommend connecting provider google-drive-docs first. For broad Drive search or folder discovery after regular Google Drive & Docs is connected, prefer Google Docs & Drive (full access) with service google-docs-full when connected, or use google_drive_request_full_access to render the provider google-docs-full connection card. Use selected-file access whenever the current selected-file access is likely incomplete, not only when a search returns zero results. Good cases: a user mentions files or folders missing from current results; search results are partial, irrelevant, or ambiguous; a direct file, Doc, Sheet, or destination folder is inaccessible; or a task likely needs a folder the user has not selected. Do not use this for repeated workflows, broad discovery, or many future Drive operations; use google_drive_request_full_access instead so the full-access card renders. Give a concise reason, then retry the relevant search or operation after the user continues.
- Write
google drive copy file
Copy a file in Google Drive, optionally into another folder (including shared drives) and with a new name. Set convertToGoogleFormat to turn an Office or CSV file into a native Google Doc, Sheet, or Slides file that the Docs and Sheets tools can edit. Copying a template already inside a shared drive is also the way to create a file directly in that shared drive.
- Write
google drive create folder
Create a new folder in Google Drive. Can optionally specify a parent folder selected in the integration settings to create a subfolder. Returns the new folder's ID and URL.
- Write
google drive move file
Move a file to a different folder in Google Drive. Removes the file from its current folder(s) and places it in the destination folder selected in the integration settings.
- Write
google drive rename file
Rename a file or folder in Google Drive. Does not change the file's location, only its name.
- Write
google drive upload file
Upload a new file into Google Drive, optionally into a specific folder (including shared drives). Use this to save a generated or edited file (such as an .xlsx, .docx, or PDF) to Drive. To replace an existing file while keeping its link and version history, use google_drive_update_file_content instead. Set convertToGoogleFormat to create a native Google Doc, Sheet, or Slides file from Office, CSV, or text content.
- Destructive
google drive trash file
Move a file to the trash in Google Drive. Trashed files can be recovered from the trash within 30 days. Use with caution for important files.
- Destructive
google drive update file content
Replace the content of an existing uploaded file in Google Drive (for example an .xlsx, .docx, or PDF) with new bytes. The file keeps its ID, link, folder, and sharing, and Drive keeps the previous content in version history. Typical flow: google_drive_download_file, edit the file locally, then call this with the edited file. Pass expectedModifiedTime from the download or google_drive_get_file so the update is refused if someone changed the file in the meantime. Native Google Docs, Sheets, and Slides cannot be overwritten this way; use the Google Docs or Google Sheets editing tools for those.
No operations match.
Not supported
- Permanently deleting files (only moving to trash)
- Changing sharing settings or permissions
- Editing native Google Docs, Sheets or Slides byte-for-byte (use the Google Docs and Google Sheets tools instead)
Example prompts
- Find the latest Q3 board deck in Drive and summarize it.
- Save this report as an Excel file in our Finance folder.
- Copy the onboarding template into a new folder for Acme.
Get started
- Open Space settings → Connections and search for Google Drive.
- Connect your account and add the connection to the Space.
- Ask for what you need in any thread in that Space.
See How connections work for access and permissions, or browse all integrations.