official
spiritledsoftware/capletsGoogle Workspace
Search, read, create, and update Gmail, Drive, Docs, Sheets, Slides, and Tasks through one Workspace capability suite.
Install
caplets install spiritledsoftware/caplets google-workspaceInspect 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
Suite operation
Identify 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.
The suite exposes separate child handles: google-workspace__gmail, google-workspace__drive, google-workspace__docs, google-workspace__sheets, google-workspace__slides, and google-workspace__tasks. These names are operator reference; the frontmatter backend map remains the runtime authority.
Before changing live state, inspect the current resource and confirm the relevant file or document ID, spreadsheet range, slide or page element ID, message or thread ID, label, recipient, tasklist, or task ID.
Safety and access boundaries
- Workspace data can contain private customer, employee, legal, financial, or regulated information. Keep reads narrow and summaries minimal.
- Child OAuth scopes are intentionally separate so a private fork can remove surfaces or narrow scopes without changing the suite shape.
- Drive, Sheets, and Slides use the restricted
drive.filescope. They cover files the app created and files the user explicitly opens or grants to the app. - Gmail operations can label, draft, modify, or send messages. Confirm recipients and content before sending.
- Docs, Sheets, and Slides batch updates change live files. Inspect current structure and plan changes before updating.
- Tasks are user-visible workflow state. Do not infer deadlines or completion from ambiguous conversation.