Google Drive Block

The Google Drive block integrates Google Drive functionality into your workflow so you can manage files and folders directly. Use it to upload new files, create folders, and list folder contents via OAuth authentication, with support for custom MIME types and folder organization.

Overview

When to Use

• Upload generated content (text, reports, exported data) as a Google Doc, Sheet, Slides, or PDF.
• Create a new folder to organize files produced by a workflow run.
• List files inside a specific folder, optionally filtered by a search query.
• Save workflow outputs into a chosen parent folder using the visual folder selector or a manual folder ID.
• Programmatically organize Drive contents as part of a multi-step automation pipeline.
• Chain with other blocks to store agent-generated documents directly to Drive.

Configuration

Operation

Dropdown that selects what the block does. Defaults to create_folder.

Google Drive Account (credential)

Required. OAuth credential for the google-drive provider (scope https://www.googleapis.com/auth/drive.file). Connect your Google Drive account here.

Upload File fields (shown when operation = upload)

File Name (fileName)

Required. The name of the file to upload.

Content (content)

Required. The text content to write into the file.

MIME Type (mimeType)

The target file type for the uploaded content.

Select Parent Folder (folderSelector)

Visual folder picker (basic mode). Choose a parent folder for the uploaded file. Leave empty to upload to the root.

Parent Folder ID (manualFolderId)

Text input (advanced mode). Enter a folder ID manually to specify the upload destination. Leave empty for root.

Create Folder fields (shown when operation = create_folder)

Folder Name (fileName)

Required. The name for the new folder.

Select Parent Folder (folderSelector)

Visual folder picker (basic mode). Choose the parent folder that will contain the new folder.

Parent Folder ID (manualFolderId)

Text input (advanced mode). Enter a parent folder ID manually. Leave empty to create the folder in the root.

List Files fields (shown when operation = list)

Select Folder (folderSelector)

Visual folder picker (basic mode). Choose the folder whose contents to list.

Folder ID (manualFolderId)

Text input (advanced mode). Enter a folder ID manually. Leave empty to list root-level files.

Search Query (query)

Optional. A query string to filter results (e.g. name contains "report").

Results Per Page (pageSize)

Optional. Number of results to return. Default: 100, maximum: 1000.

Inputs & Outputs

• Inputs:
  • operation (string) — Operation to perform (create_folder, upload, or list)
  • credential (string) — Google Drive OAuth access token
  • fileName (string) — File or folder name (required for Upload File and Create Folder)
  • content (string) — File content to write (Upload File only)
  • mimeType (string) — Target MIME type for the uploaded file (Upload File only)
  • folderSelector (string) — Folder selected via the visual picker (basic mode)
  • manualFolderId (string) — Folder ID entered manually (advanced mode)
  • query (string) — Search query to filter listed files (List Files only)
  • pageSize (number) — Number of results per page (List Files only)
• Outputs:
  • file (json) — File or folder metadata returned after Upload File or Create Folder (includes id, name, mimeType, webViewLink, webContentLink, size, createdTime, modifiedTime, parents)
  • files (json) — Array of file/folder metadata objects returned by List Files (each item has id, name, mimeType, webViewLink, webContentLink, size, createdTime, modifiedTime, parents)

Tools

• Upload to Google Drive (google_drive_upload) — Creates a new file in Google Drive with the provided name, content, and MIME type. Supports plain text as well as Google Workspace formats (Doc, Sheet, Slides). Uploads content to the newly created file and returns the resulting file metadata.
• Create Folder in Google Drive (google_drive_create_folder) — Creates a new folder in Google Drive with the given name, optionally nested inside a specified parent folder. Returns the created folder's metadata.
• List Google Drive Files (google_drive_list) — Retrieves a paginated list of files and folders from a specified Drive folder (or the root). Supports filtering by name via a search query string and limits results with pageSize.

YAML Example

drive_upload:
  type: google_drive
  name: "Google Drive"
  inputs:
    operation: "upload"
    credential: "{{GOOGLE_DRIVE_ACCESS_TOKEN}}"
    fileName: "Weekly Report"
    content: "{{report_block.result}}"
    mimeType: "application/vnd.google-apps.document"
    manualFolderId: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs"
  connections:
    outgoing:
      - target: next-block-id