# Google Workspace on boxd

> Google Super App combines all Google services including Drive, Calendar, Gmail, Sheets, Analytics, Ads, and more, providing a unified platform for seamless integration and management of your digital life.

- Page: https://boxd.sh/integrations/googlesuper/
- CLI: `run googlesuper` (467 commands, 293 marked common)
- SDK: `import { googlesuper } from "@boxd/run"`; every parameter and response type is at `@boxd/run/googlesuper`
- Triggers: 48
- Connect: `run auth googlesuper` (Sign in with Google Workspace), or https://app.boxd.sh/integrations/detail/googlesuper
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## From the shell

```sh
run auth googlesuper      # once: prints a link to connect your account
run googlesuper           # list its commands
run googlesuper find-file
```

Parameters are flags (`--flag value`); object and array parameters take a JSON string. Output is YAML, or JSON with `--json`. Calls use your own connection; `--scope <name>` uses a connection shared with your team.

## From a script

```ts
import { googlesuper } from "@boxd/run";

const result = await googlesuper.findFile({});
console.log(result);

googlesuper.on("document-created", async (event) => {
  // New Document Created: runs on this machine, once per event
  console.log(event);
});
```

Run it with `run googlesuper.run.ts`. A script that calls `.on()` keeps running as a job and handles each event.

## Commands

Required flags are listed; `run googlesuper <command> --help` lists the optional ones. "common" marks what `run googlesuper` shows without `--all`.

