Sim

Google Drive

Manage files, folders, and permissions

Google Drive is Google's cloud storage and file synchronization service that allows users to store files, synchronize files across devices, and share files with others. As a core component of Google's productivity ecosystem, Google Drive offers robust storage, organization, and collaboration capabilities.

Learn how to integrate the Google Drive tool in Sim to effortlessly pull information from your Drive through your workflows. This tutorial walks you through connecting Google Drive, setting up data retrieval, and using stored documents and files to enhance automation. Perfect for syncing important data with your agents in real-time.

With Google Drive, you can:

  • Store files in the cloud: Upload and access your files from anywhere with internet access
  • Organize content: Create folders, use color coding, and implement naming conventions
  • Share and collaborate: Control access permissions and work simultaneously on files
  • Search efficiently: Find files quickly with Google's powerful search technology
  • Access across devices: Use Google Drive on desktop, mobile, and web platforms
  • Integrate with other services: Connect with Google Docs, Sheets, Slides, and third-party applications

In Sim, the Google Drive integration enables your agents to interact directly with your cloud storage programmatically. This allows for powerful automation scenarios such as file management, content organization, and document workflows. Your agents can upload new files to specific folders, download existing files to process their contents, and list folder contents to navigate your storage structure. This integration bridges the gap between your AI workflows and your document management system, enabling seamless file operations without manual intervention. By connecting Sim with Google Drive, you can automate file-based workflows, manage documents intelligently, and incorporate cloud storage operations into your agent's capabilities.

Usage Instructions

Integrate Google Drive into the workflow. Can create, upload, download, copy, move, delete, share files and manage permissions.

Tools

google_drive_list

List files and folders in Google Drive with complete metadata

Input

ParameterTypeRequiredDescription
folderSelectorstringNoSelect the folder to list files from
folderIdstringNoThe ID of the folder to list files from (internal use)
querystringNoSearch term to filter files by name (e.g. "budget" finds files with "budget" in the name). Do NOT use Google Drive query syntax here - just provide a plain search term.
pageSizenumberNoThe maximum number of files to return (default: 100)
pageTokenstringNoThe page token to use for pagination

Output

ParameterTypeDescription
filesarrayArray of file metadata objects from Google Drive
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
descriptionstringFile description
originalFilenamestringOriginal uploaded filename
fullFileExtensionstringFull file extension
fileExtensionstringFile extension
ownersjsonList of file owners
permissionsjsonFile permissions
permissionIdsjsonPermission IDs
sharedbooleanWhether file is shared
ownedByMebooleanWhether owned by current user
writersCanSharebooleanWhether writers can share
viewersCanCopyContentbooleanWhether viewers can copy
copyRequiresWriterPermissionbooleanWhether copy requires writer permission
sharingUserjsonUser who shared the file
starredbooleanWhether file is starred
trashedbooleanWhether file is in trash
explicitlyTrashedbooleanWhether explicitly trashed
appPropertiesjsonApp-specific properties
createdTimestringFile creation time
modifiedTimestringLast modification time
modifiedByMeTimestringWhen modified by current user
viewedByMeTimestringWhen last viewed by current user
sharedWithMeTimestringWhen shared with current user
lastModifyingUserjsonUser who last modified the file
viewedByMebooleanWhether viewed by current user
modifiedByMebooleanWhether modified by current user
webViewLinkstringURL to view in browser
webContentLinkstringDirect download URL
iconLinkstringURL to file icon
thumbnailLinkstringURL to thumbnail
exportLinksjsonExport format links
sizestringFile size in bytes
quotaBytesUsedstringStorage quota used
md5ChecksumstringMD5 hash
sha1ChecksumstringSHA-1 hash
sha256ChecksumstringSHA-256 hash
parentsjsonParent folder IDs
spacesjsonSpaces containing file
driveIdstringShared drive ID
capabilitiesjsonUser capabilities on file
versionstringVersion number
headRevisionIdstringHead revision ID
hasThumbnailbooleanWhether has thumbnail
thumbnailVersionstringThumbnail version
imageMediaMetadatajsonImage-specific metadata
videoMediaMetadatajsonVideo-specific metadata
isAppAuthorizedbooleanWhether created by requesting app
contentRestrictionsjsonContent restrictions
linkShareMetadatajsonLink share metadata
nextPageTokenstringToken for fetching the next page of results

