Skip to content

Google Drive

The Google Drive connector indexes file and folder metadata into the local SQLite index and exposes read tools for listing, searching, and downloading files, plus four HITL-gated write tools for create / move / rename / trash.


  • Service id: google_drive
  • Item types: file, folder
Terminal window
nimbus connector auth google-drive

OAuth (Google). The Gateway resolves a short-lived access token per service via the per-service Google OAuth flow and injects it into the connector spawn as GOOGLE_OAUTH_ACCESS_TOKEN.

Tool Purpose
gdrive_file_download Download file bytes (base64) or text (utf-8 for text/*). Google Docs export to plain text; Sheets to CSV. Capped by maxBytes (default 256 KiB, max 16 MiB).
gdrive_file_list List Drive files (metadata only). Supports pagination via pageToken.
gdrive_file_metadata Get metadata for a single Drive file or folder (owners, parents, links, mimeType, description).
gdrive_file_search Full-text search over Drive (fullText contains). Non-trashed files only.

Every tool below requires interactive consent through the Gateway HITL gate before it executes.

Tool Purpose
gdrive_file_create Create a Drive file. Optional text content uses multipart upload.
gdrive_file_move Move a file or folder to another parent folder.
gdrive_file_rename Rename a Drive file or folder.
gdrive_file_trash Move a Drive file or folder to trash (recoverable).