| Command | SDK method | Required flags | Optional | Description |
|---|---|---|---|---|
| `acl-delete` ·common | `googlesuper.aclDelete()` | `--calendar-id` `--rule-id` | 0 | Deletes an access control rule from a Google Calendar |
| `acl-get` ·common | `googlesuper.aclGet()` | `--calendar-id` `--rule-id` | 0 | Retrieves a specific access control rule for a calendar |
| `acl-insert` ·common | `googlesuper.aclInsert()` | `--calendar-id` `--role` `--scope` | 1 | Creates an access control rule for a calendar |
| `acl-list` | `googlesuper.aclList()` | `--calendarId` | 4 | Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules |
| `acl-patch` | `googlesuper.aclPatch()` | `--calendar-id` `--rule-id` | 3 | Updates an existing access control rule for a calendar using patch semantics (partial update) |
| `acl-update` | `googlesuper.aclUpdate()` | `--calendar-id` `--role` `--rule-id` | 1 | Updates an access control rule for the specified calendar |
| `acl-watch` | `googlesuper.aclWatch()` | `--address` `--calendarId` `--id` | 3 | Watch for changes to ACL resources |
| `add-enrichment` | `googlesuper.addEnrichment()` | `--albumId` `--albumPosition` `--newEnrichmentItem` | 0 | Adds an enrichment at a specified position in a defined album |
| `add-file-sharing-preference` ·common ·deprecated | `googlesuper.addFileSharingPreference()` | `--file-id` `--role` `--type` | 3 | Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries) |
| `add-label-to-email` | `googlesuper.addLabelToEmail()` | `--message-id` | 3 | Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs) |
| `add-or-remove-to-customer-list` | `googlesuper.addOrRemoveToCustomerList()` | `--emails` `--resource-name` | 2 | Adds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account |
| `add-parent` | `googlesuper.addParent()` | `--fileId` `--id` | 3 | Add a parent folder for a file using Google Drive API v2 |
| `add-property` | `googlesuper.addProperty()` | `--fileId` `--property-key` `--property-value` | 12 | Add a property to a file, or update it if it already exists (v2 API) |
| `add-sheet` ·common | `googlesuper.addSheet()` | `--spreadsheet-id` | 5 | Adds a new sheet to a spreadsheet |
| `aggregate-column-data` | `googlesuper.aggregateColumnData()` | `--operation` `--sheet-name` `--spreadsheet-id` `--target-column` | 6 | Searches for rows where a specific column matches a value and performs mathematical operations on data from another column |
| `append-dimension` ·common | `googlesuper.appendDimension()` | `--dimension` `--length` `--sheet-id` `--spreadsheet-id` | 3 | Append new rows or columns to a sheet, increasing its size |
| `archive-custom-dimension` | `googlesuper.archiveCustomDimension()` | `--name` | 0 | Archive a CustomDimension on a property |
| `auto-resize-dimensions` | `googlesuper.autoResizeDimensions()` | `--dimension` `--end-index` `--spreadsheet-id` `--start-index` | 2 | Auto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions |
| `autocomplete` ·common | `googlesuper.autocomplete()` | `--input` | 11 | Returns place and query predictions for text input |
| `batch-add-media-items` | `googlesuper.batchAddMediaItems()` | `--albumId` `--mediaItemIds` | 0 | Adds one or more media items to an album in Google Photos |
| `batch-clear-values-by-data-filter` ·common | `googlesuper.batchClearValuesByDataFilter()` | `--dataFilters` `--spreadsheetId` | 0 | Clears one or more ranges of values from a spreadsheet using data filters |
| `batch-create-media-items` | `googlesuper.batchCreateMediaItems()` | — | 5 | Batch upload and create media items in Google Photos |
| `batch-delete-messages` | `googlesuper.batchDeleteMessages()` | `--messageIds` | 1 | Permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible |
| `batch-events` | `googlesuper.batchEvents()` | `--operations` | 1 | Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results |
| `batch-execute` | `googlesuper.batchExecute()` | `--requests` | 1 | Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results |
| `batch-get` ·common | `googlesuper.batchGet()` | `--spreadsheet-id` | 5 | Retrieves data from specified cell ranges in a Google Spreadsheet |
| `batch-get-media-items` | `googlesuper.batchGetMediaItems()` | `--mediaItemIds` | 0 | Returns the list of media items for the specified media item identifiers |
| `batch-modify-messages` ·common | `googlesuper.batchModifyMessages()` | `--messageIds` | 3 | Modify labels on multiple Gmail messages in one efficient API call |
| `batch-run-pivot-reports` ·common | `googlesuper.batchRunPivotReports()` | `--property` `--requests` | 0 | Return multiple pivot reports in a batch for a GA4 property |
| `batch-run-reports` ·common | `googlesuper.batchRunReports()` | `--property` `--requests` | 1 | Return multiple analytics data reports in a batch |
| `batch-update` ·common ·deprecated | `googlesuper.batchUpdate()` | `--sheet-name` `--spreadsheet-id` `--values` | 3 | Use GOOGLESHEETS_VALUES_UPDATE instead |
| `batch-update-values-by-data-filter` | `googlesuper.batchUpdateValuesByDataFilter()` | `--data` `--spreadsheetId` `--valueInputOption` | 3 | Update values in ranges matching data filters |
| `bulk-insert-tasks` ·deprecated | `googlesuper.bulkInsertTasks()` | `--tasklist-id` `--tasks` | 1 | Use BatchExecute instead |
| `calendar-list-delete` ·common | `googlesuper.calendarListDelete()` | `--calendar-id` | 0 | Remove a calendar from the user's calendar list |
| `calendar-list-get` ·common | `googlesuper.calendarListGet()` | `--calendarId` | 0 | Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID |
| `calendar-list-insert` ·common | `googlesuper.calendarListInsert()` | `--id` | 9 | Inserts an existing calendar into the user's calendar list, making it visible in the UI |
| `calendar-list-patch` ·common | `googlesuper.calendarListPatch()` | `--calendar-id` | 9 | Updates an existing calendar on the user's calendar list using patch semantics |
| `calendar-list-update` | `googlesuper.calendarListUpdate()` | `--calendar-id` | 9 | Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user, does not modify the underlying calendar resource (title, timezone… |
| `calendar-list-watch` | `googlesuper.calendarListWatch()` | `--address` `--id` `--type` | 3 | Watch for changes to CalendarList resources using push notifications |
| `calendars-delete` ·common | `googlesuper.calendarsDelete()` | `--calendar-id` | 0 | Deletes a secondary calendar that you own or have delete permissions on |
| `calendars-update` ·common | `googlesuper.calendarsUpdate()` | `--calendarId` `--summary` | 3 | Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared |
| `channels-stop` ·common | `googlesuper.channelsStop()` | `--id` `--resourceId` | 1 | Stop watching resources through a notification channel |
| `check-compatibility` ·common | `googlesuper.checkCompatibility()` | `--property` | 5 | List dimensions and metrics compatible with a GA4 report request |
| `clear-basic-filter` ·common | `googlesuper.clearBasicFilter()` | `--sheet-id` `--spreadsheet-id` | 3 | Clear the basic filter from a sheet |
| `clear-calendar` | `googlesuper.clearCalendar()` | `--calendar-id` | 0 | Clears a primary calendar by deleting all events from it |
| `clear-tasks` | `googlesuper.clearTasks()` | `--tasklist` | 0 | Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone |
| `clear-values` | `googlesuper.clearValues()` | `--range` `--spreadsheet-id` | 0 | Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells |
| `colors-get` | `googlesuper.colorsGet()` | — | 0 | Returns the color definitions for calendars and events |
| `compute-route-matrix` ·common | `googlesuper.computeRouteMatrix()` | `--destinations` `--origins` | 5 | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes |
| `copy-document` ·common | `googlesuper.copyDocument()` | `--document-id` | 2 | Create a copy of an existing Google Document |
| `copy-file` ·deprecated | `googlesuper.copyFile()` | `--file-id` | 1 | Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead |
| `copy-file-advanced` | `googlesuper.copyFileAdvanced()` | `--fileId` | 32 | Creates a copy of a file and applies any requested updates with patch semantics |
| `create-album` | `googlesuper.createAlbum()` | `--title` | 0 | Creates a new album in Google Photos |
| `create-and-populate-table` ·common | `googlesuper.createAndPopulateTable()` | `--cellData` `--columns` `--documentId` `--rows` | 4 | Creates a new table in a Google Document and populates its cells with provided text data in a single operation |
| `create-audience-export` ·common | `googlesuper.createAudienceExport()` | `--audience` `--parent` | 1 | Create an audience export for Google Analytics |
| `create-audience-list` ·common | `googlesuper.createAudienceList()` | `--audience` `--dimensions` `--parent` | 1 | Create an audience list for later retrieval by initiating a long-running asynchronous request |
| `create-calendar` ·common | `googlesuper.createCalendar()` | `--summary` | 3 | Creates a new secondary Google Calendar with the specified title and optional settings |
| `create-chart` | `googlesuper.createChart()` | `--chart-type` `--data-range` `--sheet-id` `--spreadsheet-id` | 9 | Create a chart in a Google Sheets spreadsheet using the specified data range and chart type |
| `create-comment` ·common | `googlesuper.createComment()` | `--content` `--file-id` | 3 | Create a comment on a file in Google Drive |
| `create-custom-dimension` ·common | `googlesuper.createCustomDimension()` | `--displayName` `--parameterName` `--parent` `--scope` | 2 | Create a CustomDimension for a Google Analytics property |
| `create-custom-metric` ·common | `googlesuper.createCustomMetric()` | `--displayName` `--measurementUnit` `--parameterName` `--parent` `--scope` | 2 | Create a custom metric in Google Analytics |
| `create-customer-list` | `googlesuper.createCustomerList()` | `--name` | 2 | Creates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account |
| `create-document` | `googlesuper.createDocument()` | `--title` | 1 | Creates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content) |
| `create-document-markdown` ·common | `googlesuper.createDocumentMarkdown()` | `--title` | 2 | Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text |
| `create-document2` ·common ·deprecated | `googlesuper.createDocument2()` | `--title` | 0 | Use GOOGLEDOCS_CREATE_DOCUMENT instead |
| `create-drive` ·common | `googlesuper.createDrive()` | `--name` | 5 | Create a new shared drive |
| `create-email-draft` ·common | `googlesuper.createEmailDraft()` | — | 10 | Creates a Gmail email draft |
| `create-event` ·common | `googlesuper.createEvent()` | `--start-datetime` | 24 | Create a Google Calendar event using start_datetime plus duration fields |
| `create-expanded-data-set` ·common | `googlesuper.createExpandedDataSet()` | `--expandedDataSet` `--parent` | 0 | Create an expanded data set for a property |
| `create-file` ·common | `googlesuper.createFile()` | — | 7 | Creates a new file or folder in Google Drive |
| `create-file-from-text` | `googlesuper.createFileFromText()` | `--file-name` `--text-content` | 2 | Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types |
| `create-filter` | `googlesuper.createFilter()` | `--action` `--criteria` | 1 | Create a new Gmail filter with specified criteria and actions |
| `create-folder` ·common | `googlesuper.createFolder()` | `--name` | 1 | Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name |
| `create-footer` ·common | `googlesuper.createFooter()` | `--document-id` `--type` | 1 | Create a new footer in a Google Document |
| `create-footnote` ·common | `googlesuper.createFootnote()` | `--documentId` | 2 | Create a new footnote in a Google Document |
| `create-google-sheet1` ·common | `googlesuper.createGoogleSheet1()` | — | 3 | Creates a new Google Spreadsheet in Google Drive |
| `create-header` ·common | `googlesuper.createHeader()` | `--documentId` | 3 | Create a new header in a Google Document, optionally with text content |
| `create-label` | `googlesuper.createLabel()` | `--label-name` | 5 | Creates a new label with a unique name in the specified user's Gmail account |
| `create-meet` ·common | `googlesuper.createMeet()` | — | 1 | Creates a new Google Meet space with optional configuration |
| `create-named-range` ·common | `googlesuper.createNamedRange()` | `--documentId` `--name` `--rangeEndIndex` `--rangeStartIndex` | 2 | Create a new named range in a Google Document |
| `create-paragraph-bullets` ·common | `googlesuper.createParagraphBullets()` | `--createParagraphBullets` `--document-id` | 1 | Add bullets to paragraphs within a specified range in a Google Document |
| `create-permission` ·common | `googlesuper.createPermission()` | `--file-id` `--role` `--type` | 10 | Create a permission for a file or shared drive |
| `create-permissions-batch` ·common | `googlesuper.createPermissionsBatch()` | `--permissions` | 0 | Creates multiple permissions for files or shared drives in a single batch request |
| `create-presentation` ·common | `googlesuper.createPresentation()` | — | 4 | Create a blank Google Slides presentation |
| `create-prompt-post` | `googlesuper.createPromptPost()` | `--message` `--organizationId` | 3 | Send a one-shot prompt to the Sanity Content Agent |
| `create-recurring-audience-list` ·common | `googlesuper.createRecurringAudienceList()` | `--audience` `--dimensions` `--parent` | 2 | Create a recurring audience list that automatically generates new audience lists daily based on the latest data |
| `create-reply` ·common | `googlesuper.createReply()` | `--comment-id` `--content` `--file-id` | 2 | Create a reply to a comment in Google Drive |
| `create-report-task` ·common | `googlesuper.createReportTask()` | `--parent` | 1 | Create a report task as a long-running asynchronous request for customized Google Analytics event data reports |
| `create-rollup-property` ·common | `googlesuper.createRollupProperty()` | `--account` `--displayName` `--timeZone` | 1 | Create a roll-up property |
| `create-shortcut-to-file` ·common | `googlesuper.createShortcutToFile()` | `--name` `--target-id` | 5 | Create a shortcut to a file or folder in Google Drive |
| `create-slides-markdown` ·common | `googlesuper.createSlidesMarkdown()` | `--markdown-text` `--title` | 0 | Creates a new Google Slides presentation from Markdown text |
| `create-spreadsheet-column` | `googlesuper.createSpreadsheetColumn()` | `--spreadsheet-id` | 7 | Creates a new column in a Google Spreadsheet |
| `create-spreadsheet-row` | `googlesuper.createSpreadsheetRow()` | `--spreadsheet-id` | 7 | Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above |
| `create-tab` ·common | `googlesuper.createTab()` | `--document-id` | 1 | Creates a new tab in a Google Docs document |
| `create-task-list` | `googlesuper.createTaskList()` | `--tasklist-title` | 0 | Creates a new task list with the specified title and returns a tasklist_id |
| `create-team-drive` | `googlesuper.createTeamDrive()` | `--name` | 4 | Create a Team Drive |
| `delete-chart` | `googlesuper.deleteChart()` | `--chart-id` `--spreadsheet-id` | 0 | Delete an existing chart from a Google Sheets spreadsheet |
| `delete-child` | `googlesuper.deleteChild()` | `--childId` `--folderId` | 12 | Remove a child from a folder using Google Drive API v2 |
| `delete-comment` ·common | `googlesuper.deleteComment()` | `--comment-id` `--file-id` | 0 | Permanently deletes a comment thread (and all its replies) from a Google Drive file, this action is irreversible |
| `delete-content-range` ·common | `googlesuper.deleteContentRange()` | `--document-id` `--range` | 0 | Delete a range of content from a Google Document |
| `delete-dimension` ·common | `googlesuper.deleteDimension()` | `--spreadsheet-id` | 9 | Delete specified rows or columns from a sheet in a Google Spreadsheet |
| `delete-draft` ·common | `googlesuper.deleteDraft()` | `--draft-id` | 1 | Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling |
| `delete-drive` ·common | `googlesuper.deleteDrive()` | `--driveId` | 2 | Permanently delete a shared drive |
| `delete-event` ·common | `googlesuper.deleteEvent()` | `--event-id` | 3 | Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); idempotent, a 404 for an already-deleted event is a no-op |
| `delete-file` ·common ·deprecated | `googlesuper.deleteFile()` | `--fileId` | 2 | Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead |
| `delete-filter` | `googlesuper.deleteFilter()` | `--filter-id` | 1 | Permanently delete a Gmail filter by its ID |
| `delete-footer` ·common | `googlesuper.deleteFooter()` | `--document-id` `--footer-id` | 1 | Delete a footer from a Google Document |
| `delete-header` ·common | `googlesuper.deleteHeader()` | `--document-id` `--header-id` | 1 | Deletes the header from the specified section or the default header if no section is specified |
| `delete-label` | `googlesuper.deleteLabel()` | `--label-id` | 1 | Permanently DELETES a user-created Gmail label from the account (not from a message) |
| `delete-message` ·common | `googlesuper.deleteMessage()` | `--message-id` | 1 | Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access |
| `delete-named-range` ·common | `googlesuper.deleteNamedRange()` | `--deleteNamedRange` `--document-id` | 0 | Delete a named range from a Google Document |
| `delete-paragraph-bullets` ·common | `googlesuper.deleteParagraphBullets()` | `--document-id` `--range` | 1 | Remove bullets from paragraphs within a specified range in a Google Document |
| `delete-parent` | `googlesuper.deleteParent()` | `--fileId` `--parentId` | 12 | Remove a parent from a file using Google Drive API v2 |
| `delete-permission` ·common | `googlesuper.deletePermission()` | `--file-id` `--permission-id` | 2 | Deletes a permission from a file by permission ID |
| `delete-property` | `googlesuper.deleteProperty()` | `--fileId` `--propertyKey` | 12 | Delete a property from a file using Google Drive API v2 |
| `delete-reply` ·common | `googlesuper.deleteReply()` | `--comment-id` `--file-id` `--reply-id` | 0 | Delete a specific reply by reply ID |
| `delete-revision` | `googlesuper.deleteRevision()` | `--file-id` `--revision-id` | 0 | Permanently delete a file revision |
| `delete-sheet` ·common | `googlesuper.deleteSheet()` | `--sheetId` `--spreadsheetId` | 3 | Delete a sheet (worksheet) from a spreadsheet |
| `delete-tab` ·common | `googlesuper.deleteTab()` | `--document-id` `--tab-id` | 0 | Deletes a tab from a Google Document |
| `delete-table-column` ·common | `googlesuper.deleteTableColumn()` | `--document-id` `--requests` | 0 | Delete a column from a table in a Google Document |
| `delete-table-row` ·common | `googlesuper.deleteTableRow()` | `--documentId` `--tableCellLocation` | 0 | Delete a row from a table in a Google Document |
| `delete-task` | `googlesuper.deleteTask()` | `--task-id` `--tasklist-id` | 0 | Deletes a specified task from a Google Tasks list |
| `delete-task-list` | `googlesuper.deleteTaskList()` | `--tasklist-id` | 0 | Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible |
| `delete-team-drive` | `googlesuper.deleteTeamDrive()` | `--teamDriveId` | 0 | Permanently delete a Team Drive |
| `delete-thread` ·common | `googlesuper.deleteThread()` | `--id` | 1 | Immediately and permanently delete a specified thread and all its messages |
| `distance-matrix-api` ·common ·deprecated | `googlesuper.distanceMatrixApi()` | `--destinations` `--origins` | 11 | Legacy API that calculates travel distance and time for a matrix of origins and destinations |
| `download-file` ·common | `googlesuper.downloadFile()` | `--fileId` | 1 | Downloads a file from Google Drive by its ID |
| `download-file-operation` ·common | `googlesuper.downloadFileOperation()` | `--file-id` | 2 | Download file content using long-running operations |
| `download-file2` ·common ·deprecated | `googlesuper.downloadFile2()` | `--file-id` | 0 | Use GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION instead |
| `duplicate-calendar` ·common | `googlesuper.duplicateCalendar()` | `--summary` | 0 | Creates a new, empty Google Calendar with the specified title (summary) |
| `edit-file` | `googlesuper.editFile()` | `--content` `--file-id` | 1 | Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB) |
| `empty-trash` ·common | `googlesuper.emptyTrash()` | — | 2 | Permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive |
| `end-active-conference` ·common | `googlesuper.endActiveConference()` | `--space-name` | 0 | Ends an active conference in a Google Meet space |
| `events-get` ·common | `googlesuper.eventsGet()` | `--event-id` | 3 | Retrieves a SINGLE event by its unique event_id (REQUIRED) |
| `events-import` | `googlesuper.eventsImport()` | `--end` `--iCalUID` `--start` | 20 | Import an event as a private copy to a calendar |
| `events-instances` ·common | `googlesuper.eventsInstances()` | `--calendarId` `--eventId` | 8 | Returns instances of the specified recurring event |
| `events-list` | `googlesuper.eventsList()` | — | 20 | Returns events on the specified calendar |
| `events-list-all-calendars` ·common | `googlesuper.eventsListAllCalendars()` | `--time-max` `--time-min` | 7 | Return a unified event list across all calendars in the user's calendar list for a given time range |
| `events-move` | `googlesuper.eventsMove()` | `--calendar-id` `--destination` `--event-id` | 1 | Moves an event to another calendar, i.e., changes an event's organizer |
| `events-watch` | `googlesuper.eventsWatch()` | `--address` `--calendarId` `--id` | 4 | Watch for changes to Events resources |
| `execute-sql` ·deprecated | `googlesuper.executeSql()` | `--spreadsheet-id` `--sql` | 2 | Use direct Google Sheets actions instead: - GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for reads - GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_UPDATE_VALUES_BATCH /… |
| `export-document-as-pdf` ·common | `googlesuper.exportDocumentAsPdf()` | `--file-id` | 1 | Export a Google Docs file as PDF using the Google Drive API |
| `export-google-workspace-file` ·common | `googlesuper.exportGoogleWorkspaceFile()` | `--fileId` `--mimeType` | 0 | Exports a Google Workspace document to the requested MIME type and returns exported file content |
| `fetch-emails` ·common | `googlesuper.fetchEmails()` | — | 9 | Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval |
| `fetch-message-by-message-id` ·common | `googlesuper.fetchMessageByMessageId()` | `--message-id` | 2 | Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id` |
| `fetch-message-by-thread-id` | `googlesuper.fetchMessageByThreadId()` | `--thread-id` | 2 | Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id` |
| `find-event` ·common | `googlesuper.findEvent()` | — | 11 | Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types |
| `find-file` ·common | `googlesuper.findFile()` | — | 22 | The comprehensive Google Drive search tool that handles all file and folder discovery needs |
| `find-folder` | `googlesuper.findFolder()` | — | 10 | Finds one page of Google Drive folders by name and optional parent |
| `find-free-slots` | `googlesuper.findFreeSlots()` | — | 6 | Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range |
| `find-replace` ·common | `googlesuper.findReplace()` | `--find` `--replace` `--spreadsheetId` | 13 | Find and replace text in a Google Spreadsheet |
| `find-worksheet-by-title` ·deprecated | `googlesuper.findWorksheetByTitle()` | `--spreadsheet-id` `--worksheet-title` | 0 | Use GetSpreadsheetInfo instead |
| `format-cell` | `googlesuper.formatCell()` | `--spreadsheet-id` | 35 | Applies text and background cell formatting to a specified range in a Google Sheets worksheet |
| `forward-message` | `googlesuper.forwardMessage()` | `--message-id` `--recipients` | 4 | Forward an existing Gmail message to specified recipients, preserving original body and attachments |
| `free-busy-query` ·common ·deprecated | `googlesuper.freeBusyQuery()` | `--items` `--timeMax` `--timeMin` | 3 | Use GOOGLECALENDAR_FIND_FREE_SLOTS instead (though this tool provides wider secondary/shared calendar coverage) |
| `generate-ids` ·common | `googlesuper.generateIds()` | — | 3 | Generates a set of file IDs which can be provided in create or copy requests |
| `geocode-address` ·common ·deprecated | `googlesuper.geocodeAddress()` | — | 6 | Legacy API to convert street addresses into geographic coordinates (latitude and longitude) |
| `geocode-address-with-query` ·common | `googlesuper.geocodeAddressWithQuery()` | `--address-query` | 2 | Map addresses to geographic coordinates with query parameter |
| `geocode-destinations` | `googlesuper.geocodeDestinations()` | — | 6 | Perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points |
| `geocode-location` ·common | `googlesuper.geocodeLocation()` | `--latitude` `--longitude` | 3 | Convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding |
| `geocode-place` ·common | `googlesuper.geocodePlace()` | `--place-id` | 2 | Perform geocode lookup using a place identifier to retrieve address and coordinates |
| `geocoding-api` ·common | `googlesuper.geocodingApi()` | — | 11 | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID |
| `geolocate` | `googlesuper.geolocate()` | — | 7 | Determine location based on cell towers and WiFi access points |
| `get-about` ·common | `googlesuper.getAbout()` | — | 1 | Retrieve information about the user, the user's Drive, and system capabilities |
| `get-account` ·common | `googlesuper.getAccount()` | `--name` | 0 | Retrieve a single Account by its resource name |
| `get-album` | `googlesuper.getAlbum()` | `--albumId` | 0 | Returns the album based on the specified albumId |
| `get-app` | `googlesuper.getApp()` | `--appId` | 0 | Get information about a specific Drive app by ID |
| `get-attachment` ·common | `googlesuper.getAttachment()` | `--attachment-id` `--file-name` `--message-id` | 1 | Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs |
| `get-attribution-settings` ·common | `googlesuper.getAttributionSettings()` | `--name` | 0 | Retrieve attribution configuration for a Google Analytics property |
| `get-audience` ·common | `googlesuper.getAudience()` | `--audienceId` `--propertyId` | 0 | Retrieve a single Audience configuration from a Google Analytics property |
| `get-audience-export` ·common | `googlesuper.getAudienceExport()` | `--name` | 0 | Get configuration metadata about a specific audience export |
| `get-audience-list` ·common | `googlesuper.getAudienceList()` | `--name` | 0 | Get configuration metadata about a specific audience list |
| `get-auto-forwarding` | `googlesuper.getAutoForwarding()` | — | 1 | Get the auto-forwarding setting for the specified account |
| `get-batch-values` ·common ·deprecated | `googlesuper.getBatchValues()` | `--ranges` `--spreadsheet-id` | 3 | Use GOOGLESHEETS_BATCH_GET instead |
| `get-calendar` ·common | `googlesuper.getCalendar()` | — | 1 | Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access |
| `get-calendar-profile` ·common ·deprecated | `googlesuper.getCalendarProfile()` | — | 0 | Use CalendarListGet instead |
| `get-campaign-by-id` | `googlesuper.getCampaignById()` | `--id` | 1 | GetCampaignById Tool returns details of a campaign in Google Ads |
| `get-campaign-by-name` | `googlesuper.getCampaignByName()` | `--name` | 1 | Queries Google Ads via SQL to retrieve a campaign by its exact name |
| `get-change` | `googlesuper.getChange()` | `--changeId` | 15 | Get a specific change by ID from Google Drive v2 API |
| `get-changes-start-page-token` ·common | `googlesuper.getChangesStartPageToken()` | — | 4 | Get the starting pageToken for listing future changes in Google Drive |
| `get-child` | `googlesuper.getChild()` | `--childId` `--folderId` | 11 | Get a specific child reference for a folder using Drive API v2 |
| `get-comment` ·common | `googlesuper.getComment()` | `--commentId` `--fileId` | 1 | Get a comment by ID |
| `get-conditional-format-rules` | `googlesuper.getConditionalFormatRules()` | `--spreadsheet-id` | 3 | List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form |
| `get-conference-record-by-name` ·common | `googlesuper.getConferenceRecordByName()` | `--name` | 0 | Get a specific conference record by its resource name |
| `get-contacts` | `googlesuper.getContacts()` | — | 4 | Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination |
| `get-current-date-time` | `googlesuper.getCurrentDateTime()` | — | 1 | Gets the current date and time, allowing for a specific timezone offset |
| `get-custom-dimension` ·common | `googlesuper.getCustomDimension()` | `--name` | 0 | Retrieve a single CustomDimension by its resource name |
| `get-customer-lists` | `googlesuper.getCustomerLists()` | — | 2 | GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads |
| `get-data-retention-settings` ·common | `googlesuper.getDataRetentionSettings()` | `--name` | 0 | Retrieve data retention configuration for a Google Analytics property |
| `get-data-sharing-settings` ·common | `googlesuper.getDataSharingSettings()` | `--name` | 0 | Retrieve data sharing configuration for a Google Analytics account |
| `get-data-validation-rules` | `googlesuper.getDataValidationRules()` | `--spreadsheetId` | 4 | Extract data validation rules from a Google Sheets spreadsheet |
| `get-direction` | `googlesuper.getDirection()` | `--destination` `--origin` | 5 | Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes |
| `get-document-by-id` | `googlesuper.getDocumentById()` | `--id` | 1 | Retrieves an existing Google Document by its ID; will error if the document is not found |
| `get-document-end-index` | `googlesuper.getDocumentEndIndex()` | `--document-id` | 2 | Retrieves the end index and paragraph structure of a Google Document or specific segment |
| `get-document-plaintext` ·common | `googlesuper.getDocumentPlaintext()` | `--document-id` | 8 | Retrieve a Google Doc by ID and return a best-effort plain-text rendering |
| `get-draft` ·common | `googlesuper.getDraft()` | `--draft-id` | 2 | Retrieves a single Gmail draft by its ID |
| `get-drive` ·common | `googlesuper.getDrive()` | `--drive-id` | 1 | Get a shared drive by ID |
| `get-file-metadata` ·common | `googlesuper.getFileMetadata()` | `--fileId` | 4 | Get a file's metadata by ID |
| `get-file-property` ·common | `googlesuper.getFileProperty()` | `--fileId` `--propertyKey` | 1 | Get a property by its key using Google Drive API v2 |
| `get-file-v2` ·deprecated | `googlesuper.getFileV2()` | `--fileId` | 19 | Use GetFileMetadata instead |
| `get-filter` | `googlesuper.getFilter()` | `--id` | 1 | Retrieve a specific Gmail filter by its ID |
| `get-google-signals-settings` ·common | `googlesuper.getGoogleSignalsSettings()` | `--name` | 0 | Retrieve Google Signals configuration settings for a GA4 property |
| `get-key-event` ·common | `googlesuper.getKeyEvent()` | `--name` | 0 | Retrieve a Key Event |
| `get-label` | `googlesuper.getLabel()` | `--id` | 1 | Gets details for a specified Gmail label |
| `get-language-settings` | `googlesuper.getLanguageSettings()` | — | 1 | Retrieve the language settings for a Gmail user |
| `get-media-item-download` | `googlesuper.getMediaItemDownload()` | `--mediaItemId` | 0 | Downloads a media item from Google Photos and returns it as a file |
| `get-meet` | `googlesuper.getMeet()` | `--space-name` | 0 | Retrieve details of a Google Meet space using its unique identifier |
| `get-metadata` ·common | `googlesuper.getMetadata()` | `--name` | 0 | Get metadata for dimensions, metrics, and comparisons for a GA4 property |
| `get-page-thumbnail2` | `googlesuper.getPageThumbnail2()` | `--pageObjectId` `--presentationId` | 2 | Generate a thumbnail of the latest version of a specified page |
| `get-parent` | `googlesuper.getParent()` | `--fileId` `--parentId` | 11 | Get a specific parent reference for a file using Drive API v2 |
| `get-participant-session` ·common | `googlesuper.getParticipantSession()` | `--name` | 0 | Retrieves detailed information about a specific participant session from a Google Meet conference record |
| `get-people` | `googlesuper.getPeople()` | — | 7 | Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return |
| `get-permission` ·common | `googlesuper.getPermission()` | `--file-id` `--permission-id` | 3 | Gets a permission by ID |
| `get-permission-id-for-email` | `googlesuper.getPermissionIdForEmail()` | `--email` | 11 | Get the permission ID for an email address using the Drive API v2 |
| `get-place-details` ·common | `googlesuper.getPlaceDetails()` | `--name` | 4 | Retrieves comprehensive details for a place using its resource name (places/{place_id} format) |
| `get-profile` | `googlesuper.getProfile()` | — | 1 | Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is… |
| `get-property` ·common | `googlesuper.getProperty()` | `--name` | 0 | Retrieve a single GA4 Property by its resource name |
| `get-property-quotas-snapshot` ·common | `googlesuper.getPropertyQuotasSnapshot()` | `--property` | 0 | Retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property |
| `get-recordings-by-conference-record-id` | `googlesuper.getRecordingsByConferenceRecordId()` | `--conference-record-id` | 0 | Retrieves recordings from Google Meet for a given conference record ID |
| `get-recurring-audience-list` ·common | `googlesuper.getRecurringAudienceList()` | `--name` | 0 | Get configuration metadata about a specific recurring audience list |
| `get-reply` ·common | `googlesuper.getReply()` | `--commentId` `--fileId` `--replyId` | 1 | Get a specific reply to a comment on a file |
| `get-report-task` ·common | `googlesuper.getReportTask()` | `--name` | 0 | Get report metadata about a specific report task |
| `get-revision` ·common | `googlesuper.getRevision()` | `--file-id` `--revision-id` | 1 | Get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID |
| `get-route` | `googlesuper.getRoute()` | `--destination-address` `--origin-address` | 9 | Calculates one or more routes between two specified locations |
| `get-sheet-names` ·common | `googlesuper.getSheetNames()` | `--spreadsheet-id` | 1 | Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations |
| `get-spreadsheet-by-data-filter` ·common | `googlesuper.getSpreadsheetByDataFilter()` | `--spreadsheetId` | 3 | Returns the spreadsheet at the given ID, filtered by the specified data filters |
| `get-spreadsheet-info` ·common | `googlesuper.getSpreadsheetInfo()` | — | 5 | Retrieves metadata for a Google Spreadsheet using its ID |
| `get-table-schema` ·deprecated | `googlesuper.getTableSchema()` | `--spreadsheet-id` `--table-name` | 2 | Use GOOGLESHEETS_GET_SHEET_NAMES and GOOGLESHEETS_GET_SPREADSHEET_INFO for sheet structure metadata, and GOOGLESHEETS_VALUES_GET for direct range inspection |
| `get-task` | `googlesuper.getTask()` | `--task-id` `--tasklist-id` | 0 | Retrieve a specific Google Task |
| `get-task-list` | `googlesuper.getTaskList()` | `--tasklist-id` | 0 | Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user |
| `get-team-drive` | `googlesuper.getTeamDrive()` | `--teamDriveId` | 1 | Get metadata about a Team Drive by ID |
| `get-time-zone` ·common | `googlesuper.getTimeZone()` | `--location` `--timestamp` | 1 | Retrieves time zone information for a specific geographic location and timestamp |
| `get-transcript` | `googlesuper.getTranscript()` | `--name` | 0 | Retrieves a specific transcript by its resource name |
| `get-transcript-entry` | `googlesuper.getTranscriptEntry()` | `--name` | 0 | Fetches a single transcript entry by resource name for targeted inspection or incremental processing |
| `get-transcripts-by-conference-record-id` | `googlesuper.getTranscriptsByConferenceRecordId()` | `--conference-record-id` | 2 | Retrieves all transcripts for a specific Google Meet conference using its conference_record_id |
| `get-vacation-settings` | `googlesuper.getVacationSettings()` | — | 1 | Retrieve vacation responder settings for a Gmail user |
| `get2d-tile` | `googlesuper.get2dTile()` | `--session` `--x` `--y` `--z` | 2 | Retrieve a 2D map tile image at specified coordinates for building custom map visualizations |
| `get3d-tiles-root` | `googlesuper.get3dTilesRoot()` | — | 1 | Retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering |
| `google-drive-delete-folder-or-file-action` | `googlesuper.googleDriveDeleteFolderOrFileAction()` | `--fileId` | 1 | Delete a file or folder in Google Drive |
| `hide-drive` ·common | `googlesuper.hideDrive()` | `--drive-id` | 0 | Hide a shared drive from the default view |
| `import-message` | `googlesuper.importMessage()` | `--raw` | 5 | Import a message into the user's mailbox with standard email delivery scanning and classification |
| `insert-child` | `googlesuper.insertChild()` | `--folderId` `--id` | 14 | Insert a file into a folder using Drive API v2 |
| `insert-dimension` ·common | `googlesuper.insertDimension()` | `--insert-dimension` `--spreadsheet-id` | 3 | Insert new rows or columns into a sheet at a specified location |
| `insert-image-in-table-cell` ·common | `googlesuper.insertImageInTableCell()` | `--document-id` `--table-cell-location` `--uri` | 2 | Inserts an image from a given URI into a specific table cell in a Google Document |
| `insert-inline-image` ·common | `googlesuper.insertInlineImage()` | `--documentId` `--location` `--uri` | 1 | Insert an image from a given URI at a specified location in a Google Document as an inline image |
| `insert-message` | `googlesuper.insertMessage()` | `--raw` | 3 | Insert a message into the user's mailbox similar to IMAP APPEND |
| `insert-page-break` ·common | `googlesuper.insertPageBreak()` | `--documentId` `--insertPageBreak` | 0 | Insert a page break into a Google Document |
| `insert-table-action` ·common | `googlesuper.insertTableAction()` | `--columns` `--documentId` `--rows` | 4 | Insert a table into a Google Document |
| `insert-table-column` ·common | `googlesuper.insertTableColumn()` | `--document-id` `--requests` | 0 | Insert a new column into a table in a Google Document |
| `insert-table-row` ·common | `googlesuper.insertTableRow()` | `--document-id` `--requests` | 0 | Inserts a new row into a table in a Google Document at a specified location |
| `insert-task` | `googlesuper.insertTask()` | `--tasklist-id` `--title` | 10 | Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous` sibling, where both `task_parent` and `task_previous`… |
| `insert-text-action` ·common | `googlesuper.insertTextAction()` | `--document-id` `--text-to-insert` | 4 | Insert a string of text at a specified location within a Google Document |
| `insert-text-in-table-cell` ·common | `googlesuper.insertTextInTableCell()` | `--column-index` `--document-id` `--row-index` `--table-start-index` `--text` | 1 | Inserts text into a specific cell of a table in a Google Document by row and column position |
| `list-access-proposals` ·common | `googlesuper.listAccessProposals()` | `--fileId` | 2 | List pending access proposals on a file |
| `list-accessible-customers` ·common | `googlesuper.listAccessibleCustomers()` | — | 1 | List Google Ads customer resource names directly accessible to the authenticated user |
| `list-account-summaries` ·common | `googlesuper.listAccountSummaries()` | — | 2 | Retrieve summaries of all Google Analytics accounts accessible by the caller |
| `list-accounts` ·common ·deprecated | `googlesuper.listAccounts()` | — | 3 | Use ListAccountsV1Beta instead |
| `list-accounts-v1-beta` ·common | `googlesuper.listAccountsV1Beta()` | — | 3 | List all Google Analytics accounts accessible by the caller using v1beta API |
| `list-adsense-links` ·common | `googlesuper.listAdsenseLinks()` | `--parent` | 2 | List all AdSenseLinks on a property |
| `list-albums` | `googlesuper.listAlbums()` | — | 3 | Lists all albums shown to a user in the Albums tab of Google Photos |
| `list-all-tasks` | `googlesuper.listAllTasks()` | — | 10 | List all tasks across all of the user's task lists with optional filters |
| `list-approvals` ·common | `googlesuper.listApprovals()` | `--fileId` | 2 | List approvals on a file for workflow-based access control |
| `list-audience-exports` ·common | `googlesuper.listAudienceExports()` | `--parent` | 2 | List all audience exports for a property |
| `list-audience-lists` ·common | `googlesuper.listAudienceLists()` | `--parent` | 2 | List all audience lists for a specified property to help find and reuse existing lists |
| `list-audiences` ·common | `googlesuper.listAudiences()` | `--parent` | 2 | List Audiences on a property |
| `list-bigquery-links` ·common | `googlesuper.listBigqueryLinks()` | `--parent` | 2 | List BigQuery Links on a property |
| `list-buildings` | `googlesuper.listBuildings()` | — | 3 | Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names |
| `list-calculated-metrics` ·common | `googlesuper.listCalculatedMetrics()` | `--parent` | 2 | List Calculated Metrics |
| `list-calendar-resources` | `googlesuper.listCalendarResources()` | — | 5 | Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API |
| `list-calendars` | `googlesuper.listCalendars()` | — | 6 | Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering |
| `list-changes` ·common | `googlesuper.listChanges()` | — | 11 | List the changes for a user or shared drive |
| `list-channel-groups` ·common | `googlesuper.listChannelGroups()` | `--parent` | 2 | List ChannelGroups on a property |
| `list-charts` ·common | `googlesuper.listCharts()` | `--spreadsheet-id` | 3 | Lists all charts in a Google Sheets spreadsheet across all sheets, returning chart_id, sheet metadata, chart type, title, and position |
| `list-children-v2` | `googlesuper.listChildrenV2()` | `--folderId` | 15 | List a folder's children using Google Drive API v2 |
| `list-comments` ·common | `googlesuper.listComments()` | `--fileId` | 5 | List all comments for a file in Google Drive |
| `list-conference-records` ·common | `googlesuper.listConferenceRecords()` | — | 3 | List conference records |
| `list-conversion-events` ·common | `googlesuper.listConversionEvents()` | `--parent` | 2 | List conversion events on a property |
| `list-cse-identities` | `googlesuper.listCseIdentities()` | — | 3 | List client-side encrypted identities for an authenticated user |
| `list-cse-keypairs` | `googlesuper.listCseKeypairs()` | — | 3 | List client-side encryption key pairs for an authenticated user |
| `list-custom-dimensions` ·common | `googlesuper.listCustomDimensions()` | `--parent` | 2 | List Custom Dimensions |
| `list-custom-metrics` ·common | `googlesuper.listCustomMetrics()` | `--parent` | 2 | List CustomMetrics on a property |
| `list-data-streams` ·common | `googlesuper.listDataStreams()` | `--parent` | 2 | List DataStreams on a property |
| `list-drafts` ·common | `googlesuper.listDrafts()` | — | 4 | Retrieves a paginated list of email drafts from a user's Gmail account |
| `list-dv360-ad-links` ·common | `googlesuper.listDv360AdLinks()` | `--parent` | 2 | List Display & Video 360 advertiser links on a property |
| `list-dv360-link-proposals` ·common | `googlesuper.listDv360LinkProposals()` | `--parent` | 2 | List DisplayVideo360AdvertiserLinkProposals on a property |
| `list-event-create-rules` | `googlesuper.listEventCreateRules()` | `--parent` | 2 | List EventCreateRules configured on a web data stream |
| `list-expanded-data-sets` ·common | `googlesuper.listExpandedDataSets()` | `--parent` | 2 | List ExpandedDataSets on a property |
| `list-file-labels` ·common | `googlesuper.listFileLabels()` | `--file-id` | 2 | List the labels already applied to a file in Google Drive |
| `list-file-properties` | `googlesuper.listFileProperties()` | `--fileId` | 11 | List a file's properties in Google Drive API v2 |
| `list-files` ·common ·deprecated | `googlesuper.listFiles()` | — | 13 | Use GOOGLEDRIVE_FIND_FILE instead |
| `list-filters` | `googlesuper.listFilters()` | — | 1 | List all Gmail filters (rules) in the mailbox |
| `list-firebase-links` ·common | `googlesuper.listFirebaseLinks()` | `--parent` | 2 | List FirebaseLinks on a property |
| `list-forwarding-addresses` | `googlesuper.listForwardingAddresses()` | — | 1 | List all forwarding addresses for the specified Gmail account |
| `list-google-ads-links` ·common | `googlesuper.listGoogleAdsLinks()` | `--parent` | 2 | List GoogleAdsLinks on a property |
| `list-history` | `googlesuper.listHistory()` | `--start-history-id` | 5 | List Gmail mailbox change history since a known startHistoryId |
| `list-key-events` ·common | `googlesuper.listKeyEvents()` | `--parent` | 2 | List Key Events |
| `list-labels` | `googlesuper.listLabels()` | — | 2 | Retrieves all system and user-created labels for a Gmail account in a single unpaginated response |
| `list-measurement-protocol-secrets` ·common | `googlesuper.listMeasurementProtocolSecrets()` | `--parent` | 2 | List MeasurementProtocolSecrets under a data stream |
| `list-media-items` | `googlesuper.listMediaItems()` | — | 2 | Lists media items created by this application from Google Photos |
| `list-messages` ·common ·deprecated | `googlesuper.listMessages()` | — | 6 | Use GMAIL_FETCH_EMAILS instead |
| `list-participant-sessions` ·common | `googlesuper.listParticipantSessions()` | `--conference-record-id` `--participant-id` | 3 | Lists all participant sessions for a specific participant in a Google Meet conference |
| `list-participants` ·common | `googlesuper.listParticipants()` | `--parent` | 3 | Lists the participants in a conference record |
| `list-permissions` ·common | `googlesuper.listPermissions()` | `--fileId` | 5 | List a file's permissions |
| `list-properties` ·common ·deprecated | `googlesuper.listProperties()` | `--account` | 3 | Use ListPropertiesV1Beta instead |
| `list-properties-filtered` ·common | `googlesuper.listPropertiesFiltered()` | `--filter` | 3 | List GA4 properties based on filter criteria |
| `list-recordings` ·common | `googlesuper.listRecordings()` | `--parent` | 2 | List recording resources from a conference record |
| `list-recurring-audience-lists` ·common | `googlesuper.listRecurringAudienceLists()` | `--parent` | 2 | List all recurring audience lists for a GA4 property |
| `list-replies` ·common | `googlesuper.listReplies()` | `--comment-id` `--file-id` | 4 | List replies to a comment in Google Drive |
| `list-report-tasks` ·common | `googlesuper.listReportTasks()` | `--parent` | 2 | List all report tasks for a Google Analytics property |
| `list-reporting-data-annotations` ·common | `googlesuper.listReportingDataAnnotations()` | `--parent` | 3 | List all Reporting Data Annotations for a specific property |
| `list-revisions` ·common | `googlesuper.listRevisions()` | `--fileId` | 3 | List a file's revision metadata (not content) in Google Drive |
| `list-search-ads360-links` ·common | `googlesuper.listSearchAds360Links()` | `--parent` | 2 | List all SearchAds360Links on a property |
| `list-send-as` | `googlesuper.listSendAs()` | — | 1 | Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases |
| `list-settings` ·deprecated | `googlesuper.listSettings()` | — | 2 | Use GOOGLECALENDAR_SETTINGS_LIST instead |
| `list-shared-albums` | `googlesuper.listSharedAlbums()` | — | 3 | [DEPRECATED - sunset March 31, 2025] Lists all shared albums available in the Sharing tab of the user's Google Photos app |
| `list-shared-drives` ·common | `googlesuper.listSharedDrives()` | — | 4 | List the user's shared drives |
| `list-sk-ad-network-conversion-value-schemas` | `googlesuper.listSkAdNetworkConversionValueSchemas()` | `--parent` | 2 | List SKAdNetworkConversionValueSchema configurations for an iOS data stream |
| `list-smime-info` | `googlesuper.listSmimeInfo()` | `--send-as-email` | 1 | Lists S/MIME configs for the specified send-as alias |
| `list-spreadsheet-charts` ·common | `googlesuper.listSpreadsheetCharts()` | `--spreadsheet-id` | 0 | Retrieve a list of all charts from a specified Google Sheets spreadsheet |
| `list-sub-accounts` ·common | `googlesuper.listSubAccounts()` | — | 2 | List direct child/sub-accounts under a Google Ads manager (MCC) account |
| `list-subproperty-event-filters` | `googlesuper.listSubpropertyEventFilters()` | `--parent` | 2 | List all subproperty event filters on a property |
| `list-subproperty-sync-configs` ·common | `googlesuper.listSubpropertySyncConfigs()` | `--parent` | 2 | List SubpropertySyncConfig resources for managing subproperty synchronization configurations |
| `list-tables` ·deprecated | `googlesuper.listTables()` | `--spreadsheet-id` | 3 | Use GOOGLESHEETS_GET_SHEET_NAMES for tab discovery and GOOGLESHEETS_GET_SPREADSHEET_INFO for full sheet metadata |
| `list-task-lists` | `googlesuper.listTaskLists()` | — | 2 | Fetches the authenticated user's task lists from Google Tasks; results may be paginated |
| `list-tasks` | `googlesuper.listTasks()` | `--tasklistId` | 10 | Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified |
| `list-team-drives` | `googlesuper.listTeamDrives()` | — | 15 | List Team Drives (deprecated, use List Shared Drives instead) |
| `list-threads` | `googlesuper.listThreads()` | — | 5 | Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination |
| `list-transcript-entries` ·common | `googlesuper.listTranscriptEntries()` | `--conference-record-id` `--transcript-id` | 2 | List structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript |
| `lookup-aerial-video` | `googlesuper.lookupAerialVideo()` | — | 2 | Look up an aerial view video by address or video ID |
| `lookup-spreadsheet-row` | `googlesuper.lookupSpreadsheetRow()` | `--query` `--spreadsheet-id` | 5 | Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default |
| `maps-embed-api` ·common | `googlesuper.mapsEmbedApi()` | `--mode` | 6 | Generate an embeddable Google Map URL and HTML iframe code |
| `modify-file-labels` ·common | `googlesuper.modifyFileLabels()` | `--file-id` `--label-modifications` | 1 | Modifies the set of labels applied to a file |
| `modify-thread-labels` | `googlesuper.modifyThreadLabels()` | `--thread-id` | 3 | Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid |
| `move-chart` ·common | `googlesuper.moveChart()` | `--chart-id` `--spreadsheet-id` | 9 | Move or resize an existing chart on a Google Sheets spreadsheet |
| `move-file` ·common | `googlesuper.moveFile()` | `--file-id` | 8 | Move a file from one folder to another in Google Drive |
| `move-task` | `googlesuper.moveTask()` | `--task` `--tasklist` | 3 | Moves the specified task to another position in the task list or to a different task list |
| `move-thread-to-trash` ·common | `googlesuper.moveThreadToTrash()` | `--thread-id` | 1 | Moves the specified thread to the trash |
| `move-to-trash` ·common | `googlesuper.moveToTrash()` | `--message-id` | 1 | Moves an existing, non-deleted email message to the trash for the specified user |
| `mutate-ad-group-ads` ·common | `googlesuper.mutateAdGroupAds()` | `--operations` | 4 | Create, update, or remove ads in Google Ads ad groups, including responsive search ads |
| `mutate-ad-group-assets` ·common | `googlesuper.mutateAdGroupAssets()` | `--operations` | 4 | Create, update, or remove links between assets and ad groups |
| `mutate-ad-group-bid-modifiers` ·common | `googlesuper.mutateAdGroupBidModifiers()` | `--operations` | 4 | Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria |
| `mutate-ad-group-criteria` ·common | `googlesuper.mutateAdGroupCriteria()` | `--operations` | 4 | Create, update, or remove criteria attached to a Google Ads ad group in a single batch request |
| `mutate-ad-groups` ·common | `googlesuper.mutateAdGroups()` | `--operations` | 3 | Create, update, or remove ad groups within Google Ads campaigns |
| `mutate-assets` ·common | `googlesuper.mutateAssets()` | `--operations` | 4 | Create or update Google Ads assets such as sitelinks, callouts, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets |
| `mutate-bidding-strategies` ·common | `googlesuper.mutateBiddingStrategies()` | `--operations` | 4 | Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, Target Impression Share, and Enhanced CPC |
| `mutate-campaign-assets` ·common | `googlesuper.mutateCampaignAssets()` | `--operations` | 4 | Create, update, or remove links between assets and campaigns |
| `mutate-campaign-budgets` ·common | `googlesuper.mutateCampaignBudgets()` | `--operations` | 4 | Create, update, or remove Google Ads campaign budgets |
| `mutate-campaign-criteria` ·common | `googlesuper.mutateCampaignCriteria()` | `--operations` | 4 | Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions |
| `mutate-campaign-labels` ·common | `googlesuper.mutateCampaignLabels()` | `--operations` | 3 | Create or remove relationships between campaigns and labels |
| `mutate-campaigns` ·common | `googlesuper.mutateCampaigns()` | `--operations` | 4 | Create, update, or remove Google Ads campaigns in batch |
| `mutate-conditional-format-rules` ·common | `googlesuper.mutateConditionalFormatRules()` | `--operation` `--sheet-id` `--spreadsheet-id` | 3 | Add, update, delete, or reorder conditional format rules on a Google Sheet |
| `mutate-conversion-actions` ·common | `googlesuper.mutateConversionActions()` | `--operations` | 4 | Create, update, or remove Google Ads conversion actions for conversion tracking configuration |
| `mutate-labels` ·common | `googlesuper.mutateLabels()` | `--operations` | 4 | Create, update, or remove Google Ads labels |
| `nearby-search` | `googlesuper.nearbySearch()` | `--latitude` `--longitude` `--radius` | 4 | Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results |
| `parse-file` ·common ·deprecated | `googlesuper.parseFile()` | `--file-id` | 1 | Exports Google Workspace files (max 10MB) to a specified format using `mime_type`, or downloads other file types; use `GOOGLEDRIVE_DOWNLOAD_FILE` instead |
| `patch-calendar` ·common | `googlesuper.patchCalendar()` | `--calendar-id` | 4 | Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided |
| `patch-event` ·common | `googlesuper.patchEvent()` | `--calendar-id` `--event-id` | 31 | Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are… |
| `patch-label` ·common | `googlesuper.patchLabel()` | `--id` `--userId` | 4 | Patches the specified user-created label |
| `patch-permission` ·common | `googlesuper.patchPermission()` | `--file-id` `--permission-id` | 8 | Update a permission using patch semantics |
| `patch-property` | `googlesuper.patchProperty()` | `--fileId` `--propertyKey` | 13 | Update a property on a file using PATCH semantics (v2 API) |
| `patch-send-as` ·common | `googlesuper.patchSendAs()` | `--send-as-email` | 7 | Patch the specified send-as alias for a Gmail user |
| `patch-task` | `googlesuper.patchTask()` | `--task-id` `--tasklist-id` | 9 | Partially updates an existing task (identified by `task_id`) within a specific Google Task list (identified by `tasklist_id`), modifying only the provided attributes from `TaskInput` (e.g., `title`… |
| `patch-task-list` | `googlesuper.patchTaskList()` | `--tasklist-id` | 1 | Updates the title of an existing Google Tasks task list |
| `place-photo` ·common | `googlesuper.placePhoto()` | `--photo-reference` | 2 | Retrieves high quality photographic content from the Google Maps Places database |
| `presentations-batch-update` ·common | `googlesuper.presentationsBatchUpdate()` | `--presentationId` | 3 | Update Google Slides presentations using markdown content or raw API text |
| `presentations-copy-from-template` ·common | `googlesuper.presentationsCopyFromTemplate()` | `--template-presentation-id` | 2 | Create a new Google Slides presentation by duplicating an existing template deck via Drive file copy |
| `presentations-get` ·common | `googlesuper.presentationsGet()` | — | 3 | Retrieve the latest version of a presentation |
| `presentations-pages-get` ·common | `googlesuper.presentationsPagesGet()` | `--pageObjectId` `--presentationId` | 0 | Get the latest version of a specific page in a presentation |
| `presentations-pages-get-thumbnail` ·deprecated | `googlesuper.presentationsPagesGetThumbnail()` | `--pageObjectId` `--presentationId` | 2 | Use GOOGLESLIDES_GET_PAGE_THUMBNAIL2 instead |
| `provision-account-ticket` ·common | `googlesuper.provisionAccountTicket()` | `--account` `--redirectUri` | 0 | Request a ticket for creating a Google Analytics account |
| `query-audience-export` ·common | `googlesuper.queryAudienceExport()` | `--name` | 2 | Query a completed audience export |
| `query-audience-list` ·common | `googlesuper.queryAudienceList()` | `--name` | 2 | Query an audience list |
| `query-report-task` ·common | `googlesuper.queryReportTask()` | `--name` | 2 | Retrieve a report task's content |
| `query-table` ·deprecated | `googlesuper.queryTable()` | `--spreadsheet-id` `--sql` | 1 | Use GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for table reads and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup/filter workflows |
| `quick-add` | `googlesuper.quickAdd()` | — | 3 | Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring… |
| `remove-attendee` | `googlesuper.removeAttendee()` | `--attendee-email` `--event-id` | 1 | Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist |
| `remove-label` ·deprecated | `googlesuper.removeLabel()` | `--label-id` | 1 | Use GMAIL_DELETE_LABEL instead |
| `render-aerial-video` ·common | `googlesuper.renderAerialVideo()` | `--address` | 0 | Starts rendering an aerial view video for a US postal address |
| `replace-all-text` ·common | `googlesuper.replaceAllText()` | `--document-id` `--find-text` `--replace-text` | 3 | Replace all occurrences of a specified text string with another text string throughout a Google Document |
| `replace-image` ·common | `googlesuper.replaceImage()` | `--document-id` `--replace-image` | 0 | Replace a specific image in a document with a new image from a URI |
| `reply-to-thread` ·common | `googlesuper.replyToThread()` | `--thread-id` | 8 | Sends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread |
| `resumable-upload` ·common | `googlesuper.resumableUpload()` | `--file-to-upload` | 5 | Start and complete a Google Drive resumable upload session |
| `run-funnel-report` ·common | `googlesuper.runFunnelReport()` | `--funnel` `--property` | 8 | Run a GA4 funnel report |
| `run-pivot-report` ·common | `googlesuper.runPivotReport()` | `--metrics` `--property` | 10 | Run a customized pivot report of Google Analytics event data |
| `run-realtime-report` ·common | `googlesuper.runRealtimeReport()` | `--property` | 9 | Run a customized realtime report of Google Analytics event data |
| `run-report` ·common | `googlesuper.runReport()` | `--property` | 15 | Run a customized GA4 data report |
| `search-developer-metadata` ·common | `googlesuper.searchDeveloperMetadata()` | `--dataFilters` `--spreadsheetId` | 0 | Search for developer metadata in a spreadsheet |
| `search-documents` | `googlesuper.searchDocuments()` | — | 11 | Search for Google Documents using various filters including name, content, date ranges, and more |
| `search-media-items` | `googlesuper.searchMediaItems()` | — | 5 | Searches for media items in a user's Google Photos library |
| `search-people` ·common | `googlesuper.searchPeople()` | `--query` | 3 | Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts' |
| `search-spreadsheets` ·common | `googlesuper.searchSpreadsheets()` | — | 11 | Search for Google Spreadsheets using various filters including name, content, date ranges, and more |
| `search-stream-gaql` ·common | `googlesuper.searchStreamGaql()` | `--query` | 2 | Execute a Google Ads Query Language (GAQL) query and stream all results in a single response |
| `send-draft` ·common | `googlesuper.sendDraft()` | `--draft-id` | 1 | Sends an existing draft email AS-IS to recipients already defined within the draft |
| `send-email` ·common | `googlesuper.sendEmail()` | — | 10 | Sends an email via Gmail API using the authenticated user's Google profile display name |
| `send-events` ·common | `googlesuper.sendEvents()` | `--api-secret` `--client-id` `--events` `--measurement-id` | 4 | Send event data to Google Analytics 4 using the Measurement Protocol |
| `set-basic-filter` ·common | `googlesuper.setBasicFilter()` | `--filter` `--spreadsheetId` | 3 | Set a basic filter on a sheet in a Google Spreadsheet |
| `set-data-validation-rule` ·common | `googlesuper.setDataValidationRule()` | `--end-column-index` `--end-row-index` `--mode` `--sheet-id` `--spreadsheet-id` `--start-column-index` `--start-row-index` | 9 | Set or clear data validation rules (including dropdowns) on a range in Google Sheets |
| `settings-get` | `googlesuper.settingsGet()` | `--setting` | 0 | Return a single user setting for the authenticated user |
| `settings-get-imap` | `googlesuper.settingsGetImap()` | — | 1 | Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size |
| `settings-get-pop` | `googlesuper.settingsGetPop()` | — | 1 | Retrieve POP settings for a Gmail account |
| `settings-list` | `googlesuper.settingsList()` | — | 3 | Returns all user settings for the authenticated user |
| `settings-send-as-get` | `googlesuper.settingsSendAsGet()` | `--send-as-email` | 1 | Retrieve a specific send-as alias configuration for a Gmail user |
| `settings-watch` | `googlesuper.settingsWatch()` | `--address` `--id` `--type` | 3 | Watch for changes to Settings resources |
| `sheet-from-json` ·deprecated | `googlesuper.sheetFromJson()` | `--sheet-json` `--sheet-name` `--title` | 0 | Use GOOGLESHEETS_CREATE_GOOGLE_SHEET1 + GOOGLESHEETS_UPDATE_VALUES_BATCH (or GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND) instead |
| `sort-range` ·common | `googlesuper.sortRange()` | `--range` `--sortSpecs` `--spreadsheet-id` | 3 | Sorts data within a specified range in a Google Sheet based on one or more sort criteria |
| `spreadsheets-sheets-copy-to` ·common | `googlesuper.spreadsheetsSheetsCopyTo()` | `--destination-spreadsheet-id` `--sheet-id` `--spreadsheet-id` | 0 | Copy a single sheet from a spreadsheet to another spreadsheet |
| `spreadsheets-values-append` ·common | `googlesuper.spreadsheetsValuesAppend()` | `--range` `--spreadsheetId` `--valueInputOption` `--values` | 5 | Append values to a spreadsheet |
| `spreadsheets-values-batch-clear` ·common | `googlesuper.spreadsheetsValuesBatchClear()` | `--ranges` `--spreadsheet-id` | 0 | Clear one or more ranges of values from a spreadsheet |
| `spreadsheets-values-batch-get-by-data-filter` ·common | `googlesuper.spreadsheetsValuesBatchGetByDataFilter()` | `--dataFilters` `--spreadsheetId` | 3 | Return one or more ranges of values from a spreadsheet that match the specified data filters |
| `stop-watch` | `googlesuper.stopWatch()` | — | 1 | Stop receiving push notifications for a Gmail mailbox |
| `stop-watch-channel` ·common | `googlesuper.stopWatchChannel()` | `--id` `--resourceId` | 8 | Stop watching resources through a specified channel |
| `sync-events` ·common ·deprecated | `googlesuper.syncEvents()` | — | 6 | Use GOOGLECALENDAR_EVENTS_LIST instead |
| `text-search` ·common | `googlesuper.textSearch()` | `--textQuery` | 2 | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower") |
| `tiles-create-session` | `googlesuper.tilesCreateSession()` | `--language` `--mapType` `--region` | 6 | Create a session token required for accessing 2D Tiles and Street View imagery |
| `trash-file` ·common | `googlesuper.trashFile()` | `--file-id` | 2 | Move a file or folder to trash (soft delete) |
| `unhide-drive` ·common | `googlesuper.unhideDrive()` | `--driveId` | 0 | Unhide a shared drive |
| `unmerge-table-cells` ·common | `googlesuper.unmergeTableCells()` | `--documentId` `--tableRange` | 0 | Unmerge previously merged cells in a table |
| `untrash-file` ·common | `googlesuper.untrashFile()` | `--file-id` | 1 | Restore a file from the trash |
| `untrash-message` ·common | `googlesuper.untrashMessage()` | `--message-id` | 1 | Remove a message from trash in Gmail |
| `untrash-thread` ·common | `googlesuper.untrashThread()` | `--thread-id` | 1 | Remove a thread from trash in Gmail |
| `update-album` | `googlesuper.updateAlbum()` | `--albumId` | 2 | Updates an album's title or cover photo in Google Photos |
| `update-chart` | `googlesuper.updateChart()` | `--chart-id` `--chart-spec` `--spreadsheet-id` | 0 | Update the specification of an existing chart in a Google Sheets spreadsheet |
| `update-comment` ·common | `googlesuper.updateComment()` | `--comment-id` `--file-id` | 3 | Update an existing comment on a Google Drive file |
| `update-dimension-properties` ·common | `googlesuper.updateDimensionProperties()` | `--dimension` `--end-index` `--spreadsheet-id` `--start-index` | 7 | Hide/unhide rows or columns and set row heights or column widths |
| `update-document-batch` ·common ·deprecated | `googlesuper.updateDocumentBatch()` | `--document-id` `--requests` | 1 | Use UpdateExistingDocument instead |
| `update-document-markdown` | `googlesuper.updateDocumentMarkdown()` | `--id` `--markdown` | 1 | Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document |
| `update-document-section-markdown` ·common | `googlesuper.updateDocumentSectionMarkdown()` | `--document-id` `--markdown-text` | 3 | Insert or replace a section of a Google Docs document with Markdown content |
| `update-document-style` ·common | `googlesuper.updateDocumentStyle()` | `--document-id` `--document-style` | 2 | Update the overall document style, such as page size, margins, and default text direction |
| `update-draft` ·common | `googlesuper.updateDraft()` | `--draft-id` | 10 | Updates (replaces) an existing Gmail draft's content in-place by draft ID |
| `update-drive` ·common | `googlesuper.updateDrive()` | `--driveId` | 7 | Update the metadata for a shared drive |
| `update-event` ·common | `googlesuper.updateEvent()` | `--event-id` `--start-datetime` | 23 | Updates an existing event in Google Calendar |
| `update-existing-document` | `googlesuper.updateExistingDocument()` | `--document-id` `--edit-docs` | 0 | Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method |
| `update-file-metadata-patch` ·common | `googlesuper.updateFileMetadataPatch()` | `--fileId` | 22 | Update file metadata using the Drive API v2 PATCH method |
| `update-file-property` | `googlesuper.updateFileProperty()` | `--fileId` `--propertyKey` | 14 | Update a property on a file using Google Drive API v2 |
| `update-file-put` ·common | `googlesuper.updateFilePut()` | `--fileId` | 12 | Updates file metadata |
| `update-file-revision-metadata` ·common | `googlesuper.updateFileRevisionMetadata()` | `--file-id` `--revision-id` | 4 | Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain) |
| `update-imap-settings` | `googlesuper.updateImapSettings()` | — | 5 | Update IMAP settings for a Gmail account |
| `update-label` ·common | `googlesuper.updateLabel()` | `--id` | 5 | Update the properties of an existing Gmail label |
| `update-language-settings` | `googlesuper.updateLanguageSettings()` | `--display-language` | 1 | Update the language settings for a Gmail user |
| `update-media-item` | `googlesuper.updateMediaItem()` | `--description` `--mediaItemId` | 0 | Updates a media item's description in Google Photos |
| `update-permission` ·common | `googlesuper.updatePermission()` | `--fileId` `--permission` `--permissionId` | 5 | Update a permission with patch semantics |
| `update-pop-settings` | `googlesuper.updatePopSettings()` | — | 3 | Update POP settings for a Gmail account |
| `update-property` ·common | `googlesuper.updateProperty()` | `--name` `--updateMask` | 6 | Update an existing GA4 Property |
| `update-reply` ·common | `googlesuper.updateReply()` | `--comment-id` `--content` `--file-id` `--reply-id` | 1 | Update a reply to a comment on a Google Drive file |
| `update-send-as` | `googlesuper.updateSendAs()` | `--send-as-email` | 7 | Update a send-as alias for a Gmail user |
| `update-sheet-properties` ·common | `googlesuper.updateSheetProperties()` | `--spreadsheetId` `--updateSheetProperties` | 3 | Update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties |
| `update-space` ·common | `googlesuper.updateSpace()` | `--name` | 2 | Updates the settings of an existing Google Meet space |
| `update-spreadsheet-properties` ·common | `googlesuper.updateSpreadsheetProperties()` | `--fields` `--properties` `--spreadsheetId` | 3 | Update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings |
| `update-tab-properties` | `googlesuper.updateTabProperties()` | `--document-id` `--tab-id` `--tab-properties` | 1 | Updates properties of a document tab such as title, parent tab, index, and icon emoji |
| `update-table-row-style` ·common | `googlesuper.updateTableRowStyle()` | `--documentId` `--updateTableRowStyle` | 0 | Update the style of a table row in a Google Document |
| `update-task` ·deprecated | `googlesuper.updateTask()` | `--task-id` `--tasklist-id` | 5 | Use GOOGLETASKS_PATCH_TASK instead |
| `update-task-full` ·common | `googlesuper.updateTaskFull()` | `--id` `--task-id` `--tasklist-id` `--title` | 10 | Fully replace an existing Google Task using PUT method |
| `update-task-list` | `googlesuper.updateTaskList()` | `--tasklist-id` `--title` | 0 | Updates the authenticated user's specified task list |
| `update-team-drive` | `googlesuper.updateTeamDrive()` | `--teamDriveId` | 6 | Update a Team Drive's metadata |
| `update-user-attributes-values` | `googlesuper.updateUserAttributesValues()` | `--attributes` `--resourceId` `--resourceType` `--userId` | 0 | Update user attribute values for a resource |
| `update-vacation-settings` | `googlesuper.updateVacationSettings()` | — | 9 | Update vacation responder settings for a Gmail user |
| `update-values-batch` ·common | `googlesuper.updateValuesBatch()` | `--data` `--spreadsheet-id` `--valueInputOption` | 3 | Set values in one or more ranges of a spreadsheet |
| `upload-file` ·common | `googlesuper.uploadFile()` | `--file-to-upload` | 1 | Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided |
| `upload-from-url` ·common | `googlesuper.uploadFromUrl()` | `--name` `--source-url` | 5 | Fetch a file from a provided URL server-side and upload it into Google Drive |
| `upload-media` | `googlesuper.uploadMedia()` | — | 4 | Upload a media file to Google Photos |
| `upload-update-file` ·common | `googlesuper.uploadUpdateFile()` | `--fileId` `--file-to-upload` | 7 | Update file content in Google Drive by uploading new binary content |
| `upsert-rows` ·common | `googlesuper.upsertRows()` | `--rows` `--sheetName` `--spreadsheetId` | 6 | Upsert rows - update existing rows by key, append new ones |
| `validate-events` ·common | `googlesuper.validateEvents()` | `--api-secret` `--client-id` `--events` `--measurement-id` | 4 | Validate Measurement Protocol events before sending them to production |
| `values-get` ·common | `googlesuper.valuesGet()` | `--range` `--spreadsheet-id` | 5 | Returns a range of values from a spreadsheet |
| `values-update` ·common | `googlesuper.valuesUpdate()` | `--range` `--spreadsheet-id` `--value-input-option` `--values` | 5 | Set values in a range of a Google Spreadsheet |
| `watch-changes` ·common | `googlesuper.watchChanges()` | `--address` `--id` `--type` | 14 | Subscribe to changes for a user or shared drive in Google Drive |
| `watch-file` ·common | `googlesuper.watchFile()` | `--address` `--fileId` `--id` `--type` | 9 | Subscribe to push notifications for changes to a specific file |

## Triggers

`googlesuper.on("<event>", handler)` in a script; required config goes before the handler as an object.

| Event | Name | Required config | Description |
|---|---|---|---|
| `"aggregate-metric-changed"` | Aggregate Metric Changed | `spreadsheet_id` `sheet_name` `target_column` `operation` | Triggers when an aggregate metric (SUM/COUNT/AVG/MIN/MAX) changes in a Google Sheets spreadsheet |
| `"attendee-response-changed"` | Attendee Response Changed | — | Polling trigger that fires when any attendee's RSVP changes to accepted, declined, or tentative |
| `"cell-range-values-changed"` | Cell Range Values Changed | `spreadsheet_id` `range` | Triggers when values in a specified A1 range change in Google Sheets |
| `"comment-added"` | Comment Added (Docs/Sheets/Slides) | — | Triggers when a new comment is added to Google Docs, Sheets, or Slides |
| `"conditional-format-rule-changed"` | Conditional Format Rule Changed | `spreadsheet_id` | Triggers when conditional formatting rules change in a Google Spreadsheet |
| `"data-validation-rule-changed"` | Data Validation Rule Changed | `spreadsheet_id` | Triggers when data validation rules change (added/updated/removed) in a Google Spreadsheet |
| `"developer-metadata-changed"` | Developer Metadata Changed | `spreadsheet_id` | Triggers when developer metadata entries change (new/updated/removed) in a Google Spreadsheet |
| `"document-created"` | New Document Created | — | Triggers when a new Google Doc is created |
| `"document-deleted"` | Document Deleted | — | Triggers when an existing Google Doc is deleted (moved to trash) |
| `"document-placeholder-filled"` | Document Placeholder Filled | `document_id` `placeholder_pattern` | Triggers when a Google Doc's plain text changes such that a configured placeholder token/pattern is no longer present (i.e., the document ha |
| `"document-search-update"` | Document Search Update | `query` | Triggers when a Google Doc matching a user-defined search query is newly created or updated since the last poll |
| `"document-structure-changed"` | Document Structure Changed | `document_id` | Triggers when a Google Doc's structure changes (headers/footers added/removed, tables/images count changes) |
| `"document-updated"` | Document Updated | — | Triggers when an existing Google Doc is updated or modified |
| `"document-word-count-threshold"` | Document Word Count Threshold | `document_id` | Triggers when a Google Doc's word/character count crosses a user-defined threshold |
| `"email-sent"` | Email Sent | — | Triggers when a Gmail message is sent by the authenticated user |
| `"event-canceled-deleted"` | Event Canceled or Deleted | — | Triggers when a Google Calendar event is cancelled or deleted |
| `"event-starting-soon"` | Event Starting Soon | — | Triggers when a calendar event is within a configured number of minutes from starting |
| `"file-created"` | File Created | — | Triggers when a new file is created in Google Drive |
| `"file-deleted-or-trashed"` | File Deleted or Trashed | — | Triggers when a file is moved to trash or permanently deleted in Drive |
| `"file-shared-permissions-added"` | File Shared (Permissions Added) | — | Triggers when new sharing permissions are granted to a file or folder |
| `"file-updated"` | File Updated | — | Triggers when a file's metadata or content changes in Google Drive |
| `"filtered-range-values-changed"` | Filtered Range Values Changed | `spreadsheet_id` `data_filters` | Polling trigger that monitors Google Sheets filtered ranges for value changes |
| `"folder-created"` | New Folder Created in Root | — | Triggers when a new folder is created in the root folder of Google Drive |
| `"google-calendar-event-change"` | Calendar Event Changes | — | SOON TO BE DEPRECATED - Use Calendar Event Sync (polling trigger) instead |
| `"google-calendar-event-created"` | Event Created | — | Polling trigger that fires when a new calendar event is created |
| `"google-calendar-event-sync"` | Calendar Event Sync | — | Polling trigger that returns full event data including details, attendees, and metadata |
| `"google-calendar-event-updated"` | Event Updated | — | Triggers when an existing Google Calendar event is modified |
| `"google-drive-changes"` | Google Drive Changes | — | Triggers when changes are detected in a Google Drive |
| `"keyword-detected"` | Keyword Detected in Document | `document_id` `keyword` | Triggers when a specific keyword or phrase first appears in a Google Doc |
| `"new-file-matching-query"` | New File Matching Query | — | Triggers when a new Google Drive file matches a provided query |
| `"new-message"` | New Gmail Message Received Trigger | — | Triggers when a new message is received in Gmail |
| `"new-rows"` | New Rows in Google Sheet | `spreadsheet_id` | Simple polling trigger that monitors Google Sheets for new rows |
| `"new-sheet-added"` | New Sheet Added in Google Spreadsheet | `spreadsheet_id` | Polling trigger that detects when a new sheet is added to a Google Spreadsheet |
| `"new-spreadsheet-created"` | New Spreadsheet Created | — | Triggers when a new Google Spreadsheet is created |
| `"new-task-created"` | New Task Created | — | Triggers when a new task is created in a Google Tasks list |
| `"new-task-list-created"` | New Task List Created | — | Triggers when a new Google Tasks task list is created |
| `"page-added"` | New Document Added | — | Triggers when a new Google Doc is added/created |
| `"slide-added"` | New Slide Added | `presentation_id` | Fires when a new slide is added to a Google Slides presentation |
| `"spreadsheet-metadata-changed"` | Spreadsheet Metadata Changed | `spreadsheet_id` | Polling trigger that detects when a Google Spreadsheet's metadata changes |
| `"spreadsheet-properties-changed"` | Spreadsheet Properties Changed | `spreadsheet_id` | Polling trigger that detects when a Google Spreadsheet's top-level properties change |
| `"spreadsheet-row-changed"` | Spreadsheet Row Changed | `spreadsheet_id` `query` | Triggers when a looked-up spreadsheet row changes |
| `"spreadsheet-search-match"` | Spreadsheet Search Match | — | Triggers when a new spreadsheet appears that matches a saved search |
| `"table-query-result-changed"` | Table Query Result Changed | `spreadsheet_id` `sql` | Triggers when the result set of a saved table query changes in Google Sheets |
| `"table-schema-changed"` | Table Schema Changed | `spreadsheet_id` `table_name` | Polling trigger that detects when a table's schema changes in Google Sheets |
| `"task-details-changed"` | Task Details Changed | `tasklist_id` `task_id` | Triggers when a specific task's details change |
| `"task-list-changed"` | Task List Changed | `tasklist_id` | Triggers when a task list changes (title or content updates) |
| `"task-updated"` | Task Updated | — | Triggers when an existing task is updated in a Google Tasks list |
| `"worksheet-names-changed"` | Worksheet Names Changed | `spreadsheet_id` | Triggers when the set of worksheet/tab names changes in a Google Spreadsheet |

## Docs

- [run CLI](https://docs.boxd.sh/cli/run): Call connected integrations from the shell, connect new ones, and run automations.
- [Quickstart](https://docs.boxd.sh/guides/integrations/quickstart): Connect an integration, call it from the shell, and turn a script into an automation.
- [Connections](https://docs.boxd.sh/guides/integrations/connections): Connect an account once, for yourself or for your whole organization.
- [Scripts](https://docs.boxd.sh/guides/automations/scripts): Typed integrations, triggers, schedules and state in a .run.ts file.
- [Jobs](https://docs.boxd.sh/guides/automations/jobs): How a script becomes a background job: states, retries, sleep and wake.
- [Beyond the catalog](https://docs.boxd.sh/guides/automations/beyond-the-catalog): Reach your own APIs, databases and cloud accounts from a script.