google_drive_get_file

Get metadata for a specific file in Google Drive by its ID

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to retrieve

Output

ParameterTypeDescription
filejsonThe file metadata
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
descriptionstringFile description
sizestringFile size in bytes
starredbooleanWhether file is starred
trashedbooleanWhether file is in trash
webViewLinkstringURL to view in browser
webContentLinkstringDirect download URL
iconLinkstringURL to file icon
thumbnailLinkstringURL to thumbnail
parentsjsonParent folder IDs
ownersjsonList of file owners
permissionsjsonFile permissions
createdTimestringFile creation time
modifiedTimestringLast modification time
lastModifyingUserjsonUser who last modified the file
sharedbooleanWhether file is shared
ownedByMebooleanWhether owned by current user
capabilitiesjsonUser capabilities on file
md5ChecksumstringMD5 hash
versionstringVersion number

google_drive_create_folder

Create a new folder in Google Drive with complete metadata returned

Input

ParameterTypeRequiredDescription
fileNamestringYesName of the folder to create
folderSelectorstringNoSelect the parent folder to create the folder in
folderIdstringNoID of the parent folder (internal use)

Output

ParameterTypeDescription
fileobjectComplete created folder metadata from Google Drive
idstringGoogle Drive folder ID
kindstringResource type identifier
namestringFolder name
mimeTypestringMIME type (application/vnd.google-apps.folder)
descriptionstringFolder description
ownersjsonList of folder owners
permissionsjsonFolder permissions
permissionIdsjsonPermission IDs
sharedbooleanWhether folder is shared
ownedByMebooleanWhether owned by current user
writersCanSharebooleanWhether writers can share
viewersCanCopyContentbooleanWhether viewers can copy
copyRequiresWriterPermissionbooleanWhether copy requires writer permission
sharingUserjsonUser who shared the folder
starredbooleanWhether folder is starred
trashedbooleanWhether folder is in trash
explicitlyTrashedbooleanWhether explicitly trashed
appPropertiesjsonApp-specific properties
folderColorRgbstringFolder color
createdTimestringFolder creation time
modifiedTimestringLast modification time
modifiedByMeTimestringWhen modified by current user
viewedByMeTimestringWhen last viewed by current user
sharedWithMeTimestringWhen shared with current user
lastModifyingUserjsonUser who last modified the folder
viewedByMebooleanWhether viewed by current user
modifiedByMebooleanWhether modified by current user
webViewLinkstringURL to view in browser
iconLinkstringURL to folder icon
parentsjsonParent folder IDs
spacesjsonSpaces containing folder
driveIdstringShared drive ID
capabilitiesjsonUser capabilities on folder
versionstringVersion number
isAppAuthorizedbooleanWhether created by requesting app
contentRestrictionsjsonContent restrictions
linkShareMetadatajsonLink share metadata

google_drive_upload

Upload a file to Google Drive with complete metadata returned

Input

ParameterTypeRequiredDescription
fileNamestringYesThe name of the file to upload
filefileNoBinary file to upload (UserFile object)
contentstringNoText content to upload (use this OR file, not both)
mimeTypestringNoThe MIME type of the file to upload (auto-detected from file if not provided)
folderSelectorstringNoSelect the folder to upload the file to
folderIdstringNoThe ID of the folder to upload the file to (internal use)

Output

