Caplets Catalog
official
spiritledsoftware/caplets

Google Drive

Search, read, download, upload, and manage Google Drive files through the Drive API Discovery document.

Install
caplets install spiritledsoftware/caplets google-drive

Inspect before installing

  • Can change external servicesThis Caplet may perform mutating operations against an external service.
  • Authentication requiredThis Caplet needs credentials or an auth flow before use.
CAPLET.md

Frontmatter

FieldValue
nameGoogle Drive
descriptionSearch, read, download, upload, and manage Google Drive files through the Drive API Discovery document.
tagsgoogle, drive, files
catalog.iconhttps://www.gstatic.com/images/branding/product/2x/drive_2020q4_48dp.png
googleDiscoveryApi.discoveryUrlhttps://www.googleapis.com/discovery/v1/apis/drive/v3/rest
googleDiscoveryApi.includeOperationsdrive.files.list, drive.files.get, drive.files.export, drive.files.download, drive.files.create, drive.files.update, drive.files.copy, drive.files.delete, drive.files.generateIds
googleDiscoveryApi.auth.typeoauth2
googleDiscoveryApi.auth.issuerhttps://accounts.google.com
googleDiscoveryApi.auth.clientId$vault:GOOGLE_CLIENT_ID
googleDiscoveryApi.auth.clientSecret$vault:GOOGLE_CLIENT_SECRET
googleDiscoveryApi.auth.scopeshttps://www.googleapis.com/auth/drive.file

Google Drive

Use this Caplet when an agent needs Drive files as context or needs to create/update files with explicit user direction.

First Workflow

  1. Search accessible file metadata first by name, owner, MIME type, folder, modified time, or shared-drive context.
  2. Confirm the exact file ID before reading, downloading, updating, moving, trashing, or deleting.
  3. Read or download only the files needed for the task.
  4. Prefer creating a new file or draft copy before overwriting an existing shared document.

Operate Carefully

  • Drive files may contain private, shared, or regulated information. Keep reads narrow and summarize only what is needed.
  • This Caplet uses the restricted drive.file scope, so it is intended for files the app created or files the user explicitly opens or grants to the app.
  • It does not expose Drive-wide sharing, permissions, comments, approvals, shared-drive administration, or trash-emptying operations; create a private variant if those are required.
  • Prefer repository files when the user is asking about local project state.