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, and list files.
Tools
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 | Select the folder to upload the file to |
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 |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ kind | string | Resource type identifier |
↳ 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_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 | Select the parent folder to create the folder in |
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 |
↳ name | string | Folder name |
↳ mimeType | string | MIME type (application/vnd.google-apps.folder) |
↳ kind | string | Resource type identifier |
↳ 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_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 | object | Downloaded file data |
↳ name | string | File name |
↳ mimeType | string | MIME type of the file |
↳ data | string | File content as base64-encoded string |
↳ size | number | File size in bytes |
metadata | object | Complete file metadata from Google Drive |
↳ id | string | Google Drive file ID |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ kind | string | Resource type identifier |
↳ 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_list
List files and folders in Google Drive with complete metadata
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
folderSelector | string | No | Select the folder to list files from |
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 |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ kind | string | Resource type identifier |
↳ 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 |