ParameterTypeDescription
fileobjectComplete uploaded file metadata from Google Drive
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
descriptionstringFile description
originalFilenamestringOriginal uploaded filename
fullFileExtensionstringFull file extension
fileExtensionstringFile extension
ownersjsonList of file owners
permissionsjsonFile permissions
permissionIdsjsonPermission IDs
sharedbooleanWhether file is shared
ownedByMebooleanWhether owned by current user
writersCanSharebooleanWhether writers can share
viewersCanCopyContentbooleanWhether viewers can copy
copyRequiresWriterPermissionbooleanWhether copy requires writer permission
sharingUserjsonUser who shared the file
starredbooleanWhether file is starred
trashedbooleanWhether file is in trash
explicitlyTrashedbooleanWhether explicitly trashed
appPropertiesjsonApp-specific properties
createdTimestringFile creation time
modifiedTimestringLast modification time
modifiedByMeTimestringWhen modified by current user
viewedByMeTimestringWhen last viewed by current user
sharedWithMeTimestringWhen shared with current user
lastModifyingUserjsonUser who last modified the file
viewedByMebooleanWhether viewed by current user
modifiedByMebooleanWhether modified by current user
webViewLinkstringURL to view in browser
webContentLinkstringDirect download URL
iconLinkstringURL to file icon
thumbnailLinkstringURL to thumbnail
exportLinksjsonExport format links
sizestringFile size in bytes
quotaBytesUsedstringStorage quota used
md5ChecksumstringMD5 hash
sha1ChecksumstringSHA-1 hash
sha256ChecksumstringSHA-256 hash
parentsjsonParent folder IDs
spacesjsonSpaces containing file
driveIdstringShared drive ID
capabilitiesjsonUser capabilities on file
versionstringVersion number
headRevisionIdstringHead revision ID
hasThumbnailbooleanWhether has thumbnail
thumbnailVersionstringThumbnail version
imageMediaMetadatajsonImage-specific metadata
videoMediaMetadatajsonVideo-specific metadata
isAppAuthorizedbooleanWhether created by requesting app
contentRestrictionsjsonContent restrictions
linkShareMetadatajsonLink share metadata

google_drive_download

Download a file from Google Drive with complete metadata (exports Google Workspace files automatically)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to download
mimeTypestringNoThe MIME type to export Google Workspace files to (optional)
fileNamestringNoOptional filename override
includeRevisionsbooleanNoWhether to include revision history in the metadata (default: true, returns first 100 revisions)

Output

ParameterTypeDescription
fileobjectDownloaded file data
namestringFile name
mimeTypestringMIME type of the file
datastringFile content as base64-encoded string
sizenumberFile size in bytes
metadataobjectComplete file metadata from Google Drive
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
descriptionstringFile description
originalFilenamestringOriginal uploaded filename
fullFileExtensionstringFull file extension
fileExtensionstringFile extension
ownersjsonList of file owners
permissionsjsonFile permissions
permissionIdsjsonPermission IDs
sharedbooleanWhether file is shared
ownedByMebooleanWhether owned by current user
writersCanSharebooleanWhether writers can share
viewersCanCopyContentbooleanWhether viewers can copy
copyRequiresWriterPermissionbooleanWhether copy requires writer permission
sharingUserjsonUser who shared the file
starredbooleanWhether file is starred
trashedbooleanWhether file is in trash
explicitlyTrashedbooleanWhether explicitly trashed
appPropertiesjsonApp-specific properties
createdTimestringFile creation time
modifiedTimestringLast modification time
modifiedByMeTimestringWhen modified by current user
viewedByMeTimestringWhen last viewed by current user
sharedWithMeTimestringWhen shared with current user
lastModifyingUserjsonUser who last modified the file
viewedByMebooleanWhether viewed by current user
modifiedByMebooleanWhether modified by current user
webViewLinkstringURL to view in browser
webContentLinkstringDirect download URL
iconLinkstringURL to file icon
thumbnailLinkstringURL to thumbnail
exportLinksjsonExport format links
sizestringFile size in bytes
quotaBytesUsedstringStorage quota used
md5ChecksumstringMD5 hash
sha1ChecksumstringSHA-1 hash
sha256ChecksumstringSHA-256 hash
parentsjsonParent folder IDs
spacesjsonSpaces containing file
driveIdstringShared drive ID
capabilitiesjsonUser capabilities on file
versionstringVersion number
headRevisionIdstringHead revision ID
hasThumbnailbooleanWhether has thumbnail
thumbnailVersionstringThumbnail version
imageMediaMetadatajsonImage-specific metadata
videoMediaMetadatajsonVideo-specific metadata
isAppAuthorizedbooleanWhether created by requesting app
contentRestrictionsjsonContent restrictions
linkShareMetadatajsonLink share metadata
revisionsjsonFile revision history (first 100 revisions only)

google_drive_copy

Create a copy of a file in Google Drive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to copy
newNamestringNoName for the copied file (defaults to "Copy of [original name]")
destinationFolderIdstringNoID of the folder to place the copy in (defaults to same location as original)

Output

ParameterTypeDescription
filejsonThe copied file metadata
idstringGoogle Drive file ID of the copy
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
webViewLinkstringURL to view in browser
parentsjsonParent folder IDs
createdTimestringFile creation time
modifiedTimestringLast modification time
ownersjsonList of file owners
sizestringFile size in bytes

