Skip to main content

Overview

Enable your agents to manage files and folders through Google Drive. Upload, download, organize, and share files, create folders, and streamline your document management workflows with AI-powered automation.

Prerequisites

Before using the Google Drive integration, ensure you have:
  • A CrewAI AMP account with an active subscription
  • A Google account with Google Drive access
  • Connected your Google account through the Integrations page

Setting Up Google Drive Integration

1. Connect Your Google Account

  1. Navigate to CrewAI AMP Integrations
  2. Find Google Drive in the Authentication Integrations section
  3. Click Connect and complete the OAuth flow
  4. Grant the necessary permissions for file and folder management
  5. Copy your Enterprise Token from Integration Settings

2. Install Required Package

3. Environment Variable Setup

To use integrations with Agent(apps=[]), you must set the CREWAI_PLATFORM_INTEGRATION_TOKEN environment variable with your Enterprise Token.
Or add it to your .env file:

Available Actions

Description: Get a file by ID from Google Drive.Parameters:
  • file_id (string, required): The ID of the file to retrieve.
Description: List files in Google Drive.Parameters:
  • q (string, optional): Query string to filter files (example: “name contains ‘report’”).
  • page_size (integer, optional): Maximum number of files to return (default: 100, max: 1000).
  • page_token (string, optional): Token for retrieving the next page of results.
  • order_by (string, optional): Sort order (example: “name”, “createdTime desc”, “modifiedTime”).
  • spaces (string, optional): Comma-separated list of spaces to query (drive, appDataFolder, photos).
Description: Upload a file to Google Drive.Parameters:
  • name (string, required): Name of the file to create.
  • content (string, required): Content of the file to upload.
  • mime_type (string, optional): MIME type of the file (example: “text/plain”, “application/pdf”).
  • parent_folder_id (string, optional): ID of the parent folder where the file should be created.
  • description (string, optional): Description of the file.
Description: Download a file from Google Drive.Parameters:
  • file_id (string, required): The ID of the file to download.
  • mime_type (string, optional): MIME type for export (required for Google Workspace documents).
Description: Create a new folder in Google Drive.Parameters:
  • name (string, required): Name of the folder to create.
  • parent_folder_id (string, optional): ID of the parent folder where the new folder should be created.
  • description (string, optional): Description of the folder.
Description: Delete a file from Google Drive.Parameters:
  • file_id (string, required): The ID of the file to delete.
Description: Share a file in Google Drive with specific users or make it public.Parameters:
  • file_id (string, required): The ID of the file to share.
  • role (string, required): The role granted by this permission (reader, writer, commenter, owner).
  • type (string, required): The type of the grantee (user, group, domain, anyone).
  • email_address (string, optional): The email address of the user or group to share with (required for user/group types).
  • domain (string, optional): The domain to share with (required for domain type).
  • send_notification_email (boolean, optional): Whether to send a notification email (default: true).
  • email_message (string, optional): A plain text custom message to include in the notification email.
Description: Update an existing file in Google Drive.Parameters:
  • file_id (string, required): The ID of the file to update.
  • name (string, optional): New name for the file.
  • content (string, optional): New content for the file.
  • mime_type (string, optional): New MIME type for the file.
  • description (string, optional): New description for the file.
  • add_parents (string, optional): Comma-separated list of parent folder IDs to add.
  • remove_parents (string, optional): Comma-separated list of parent folder IDs to remove.

Usage Examples

Basic Google Drive Agent Setup

Filtering Specific Google Drive Tools

Advanced File Management