Connect your Google Drive account to Goodweek to access, upload, and manage files and folders stored in Google Drive directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Google Drive, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Google Drive integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
Personal Google accounts (@gmail.com)
No admin setup required. Connect directly following the User Connection steps below.
Google Workspace accounts (work or school)
Google Drive requests broad file access scopes, which are commonly flagged by Google Workspace admins as high-risk. This makes admin restriction more likely for Drive than for other Google integrations.
Scenario 1 — Default (unrestricted third-party access)
Any user can connect directly without admin intervention.
Scenario 2 — Third-party access is restricted (admin_policy_enforced error)
A Google Workspace Super Admin must mark Composio as a trusted app:
Log in to admin.google.com as a Super Admin.
Go to Security → Access and data control → API controls → Manage Third-Party App Access.
Click Configure new app, search for Composio, select it, set access to Trusted, and click Save.
Scenario 3 — All third-party API access is blocked
Go to admin.google.com → Security → API controls and review the "Third-party app access to Google APIs" setting. If blocked, the admin must create an exception for Composio before following Scenario 2.
User Connection
In Goodweek, go to Integrations.
Find Google Drive and click Connect.
You will be redirected to Google, where you will be asked to sign in.
Review the requested permissions and click Allow to return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the files and folders that your individual user account has permission to see. Shared files are accessible only if you have been granted the appropriate sharing permissions.
If you have multiple Google accounts, make sure you select the correct one during the connection step.
You can revoke Goodweek's access at any time from myaccount.google.com → Security → Third-party apps with account access.
Available Tools
Tool | Description | Type |
Find File | Comprehensive search across Google Drive for files and folders by name, type, content, and other filters. | Read |
Find Folder | Finds folders by name within a parent folder in Google Drive. | Read |
Get File Metadata | Retrieves a file's metadata by ID, including type, parent folders, and trashed status. | Read |
Download a File from Google Drive | Downloads a file from Google Drive by its ID, with optional export format for Google Workspace documents. | Read |
Export Google Workspace File | Exports a Google Workspace document (Docs, Sheets, Slides) to a requested MIME type such as PDF or DOCX. | Read |
Create File or Folder | Creates a new file or folder in Google Drive, with support for metadata-only creation and file upload with content. | Write |
Create a File from Text | Creates a new file in Google Drive from provided text content, with optional conversion to Google Workspace formats. | Write |
Create a Folder | Creates a new folder in Google Drive, optionally within an existing parent folder. | Write |
Upload File | Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root. | Write |
Upload File from URL to Drive | Fetches a file from a public URL and uploads it directly into Google Drive. | Write |
Upload/Update File Content | Replaces the contents of an existing file in Google Drive with new content. | Write |
Edit File | Updates an existing Google Drive text file by overwriting its entire content (max 10MB). | Read |
Move File | Moves a file from one folder to another in Google Drive. | Read |
Copy File with Advanced Options | Creates a copy of a file with optional updates applied using patch semantics. | Read |
Create Shortcut to File/Folder | Creates a shortcut to an existing Drive item from another location without duplicating it. | Write |
Create Permission | Shares a file or folder with a user, group, or domain by creating a new permission. | Write |
Create Permissions Batch | Creates multiple sharing permissions for files or shared drives in a single batch request. | Write |
List Permissions | Retrieves all permissions associated with a specific file or shared drive. | Read |
Update Permission | Modifies an existing sharing permission for a file or shared drive. | Write |
Create Comment | Creates a comment on a Google Drive file. | Write |
List Comments | Lists all comments on a file in Google Drive with pagination. | Read |
Update Comment | Updates the content of an existing comment on a Google Drive file. | Write |
Create Reply | Creates a reply to a comment on a Google Drive file. | Write |
List File Revisions | Lists a file's revision history metadata in Google Drive. | Read |
Create Shared Drive | Creates a new shared drive for team collaboration. | Write |
List Shared Drives | Lists all shared drives accessible to the authenticated user. | Read |
Untrash File | Restores a file from the trash. | Write |
Get About | Retrieves information about the user, their Drive storage quota, and system capabilities. | Read |
Delete Permission | Revokes a sharing permission from a file. This action is irreversible. | ⚠️ Destructive |
Trash File | Moves a file or folder to trash (soft delete, recoverable). | ⚠️ Destructive |
Delete Folder or File | Permanently deletes a file or folder from Google Drive. This action is irreversible. | ⚠️ Destructive |
Empty Trash | Permanently and irreversibly deletes all trashed files in the user's Google Drive. | ⚠️ Destructive |
Use Cases
Find and retrieve files on demand. Search across your Google Drive by name, type, or content and bring file metadata or content into a Goodweek conversation without navigating the Drive UI.
Upload and organise files into Drive. Upload new files to a specific folder, create folder structures, or move existing files between locations from Goodweek.
Share files with specific people or teams. Grant or update sharing permissions on files and folders directly from Goodweek, without opening Drive settings manually.
Export Google Workspace documents. Export a Google Doc, Sheet, or Slide to PDF or another format directly from Goodweek for sharing or archiving.
Troubleshooting
"Error 400: admin_policy_enforced" when connecting
Your organization's admin has restricted third-party app access. Google Drive's broad file access scopes make this especially common. Only a Google Workspace Super Admin can resolve this by following Scenario 2 above.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Google Drive integration from the Goodweek Admin Panel under the Integrations tab.