You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
import { BlockInfoCard } from "@/components/ui/block-info-card"
{/* MANUAL-CONTENT-START:intro */}
Google Drive is Google’s cloud-based file storage and synchronization service, making it easy to store, manage, share, and access files securely across devices and platforms. As a core element of Google Workspace, Google Drive offers robust tools for file organization, collaboration, and seamless integration with the broader productivity suite.
Google Drive enables individuals and teams to:
Store files in the cloud: Access documents, images, videos, and more from anywhere with internet connectivity.
Organize and manage content: Create and arrange folders, use naming conventions, and leverage search for fast retrieval.
Share and collaborate: Control file and folder permissions, share with individuals or groups, and collaborate in real time.
Leverage powerful search: Quickly locate files using Google’s search technology.
Access across devices: Work with your files on desktop, mobile, or web with full synchronization.
Integrate deeply across Google services: Connect with Google Docs, Sheets, Slides, and partner applications in your workflows.
In Sim, the Google Drive integration allows your agents to read, upload, download, list, and organize your Drive files programmatically. Agents can automate file management, streamline content workflows, and enable no-code automation around document storage and retrieval. By connecting Sim with Google Drive, you empower your agents to incorporate cloud file operations directly into intelligent business processes.
{/* MANUAL-CONTENT-END */}
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
Parameter
Type
Required
Description
folderSelector
string
No
Google Drive folder ID to list files from (e.g., 1ABCxyz...)
folderId
string
No
The ID of the folder to list files from (internal use)
query
string
No
Search 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.
pageSize
number
No
The maximum number of files to return (default: 100)
pageToken
string
No
The page token to use for pagination
Output
Parameter
Type
Description
files
array
Array of file metadata objects from Google Drive
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ originalFilename
string
Original uploaded filename
↳ fullFileExtension
string
Full file extension
↳ fileExtension
string
File extension
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ permissionIds
json
Permission IDs
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ writersCanShare
boolean
Whether writers can share
↳ viewersCanCopyContent
boolean
Whether viewers can copy
↳ copyRequiresWriterPermission
boolean
Whether copy requires writer permission
↳ sharingUser
json
User who shared the file
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ explicitlyTrashed
boolean
Whether explicitly trashed
↳ appProperties
json
App-specific properties
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ modifiedByMeTime
string
When modified by current user
↳ viewedByMeTime
string
When last viewed by current user
↳ sharedWithMeTime
string
When shared with current user
↳ lastModifyingUser
json
User who last modified the file
↳ viewedByMe
boolean
Whether viewed by current user
↳ modifiedByMe
boolean
Whether modified by current user
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ exportLinks
json
Export format links
↳ size
string
File size in bytes
↳ quotaBytesUsed
string
Storage quota used
↳ md5Checksum
string
MD5 hash
↳ sha1Checksum
string
SHA-1 hash
↳ sha256Checksum
string
SHA-256 hash
↳ parents
json
Parent folder IDs
↳ spaces
json
Spaces containing file
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on file
↳ version
string
Version number
↳ headRevisionId
string
Head revision ID
↳ hasThumbnail
boolean
Whether has thumbnail
↳ thumbnailVersion
string
Thumbnail version
↳ imageMediaMetadata
json
Image-specific metadata
↳ videoMediaMetadata
json
Video-specific metadata
↳ isAppAuthorized
boolean
Whether created by requesting app
↳ contentRestrictions
json
Content restrictions
↳ linkShareMetadata
json
Link share metadata
nextPageToken
string
Token for fetching the next page of results
google_drive_get_file
Get metadata for a specific file in Google Drive by its ID
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to retrieve
Output
Parameter
Type
Description
file
json
The file metadata
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ size
string
File size in bytes
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ parents
json
Parent folder IDs
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ lastModifyingUser
json
User who last modified the file
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ capabilities
json
User capabilities on file
↳ md5Checksum
string
MD5 hash
↳ version
string
Version number
google_drive_get_content
Get content from a file in Google Drive with complete metadata (exports Google Workspace files automatically)
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to get content from
mimeType
string
No
The MIME type to export Google Workspace files to (optional)
includeRevisions
boolean
No
Whether to include revision history in the metadata (default: true, returns first 100 revisions)
Output
Parameter
Type
Description
content
string
File content as text (Google Workspace files are exported)
metadata
object
Complete file metadata from Google Drive
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ originalFilename
string
Original uploaded filename
↳ fullFileExtension
string
Full file extension
↳ fileExtension
string
File extension
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ permissionIds
json
Permission IDs
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ writersCanShare
boolean
Whether writers can share
↳ viewersCanCopyContent
boolean
Whether viewers can copy
↳ copyRequiresWriterPermission
boolean
Whether copy requires writer permission
↳ sharingUser
json
User who shared the file
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ explicitlyTrashed
boolean
Whether explicitly trashed
↳ appProperties
json
App-specific properties
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ modifiedByMeTime
string
When modified by current user
↳ viewedByMeTime
string
When last viewed by current user
↳ sharedWithMeTime
string
When shared with current user
↳ lastModifyingUser
json
User who last modified the file
↳ viewedByMe
boolean
Whether viewed by current user
↳ modifiedByMe
boolean
Whether modified by current user
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ exportLinks
json
Export format links
↳ size
string
File size in bytes
↳ quotaBytesUsed
string
Storage quota used
↳ md5Checksum
string
MD5 hash
↳ sha1Checksum
string
SHA-1 hash
↳ sha256Checksum
string
SHA-256 hash
↳ parents
json
Parent folder IDs
↳ spaces
json
Spaces containing file
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on file
↳ version
string
Version number
↳ headRevisionId
string
Head revision ID
↳ hasThumbnail
boolean
Whether has thumbnail
↳ thumbnailVersion
string
Thumbnail version
↳ imageMediaMetadata
json
Image-specific metadata
↳ videoMediaMetadata
json
Video-specific metadata
↳ isAppAuthorized
boolean
Whether created by requesting app
↳ contentRestrictions
json
Content restrictions
↳ linkShareMetadata
json
Link share metadata
↳ revisions
json
File revision history (first 100 revisions only)
google_drive_create_folder
Create a new folder in Google Drive with complete metadata returned
Input
Parameter
Type
Required
Description
fileName
string
Yes
Name of the folder to create
folderSelector
string
No
Google Drive parent folder ID to create the folder in (e.g., 1ABCxyz...)
folderId
string
No
ID of the parent folder (internal use)
Output
Parameter
Type
Description
file
object
Complete created folder metadata from Google Drive
↳ id
string
Google Drive folder ID
↳ kind
string
Resource type identifier
↳ name
string
Folder name
↳ mimeType
string
MIME type (application/vnd.google-apps.folder)
↳ description
string
Folder description
↳ owners
json
List of folder owners
↳ permissions
json
Folder permissions
↳ permissionIds
json
Permission IDs
↳ shared
boolean
Whether folder is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ writersCanShare
boolean
Whether writers can share
↳ viewersCanCopyContent
boolean
Whether viewers can copy
↳ copyRequiresWriterPermission
boolean
Whether copy requires writer permission
↳ sharingUser
json
User who shared the folder
↳ starred
boolean
Whether folder is starred
↳ trashed
boolean
Whether folder is in trash
↳ explicitlyTrashed
boolean
Whether explicitly trashed
↳ appProperties
json
App-specific properties
↳ folderColorRgb
string
Folder color
↳ createdTime
string
Folder creation time
↳ modifiedTime
string
Last modification time
↳ modifiedByMeTime
string
When modified by current user
↳ viewedByMeTime
string
When last viewed by current user
↳ sharedWithMeTime
string
When shared with current user
↳ lastModifyingUser
json
User who last modified the folder
↳ viewedByMe
boolean
Whether viewed by current user
↳ modifiedByMe
boolean
Whether modified by current user
↳ webViewLink
string
URL to view in browser
↳ iconLink
string
URL to folder icon
↳ parents
json
Parent folder IDs
↳ spaces
json
Spaces containing folder
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on folder
↳ version
string
Version number
↳ isAppAuthorized
boolean
Whether created by requesting app
↳ contentRestrictions
json
Content restrictions
↳ linkShareMetadata
json
Link share metadata
google_drive_upload
Upload a file to Google Drive with complete metadata returned
Input
Parameter
Type
Required
Description
fileName
string
Yes
The name of the file to upload
file
file
No
Binary file to upload (UserFile object)
content
string
No
Text content to upload (use this OR file, not both)
mimeType
string
No
The MIME type of the file to upload (auto-detected from file if not provided)
folderSelector
string
No
Google Drive folder ID to upload the file to (e.g., 1ABCxyz...)
folderId
string
No
The ID of the folder to upload the file to (internal use)
Output
Parameter
Type
Description
file
object
Complete uploaded file metadata from Google Drive
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ originalFilename
string
Original uploaded filename
↳ fullFileExtension
string
Full file extension
↳ fileExtension
string
File extension
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ permissionIds
json
Permission IDs
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ writersCanShare
boolean
Whether writers can share
↳ viewersCanCopyContent
boolean
Whether viewers can copy
↳ copyRequiresWriterPermission
boolean
Whether copy requires writer permission
↳ sharingUser
json
User who shared the file
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ explicitlyTrashed
boolean
Whether explicitly trashed
↳ appProperties
json
App-specific properties
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ modifiedByMeTime
string
When modified by current user
↳ viewedByMeTime
string
When last viewed by current user
↳ sharedWithMeTime
string
When shared with current user
↳ lastModifyingUser
json
User who last modified the file
↳ viewedByMe
boolean
Whether viewed by current user
↳ modifiedByMe
boolean
Whether modified by current user
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ exportLinks
json
Export format links
↳ size
string
File size in bytes
↳ quotaBytesUsed
string
Storage quota used
↳ md5Checksum
string
MD5 hash
↳ sha1Checksum
string
SHA-1 hash
↳ sha256Checksum
string
SHA-256 hash
↳ parents
json
Parent folder IDs
↳ spaces
json
Spaces containing file
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on file
↳ version
string
Version number
↳ headRevisionId
string
Head revision ID
↳ hasThumbnail
boolean
Whether has thumbnail
↳ thumbnailVersion
string
Thumbnail version
↳ imageMediaMetadata
json
Image-specific metadata
↳ videoMediaMetadata
json
Video-specific metadata
↳ isAppAuthorized
boolean
Whether created by requesting app
↳ contentRestrictions
json
Content restrictions
↳ linkShareMetadata
json
Link share metadata
google_drive_download
Download a file from Google Drive with complete metadata (exports Google Workspace files automatically)
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to download
mimeType
string
No
The MIME type to export Google Workspace files to (optional)
fileName
string
No
Optional filename override
includeRevisions
boolean
No
Whether to include revision history in the metadata (default: true, returns first 100 revisions)
Output
Parameter
Type
Description
file
file
Downloaded file stored in execution files
metadata
object
Complete file metadata from Google Drive
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ originalFilename
string
Original uploaded filename
↳ fullFileExtension
string
Full file extension
↳ fileExtension
string
File extension
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ permissionIds
json
Permission IDs
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ writersCanShare
boolean
Whether writers can share
↳ viewersCanCopyContent
boolean
Whether viewers can copy
↳ copyRequiresWriterPermission
boolean
Whether copy requires writer permission
↳ sharingUser
json
User who shared the file
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ explicitlyTrashed
boolean
Whether explicitly trashed
↳ appProperties
json
App-specific properties
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ modifiedByMeTime
string
When modified by current user
↳ viewedByMeTime
string
When last viewed by current user
↳ sharedWithMeTime
string
When shared with current user
↳ lastModifyingUser
json
User who last modified the file
↳ viewedByMe
boolean
Whether viewed by current user
↳ modifiedByMe
boolean
Whether modified by current user
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ exportLinks
json
Export format links
↳ size
string
File size in bytes
↳ quotaBytesUsed
string
Storage quota used
↳ md5Checksum
string
MD5 hash
↳ sha1Checksum
string
SHA-1 hash
↳ sha256Checksum
string
SHA-256 hash
↳ parents
json
Parent folder IDs
↳ spaces
json
Spaces containing file
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on file
↳ version
string
Version number
↳ headRevisionId
string
Head revision ID
↳ hasThumbnail
boolean
Whether has thumbnail
↳ thumbnailVersion
string
Thumbnail version
↳ imageMediaMetadata
json
Image-specific metadata
↳ videoMediaMetadata
json
Video-specific metadata
↳ isAppAuthorized
boolean
Whether created by requesting app
↳ contentRestrictions
json
Content restrictions
↳ linkShareMetadata
json
Link share metadata
↳ revisions
json
File revision history (first 100 revisions only)
google_drive_copy
Create a copy of a file in Google Drive
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to copy
newName
string
No
Name for the copied file (defaults to "Copy of [original name]")
destinationFolderId
string
No
ID of the folder to place the copy in (defaults to same location as original)
Output
Parameter
Type
Description
file
json
The copied file metadata
↳ id
string
Google Drive file ID of the copy
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ webViewLink
string
URL to view in browser
↳ parents
json
Parent folder IDs
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ owners
json
List of file owners
↳ size
string
File size in bytes
google_drive_move
Move a file or folder to a different folder in Google Drive
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file or folder to move
destinationFolderId
string
Yes
The ID of the destination folder
removeFromCurrent
boolean
No
Whether to remove the file from its current parent folder (default: true). Set to false to add the file to the destination without removing it from the current location.
Output
Parameter
Type
Description
file
json
The moved file metadata
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ webViewLink
string
URL to view in browser
↳ parents
json
Parent folder IDs
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ owners
json
List of file owners
↳ size
string
File size in bytes
google_drive_search
Search for files in Google Drive using advanced query syntax (e.g., fullText contains, mimeType, modifiedTime, etc.)
Input
Parameter
Type
Required
Description
query
string
Yes
Google Drive query string using advanced search syntax (e.g., "fullText contains 'budget'", "mimeType = 'application/pdf'", "modifiedTime > '2024-01-01'")
pageSize
number
No
Maximum number of files to return (default: 100)
pageToken
string
No
Token for fetching the next page of results
Output
Parameter
Type
Description
files
array
Array of file metadata objects matching the search query
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ originalFilename
string
Original uploaded filename
↳ fullFileExtension
string
Full file extension
↳ fileExtension
string
File extension
↳ owners
json
List of file owners
↳ permissions
json
File permissions
↳ shared
boolean
Whether file is shared
↳ ownedByMe
boolean
Whether owned by current user
↳ starred
boolean
Whether file is starred
↳ trashed
boolean
Whether file is in trash
↳ createdTime
string
File creation time
↳ modifiedTime
string
Last modification time
↳ lastModifyingUser
json
User who last modified the file
↳ webViewLink
string
URL to view in browser
↳ webContentLink
string
Direct download URL
↳ iconLink
string
URL to file icon
↳ thumbnailLink
string
URL to thumbnail
↳ size
string
File size in bytes
↳ parents
json
Parent folder IDs
↳ driveId
string
Shared drive ID
↳ capabilities
json
User capabilities on file
↳ version
string
Version number
nextPageToken
string
Token for fetching the next page of results
google_drive_update
Update file metadata in Google Drive (rename, move, star, add description)
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to update
name
string
No
New name for the file
description
string
No
New description for the file
addParents
string
No
Comma-separated list of parent folder IDs to add (moves file to these folders)
removeParents
string
No
Comma-separated list of parent folder IDs to remove
starred
boolean
No
Whether to star or unstar the file
Output
Parameter
Type
Description
file
json
The updated file metadata
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ description
string
File description
↳ starred
boolean
Whether file is starred
↳ webViewLink
string
URL to view in browser
↳ parents
json
Parent folder IDs
↳ modifiedTime
string
Last modification time
google_drive_trash
Move a file to the trash in Google Drive (can be restored later)
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to move to trash
Output
Parameter
Type
Description
file
json
The trashed file metadata
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ trashed
boolean
Whether file is in trash (should be true)
↳ trashedTime
string
When file was trashed
↳ webViewLink
string
URL to view in browser
google_drive_untrash
Restore a file from the trash in Google Drive
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to restore from trash
Output
Parameter
Type
Description
file
json
The restored file metadata
↳ id
string
Google Drive file ID
↳ kind
string
Resource type identifier
↳ name
string
File name
↳ mimeType
string
MIME type
↳ trashed
boolean
Whether file is in trash (should be false)
↳ webViewLink
string
URL to view in browser
↳ parents
json
Parent folder IDs
google_drive_delete
Permanently delete a file from Google Drive (bypasses trash)
Input
Parameter
Type
Required
Description
fileId
string
Yes
The ID of the file to permanently delete
Output
Parameter
Type
Description
deleted
boolean
Whether the file was successfully deleted
fileId
string
The ID of the deleted file
google_drive_share
Share a file with a user, group, domain, or make it public