google_drive_update

Update file metadata in Google Drive (rename, move, star, add description)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to update
namestringNoNew name for the file
descriptionstringNoNew description for the file
addParentsstringNoComma-separated list of parent folder IDs to add (moves file to these folders)
removeParentsstringNoComma-separated list of parent folder IDs to remove
starredbooleanNoWhether to star or unstar the file

Output

ParameterTypeDescription
filejsonThe updated file metadata
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
descriptionstringFile description
starredbooleanWhether file is starred
webViewLinkstringURL to view in browser
parentsjsonParent folder IDs
modifiedTimestringLast modification time

google_drive_trash

Move a file to the trash in Google Drive (can be restored later)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to move to trash

Output

ParameterTypeDescription
filejsonThe trashed file metadata
idstringGoogle Drive file ID
kindstringResource type identifier
namestringFile name
mimeTypestringMIME type
trashedbooleanWhether file is in trash (should be true)
trashedTimestringWhen file was trashed
webViewLinkstringURL to view in browser

google_drive_delete

Permanently delete a file from Google Drive (bypasses trash)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to permanently delete

Output

ParameterTypeDescription
deletedbooleanWhether the file was successfully deleted
fileIdstringThe ID of the deleted file

google_drive_share

Share a file with a user, group, domain, or make it public

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to share
typestringYesType of grantee: user, group, domain, or anyone
rolestringYesPermission role: owner (transfer ownership), organizer (shared drive only), fileOrganizer (shared drive only), writer (edit), commenter (view and comment), reader (view only)
emailstringNoEmail address of the user or group (required for type=user or type=group)
domainstringNoDomain to share with (required for type=domain)
transferOwnershipbooleanNoRequired when role is owner. Transfers ownership to the specified user.
moveToNewOwnersRootbooleanNoWhen transferring ownership, move the file to the new owner's My Drive root folder.
sendNotificationbooleanNoWhether to send an email notification (default: true)
emailMessagestringNoCustom message to include in the notification email

Output

ParameterTypeDescription
permissionjsonThe created permission details
idstringPermission ID
typestringGrantee type (user, group, domain, anyone)
rolestringPermission role
emailAddressstringEmail of the grantee
displayNamestringDisplay name of the grantee
domainstringDomain of the grantee
expirationTimestringExpiration time
deletedbooleanWhether grantee is deleted

google_drive_unshare

Remove a permission from a file (revoke access)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to modify permissions on
permissionIdstringYesThe ID of the permission to remove (use list_permissions to find this)

Output

ParameterTypeDescription
removedbooleanWhether the permission was successfully removed
fileIdstringThe ID of the file
permissionIdstringThe ID of the removed permission

google_drive_list_permissions

List all permissions (who has access) for a file in Google Drive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to list permissions for

Output

ParameterTypeDescription
permissionsarrayList of permissions on the file
idstringPermission ID (use to remove permission)
typestringGrantee type (user, group, domain, anyone)
rolestringPermission role (owner, organizer, fileOrganizer, writer, commenter, reader)
emailAddressstringEmail of the grantee
displayNamestringDisplay name of the grantee
photoLinkstringPhoto URL of the grantee
domainstringDomain of the grantee
expirationTimestringWhen permission expires
deletedbooleanWhether grantee account is deleted
allowFileDiscoverybooleanWhether file is discoverable by grantee
pendingOwnerbooleanWhether ownership transfer is pending
permissionDetailsjsonDetails about inherited permissions
nextPageTokenstringToken for fetching the next page of permissions

google_drive_get_about

Get information about the user and their Google Drive (storage quota, capabilities)

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
userjsonInformation about the authenticated user
displayNamestringUser display name
emailAddressstringUser email address
photoLinkstringURL to user profile photo
permissionIdstringUser permission ID
mebooleanWhether this is the authenticated user
storageQuotajsonStorage quota information in bytes
limitstringTotal storage limit in bytes (null for unlimited)
usagestringTotal storage used in bytes
usageInDrivestringStorage used by Drive files in bytes
usageInDriveTrashstringStorage used by trashed files in bytes
canCreateDrivesbooleanWhether user can create shared drives
importFormatsjsonMap of MIME types that can be imported and their target formats
exportFormatsjsonMap of Google Workspace MIME types and their exportable formats
maxUploadSizestringMaximum upload size in bytes
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started