Google Workspace

Search, read, create, and update Gmail, Drive, Docs, Sheets, Slides, and Tasks through one Workspace capability suite.

Install

caplets install spiritledsoftware/caplets google-workspace

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

Field	Value
`name`	Google Workspace
`description`	Search, read, create, and update Gmail, Drive, Docs, Sheets, Slides, and Tasks through one Workspace capability suite.
`tags`	google, workspace, productivity, email, files
`catalog.icon`	https://workspace.google.com/favicon.ico
`useWhen`	Coordinate work across Google mail, files, documents, spreadsheets, presentations, and tasks.
`avoidWhen`	Use a focused Google Caplet when the task only needs one Workspace surface.
`googleDiscoveryApis.gmail.name`	Gmail
`googleDiscoveryApis.gmail.description`	Search, read, label, draft, and send Gmail messages.
`googleDiscoveryApis.gmail.discoveryUrl`	https://gmail.googleapis.com/$discovery/rest?version=v1
`googleDiscoveryApis.gmail.includeOperations`	gmail.users.getProfile, gmail.users.labels.list, gmail.users.labels.get, gmail.users.labels.create, gmail.users.labels.patch, gmail.users.labels.update, gmail.users.messages.list, gmail.users.messages.get, gmail.users.messages.attachments.get, gmail.users.messages.modify, gmail.users.messages.send, gmail.users.threads.list, gmail.users.threads.get, gmail.users.threads.modify, gmail.users.drafts.list, gmail.users.drafts.get, gmail.users.drafts.create, gmail.users.drafts.update, gmail.users.drafts.send
`googleDiscoveryApis.gmail.auth.type`	oauth2
`googleDiscoveryApis.gmail.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.gmail.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.gmail.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.gmail.auth.scopes`	https://www.googleapis.com/auth/gmail.modify
`googleDiscoveryApis.drive.name`	Google Drive
`googleDiscoveryApis.drive.description`	Search, read, download, upload, and manage Drive files.
`googleDiscoveryApis.drive.discoveryUrl`	https://www.googleapis.com/discovery/v1/apis/drive/v3/rest
`googleDiscoveryApis.drive.includeOperations`	drive.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
`googleDiscoveryApis.drive.auth.type`	oauth2
`googleDiscoveryApis.drive.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.drive.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.drive.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.drive.auth.scopes`	https://www.googleapis.com/auth/drive.file
`googleDiscoveryApis.docs.name`	Google Docs
`googleDiscoveryApis.docs.description`	Read, create, and edit Google Docs documents.
`googleDiscoveryApis.docs.discoveryUrl`	https://docs.googleapis.com/$discovery/rest?version=v1
`googleDiscoveryApis.docs.includeOperations`	docs.documents.get, docs.documents.create, docs.documents.batchUpdate
`googleDiscoveryApis.docs.auth.type`	oauth2
`googleDiscoveryApis.docs.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.docs.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.docs.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.docs.auth.scopes`	https://www.googleapis.com/auth/documents
`googleDiscoveryApis.sheets.name`	Google Sheets
`googleDiscoveryApis.sheets.description`	Read, create, and update Google Sheets spreadsheets.
`googleDiscoveryApis.sheets.discoveryUrl`	https://sheets.googleapis.com/$discovery/rest?version=v4
`googleDiscoveryApis.sheets.includeOperations`	sheets.spreadsheets.get, sheets.spreadsheets.getByDataFilter, sheets.spreadsheets.create, sheets.spreadsheets.batchUpdate, sheets.spreadsheets.developerMetadata.search, sheets.spreadsheets.values.get, sheets.spreadsheets.values.batchGet, sheets.spreadsheets.values.batchGetByDataFilter, sheets.spreadsheets.values.update, sheets.spreadsheets.values.batchUpdate, sheets.spreadsheets.values.append, sheets.spreadsheets.values.clear
`googleDiscoveryApis.sheets.auth.type`	oauth2
`googleDiscoveryApis.sheets.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.sheets.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.sheets.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.sheets.auth.scopes`	https://www.googleapis.com/auth/drive.file
`googleDiscoveryApis.slides.name`	Google Slides
`googleDiscoveryApis.slides.description`	Read, create, preview, and edit Google Slides presentations.
`googleDiscoveryApis.slides.discoveryUrl`	https://slides.googleapis.com/$discovery/rest?version=v1
`googleDiscoveryApis.slides.includeOperations`	slides.presentations.get, slides.presentations.pages.get, slides.presentations.pages.getThumbnail, slides.presentations.create, slides.presentations.batchUpdate
`googleDiscoveryApis.slides.auth.type`	oauth2
`googleDiscoveryApis.slides.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.slides.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.slides.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.slides.auth.scopes`	https://www.googleapis.com/auth/drive.file
`googleDiscoveryApis.tasks.name`	Google Tasks
`googleDiscoveryApis.tasks.description`	Read, create, update, organize, and complete Google Tasks.
`googleDiscoveryApis.tasks.discoveryUrl`	https://www.googleapis.com/discovery/v1/apis/tasks/v1/rest
`googleDiscoveryApis.tasks.includeOperations`	tasks.tasklists.list, tasks.tasklists.get, tasks.tasklists.insert, tasks.tasklists.patch, tasks.tasklists.update, tasks.tasks.list, tasks.tasks.get, tasks.tasks.insert, tasks.tasks.patch, tasks.tasks.update, tasks.tasks.move
`googleDiscoveryApis.tasks.auth.type`	oauth2
`googleDiscoveryApis.tasks.auth.issuer`	https://accounts.google.com
`googleDiscoveryApis.tasks.auth.clientId`	$vault:GOOGLE_CLIENT_ID
`googleDiscoveryApis.tasks.auth.clientSecret`	$vault:GOOGLE_CLIENT_SECRET
`googleDiscoveryApis.tasks.auth.scopes`	https://www.googleapis.com/auth/tasks

Google Workspace

Use this Caplet when an agent needs to coordinate work across Gmail, Drive, Docs, Sheets, Slides, and Tasks from one installable Workspace capability.

First Workflow

Start by identifying which Workspace surface owns the source of truth: mail, file metadata, document content, spreadsheet data, deck content, or task state.
Search or inspect metadata before reading large content bodies.
Use the child runtime handles deliberately: google-workspace__gmail, google-workspace__drive, google-workspace__docs, google-workspace__sheets, google-workspace__slides, or google-workspace__tasks.
Prefer read-only inspection before creating, updating, sending, deleting, clearing, or completing anything.
Confirm file IDs, document IDs, spreadsheet ranges, slide/page element IDs, message/thread IDs, labels, recipients, tasklists, and task IDs before mutating live state.

Operate Carefully

Workspace data often contains private, customer, employee, legal, financial, or regulated information. Keep reads narrow and summaries minimal.
Child auth scopes are intentionally separate so a private fork can remove surfaces or narrow scopes without changing the suite shape.
Drive, Sheets, and Slides use drive.file, so they are intended for files the app created or files the user explicitly opens or grants to the app.
Gmail write operations can label, draft, modify, or send messages. Draft first and confirm recipients and content before sending.
Docs, Sheets, and Slides update operations change live files. Inspect current structure and plan changes before issuing batch updates.
Tasks are user-visible workflow state. Do not infer deadlines or completion state from vague conversation.
Avoid this Caplet when the task only needs one focused Google surface; the individual Gmail, Drive, Docs, Sheets, Slides, and Tasks Caplets are simpler for single-surface work.