> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Google Workspace > Google Super App combines all Google services including Drive, Calendar, Gmail, Sheets, Analytics, Ads, and more, providing a unified platform for seamless integration and manageme 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. `googlesuper` · **467 tools** · **48 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth googlesuper run auth googlesuper --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run googlesuper # common commands run googlesuper --all # every command ``` ```ts theme={"theme":"github-dark"} import { googlesuper } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `acl-delete` | Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain. | | `acl-get` | Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain. | | `acl-insert` | Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain. | | `add-file-sharing-preference` | DEPRECATED: Use GOOGLEDRIVE\_CREATE\_PERMISSION instead; use GOOGLEDRIVE\_UPDATE\_PERMISSION to modify existing permissions (avoids duplicate entries). | | `add-sheet` | Adds a new sheet to a spreadsheet. Supports three sheet types: GRID, OBJECT, and DATA\_SOURCE. | | `append-dimension` | Tool to append new rows or columns to a sheet, increasing its size. | | `autocomplete` | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. | | `batch-clear-values-by-data-filter` | Clears one or more ranges of values from a spreadsheet using data filters. | | `batch-get` | Retrieves data from specified cell ranges in a Google Spreadsheet. | | `batch-modify-messages` | Modify labels on multiple Gmail messages in one efficient API call. | | `batch-run-pivot-reports` | Tool to return multiple pivot reports in a batch for a GA4 property. | | `batch-run-reports` | Tool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request. | | `batch-update` | DEPRECATED: Use GOOGLESHEETS\_VALUES\_UPDATE instead. Write values to ONE range in a Google Sheet, or append as new rows if no start cell is given. | | `calendar-list-delete` | Tool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list. | | `calendar-list-get` | Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. | | `calendar-list-insert` | Inserts an existing calendar into the user's calendar list, making it visible in the UI. | | `calendar-list-patch` | Updates an existing calendar on the user's calendar list using patch semantics. | | `calendars-delete` | Deletes a secondary calendar that you own or have delete permissions on. | | `calendars-update` | Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. | | `channels-stop` | Tool to stop watching resources through a notification channel. | | `check-compatibility` | Tool to list dimensions and metrics compatible with a GA4 report request. | | `clear-basic-filter` | Tool to clear the basic filter from a sheet. Use when you need to remove an existing basic filter from a specific sheet within a Google Spreadsheet. | | `compute-route-matrix` | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication... | | `copy-document` | Tool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. | | `create-and-populate-table` | Creates a new table in a Google Document and populates its cells with provided text data in a single operation. | | Tool | What it does | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `acl-delete` | Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain. | | `acl-get` | Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain. | | `acl-insert` | Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain. | | `acl-list` | 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` | Updates an existing access control rule for a calendar using patch semantics (partial update). | | `acl-update` | Updates an access control rule for the specified calendar. | | `acl-watch` | Tool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar. | | `add-enrichment` | Adds an enrichment at a specified position in a defined album. | | `add-file-sharing-preference` | DEPRECATED: Use GOOGLEDRIVE\_CREATE\_PERMISSION instead; use GOOGLEDRIVE\_UPDATE\_PERMISSION to modify existing permissions (avoids duplicate entries). | | `add-label-to-email` | 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` | Adds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. | | `add-parent` | Tool to add a parent folder for a file using Google Drive API v2. | | `add-property` | Tool to add a property to a file, or update it if it already exists (v2 API). | | `add-sheet` | Adds a new sheet to a spreadsheet. Supports three sheet types: GRID, OBJECT, and DATA\_SOURCE. | | `aggregate-column-data` | Searches for rows where a specific column matches a value and performs mathematical operations on data from another column. | | `append-dimension` | Tool to append new rows or columns to a sheet, increasing its size. | | `archive-custom-dimension` | Tool to archive a CustomDimension on a property. Use when you need to remove a custom dimension from active use without permanently deleting it. | | `autocomplete` | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. | | `auto-resize-dimensions` | Auto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions. | | `batch-add-media-items` | Adds one or more media items to an album in Google Photos. | | `batch-clear-values-by-data-filter` | Clears one or more ranges of values from a spreadsheet using data filters. | | `batch-create-media-items` | Batch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted... | | `batch-delete-messages` | Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. | | `batch-events` | Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. | | `batch-execute` | Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. | | `batch-get` | Retrieves data from specified cell ranges in a Google Spreadsheet. | | `batch-get-media-items` | Returns the list of media items for the specified media item identifiers. | | `batch-modify-messages` | Modify labels on multiple Gmail messages in one efficient API call. | | `batch-run-pivot-reports` | Tool to return multiple pivot reports in a batch for a GA4 property. | | `batch-run-reports` | Tool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request. | | `batch-update` | DEPRECATED: Use GOOGLESHEETS\_VALUES\_UPDATE instead. Write values to ONE range in a Google Sheet, or append as new rows if no start cell is given. | | `batch-update-values-by-data-filter` | Tool to update values in ranges matching data filters. Use when you need to update specific data in a Google Sheet based on criteria rather than fixed cell ranges. | | `bulk-insert-tasks` | DEPRECATED: Use BatchExecute instead. Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching. | | `calendar-list-delete` | Tool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list. | | `calendar-list-get` | Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. | | `calendar-list-insert` | Inserts an existing calendar into the user's calendar list, making it visible in the UI. | | `calendar-list-patch` | Updates an existing calendar on the user's calendar list using patch semantics. | | `calendar-list-update` | Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user - does not modify... | | `calendar-list-watch` | Watch for changes to CalendarList resources using push notifications. | | `calendars-delete` | Deletes a secondary calendar that you own or have delete permissions on. | | `calendars-update` | Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. | | `channels-stop` | Tool to stop watching resources through a notification channel. | | `check-compatibility` | Tool to list dimensions and metrics compatible with a GA4 report request. | | `clear-basic-filter` | Tool to clear the basic filter from a sheet. Use when you need to remove an existing basic filter from a specific sheet within a Google Spreadsheet. | | `clear-calendar` | Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. | | `clear-tasks` | Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. | | `clear-values` | Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an... | | `colors-get` | Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events. | | `compute-route-matrix` | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication... | | `copy-document` | Tool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. | | `copy-file` | DEPRECATED: Use GOOGLEDRIVE\_COPY\_FILE\_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by `file_id`; copy lands in same... | | `copy-file-advanced` | Creates a copy of a file and applies any requested updates with patch semantics. | | `create-album` | Creates a new album in Google Photos. | | `create-and-populate-table` | Creates a new table in a Google Document and populates its cells with provided text data in a single operation. | | `create-audience-export` | Tool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. | | `create-audience-list` | Tool to create an audience list for later retrieval by initiating a long-running asynchronous request. | | `create-calendar` | Creates a new secondary Google Calendar with the specified title and optional settings. | | `create-chart` | Create a chart in a Google Sheets spreadsheet using the specified data range and chart type. | | `create-comment` | Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. | | `create-custom-dimension` | Tool to create a CustomDimension for a Google Analytics property. | | `create-customer-list` | Creates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. | | `create-custom-metric` | Tool to create a custom metric in Google Analytics. Use when you need to define a new custom metric for tracking specific event parameters. | | `create-document` | 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... | | `create-document2` | DEPRECATED: Use GOOGLEDOCS\_CREATE\_DOCUMENT instead. Tool to create a blank Google Docs document with a specified title. | | `create-document-markdown` | Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text. | | `create-drive` | Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage. | | `create-email-draft` | Creates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient\_email, cc, or... | | `create-event` | Create a Google Calendar event using start\_datetime plus duration fields. | | `create-expanded-data-set` | Tool to create an expanded data set for a property. Use when you need to combine specific dimensions and metrics into a custom dataset after property creation. | | `create-file` | Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. | | `create-file-from-text` | 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` | Tool to create a new Gmail filter with specified criteria and actions. | | `create-folder` | Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. | | `create-footer` | Tool to create a new footer in a Google Document. Use when you need to add a footer, optionally specifying its type and the section it applies to. | | `create-footnote` | Tool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body. | | `create-google-sheet1` | Creates a new Google Spreadsheet in Google Drive. If a title is provided, the spreadsheet will be created with that name. | | `create-header` | Tool to create a new header in a Google Document, optionally with text content. | | `create-label` | Creates a new label with a unique name in the specified user's Gmail account. | | `create-meet` | Creates a new Google Meet space with optional configuration. | | `create-named-range` | Tool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation. | | `create-paragraph-bullets` | Tool to add bullets to paragraphs within a specified range in a Google Document. | | `create-permission` | Tool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly... | | `create-permissions-batch` | Creates multiple permissions for files or shared drives in a single batch request. | | `create-presentation` | Tool to create a blank Google Slides presentation. Use when you need to initialize a new presentation with a specific title, locale, or page size. | | `create-prompt-post` | Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. | | `create-recurring-audience-list` | Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data. | | `create-reply` | Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file. | | `create-report-task` | Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports. | | `create-rollup-property` | Tool to create a roll-up property. Use when consolidating multiple GA4 properties into one aggregated view. | | `create-shortcut-to-file` | Tool to create a shortcut to a file or folder in Google Drive. | | `create-slides-markdown` | Creates a new Google Slides presentation from Markdown text. | | `create-spreadsheet-column` | Creates a new column in a Google Spreadsheet. Specify the target sheet using sheet\_id (numeric) or sheet\_name (text). | | `create-spreadsheet-row` | 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` | Creates a new tab in a Google Docs document. Tabs allow you to organize document content into separate sections within a single document. | | `create-task-list` | Creates a new task list with the specified title and returns a tasklist\_id. | | `create-team-drive` | Tool to create a Team Drive. Deprecated: Use drives.create instead. | | `delete-chart` | Delete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. | | `delete-child` | Tool to remove a child from a folder using Google Drive API v2. | | `delete-comment` | Permanently deletes a comment thread (and all its replies) from a Google Drive file - this action is irreversible. | | `delete-content-range` | Tool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document. | | `delete-dimension` | Tool to delete specified rows or columns from a sheet in a Google Spreadsheet. | | `delete-draft` | 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` | Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified). | | `delete-event` | 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` | DEPRECATED: Use GOOGLEDRIVE\_GOOGLE\_DRIVE\_DELETE\_FOLDER\_OR\_FILE\_ACTION instead. | | `delete-filter` | Tool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule. | | `delete-footer` | Tool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer. | | `delete-header` | Deletes the header from the specified section or the default header if no section is specified. | | `delete-label` | Permanently DELETES a user-created Gmail label from the account (not from a message). | | `delete-message` | 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... | | `delete-named-range` | Tool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name. | | `delete-paragraph-bullets` | Tool to remove bullets from paragraphs within a specified range in a Google Document. | | `delete-parent` | Tool to remove a parent from a file using Google Drive API v2. | | `delete-permission` | Deletes a permission from a file by permission ID. Deletion is irreversible - confirm the target user, group, or permission type before executing. | | `delete-property` | Tool to delete a property from a file using Google Drive API v2. | | `delete-reply` | Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. | | `delete-revision` | Tool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). | | `delete-sheet` | Tool to delete a sheet (worksheet) from a spreadsheet. Use when you need to remove a specific sheet from a Google Sheet document. | | `delete-tab` | Deletes a tab from a Google Document. This action is irreversible - the tab cannot be recovered once removed. | | `delete-table-column` | Tool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document. | | `delete-table-row` | Tool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table. | | `delete-task` | Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible - confirm with the user before executing, and consider... | | `delete-task-list` | Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. | | `delete-team-drive` | Tool to permanently delete a Team Drive. Deprecated: Use drives.delete instead. | | `delete-thread` | Tool to immediately and permanently delete a specified thread and all its messages. | | `distance-matrix-api` | DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. | | `download-file` | Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified `mime_type`. | | `download-file2` | DEPRECATED: Use GOOGLEDRIVE\_DOWNLOAD\_FILE\_OPERATION instead. | | `download-file-operation` | Tool to download file content using long-running operations. | | `duplicate-calendar` | Creates a new, empty Google Calendar with the specified title (summary). | | `edit-file` | Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). | | `empty-trash` | Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. | | `end-active-conference` | Ends an active conference in a Google Meet space. REQUIRES 'space\_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). | | `events-get` | Retrieves a SINGLE event by its unique event\_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. | | `events-import` | Tool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. | | `events-instances` | Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. | | `events-list` | Returns events on the specified calendar. TIMEZONE WARNING: When using timeMin/timeMax with UTC timestamps (ending in 'Z'), the time window is... | | `events-list-all-calendars` | Return a unified event list across all calendars in the user's calendar list for a given time range. | | `events-move` | Moves an event to another calendar, i.e., changes an event's organizer. | | `events-watch` | Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts. | | `execute-sql` | DEPRECATED: Use direct Google Sheets actions instead: - GOOGLESHEETS\_VALUES\_GET / GOOGLESHEETS\_BATCH\_GET for reads - GOOGLESHEETS\_VALUES\_UPDATE /... | | `export-document-as-pdf` | Tool to export a Google Docs file as PDF using the Google Drive API. | | `export-google-workspace-file` | Exports a Google Workspace document to the requested MIME type and returns exported file content. | | `fetch-emails` | Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. | | `fetch-message-by-message-id` | 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` | Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. | | `find-event` | Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. | | `find-file` | The comprehensive Google Drive search tool that handles all file and folder discovery needs. | | `find-folder` | Finds one page of Google Drive folders by name and optional parent. | | `find-free-slots` | Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. | | `find-replace` | Tool to find and replace text in a Google Spreadsheet. Use when you need to fix formula errors, update values, or perform bulk text replacements across cells. | | `find-worksheet-by-title` | DEPRECATED: Use GetSpreadsheetInfo instead. Finds a worksheet by its exact, case-sensitive title within a Google Spreadsheet; returns a boolean... | | `format-cell` | Applies text and background cell formatting to a specified range in a Google Sheets worksheet. | | `forward-message` | Forward an existing Gmail message to specified recipients, preserving original body and attachments. | | `free-busy-query` | DEPRECATED: Use GOOGLECALENDAR\_FIND\_FREE\_SLOTS instead (though this tool provides wider secondary/shared calendar coverage). | | `generate-ids` | Generates a set of file IDs which can be provided in create or copy requests. | | `geocode-address` | DEPRECATED: Legacy API to convert street addresses into geographic coordinates (latitude and longitude). | | `geocode-address-with-query` | Tool to map addresses to geographic coordinates with query parameter. | | `geocode-destinations` | Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations... | | `geocode-location` | Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. | | `geocode-place` | Tool to perform geocode lookup using a place identifier to retrieve address and coordinates. | | `geocoding-api` | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. | | `geolocate` | Tool to determine location based on cell towers and WiFi access points. | | `get2d-tile` | Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. | | `get3d-tiles-root` | Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. | | `get-about` | Tool to retrieve information about the user, the user's Drive, and system capabilities. | | `get-account` | Tool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100). | | `get-album` | Returns the album based on the specified albumId. | | `get-app` | Tool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app. | | `get-attachment` | Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. | | `get-attribution-settings` | Tool to retrieve attribution configuration for a Google Analytics property. | | `get-audience` | Tool to retrieve a single Audience configuration from a Google Analytics property. | | `get-audience-export` | Tool to get configuration metadata about a specific audience export. | | `get-audience-list` | Tool to get configuration metadata about a specific audience list. | | `get-auto-forwarding` | Tool to get the auto-forwarding setting for the specified account. | | `get-batch-values` | DEPRECATED: Use GOOGLESHEETS\_BATCH\_GET instead. Tool to return one or more ranges of values from a spreadsheet. | | `get-calendar` | Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access. | | `get-calendar-profile` | DEPRECATED: Use CalendarListGet instead. Tool to retrieve the authenticated user's primary calendar profile. | | `get-campaign-by-id` | GetCampaignById Tool returns details of a campaign in Google Ads. | | `get-campaign-by-name` | Queries Google Ads via SQL to retrieve a campaign by its exact name. | | `get-change` | Tool to get a specific change by ID from Google Drive v2 API. | | `get-changes-start-page-token` | Tool to get the starting pageToken for listing future changes in Google Drive. | | `get-child` | Tool to get a specific child reference for a folder using Drive API v2. | | `get-comment` | Tool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID. | | `get-conditional-format-rules` | List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form. | | `get-conference-record-by-name` | Tool to get a specific conference record by its resource name. | | `get-contacts` | Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. | | `get-current-date-time` | Gets the current date and time, allowing for a specific timezone offset. | | `get-custom-dimension` | Tool to retrieve a single CustomDimension by its resource name. | | `get-customer-lists` | GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads. | | `get-data-retention-settings` | Tool to retrieve data retention configuration for a Google Analytics property. | | `get-data-sharing-settings` | Tool to retrieve data sharing configuration for a Google Analytics account. | | `get-data-validation-rules` | Tool to extract data validation rules from a Google Sheets spreadsheet. | | `get-direction` | Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes. | | `get-document-by-id` | Retrieves an existing Google Document by its ID; will error if the document is not found. | | `get-document-end-index` | Retrieves the end index and paragraph structure of a Google Document or specific segment. | | `get-document-plaintext` | Retrieve a Google Doc by ID and return a best-effort plain-text rendering. | | `get-draft` | Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL\_SEND\_DRAFT. | | `get-drive` | Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. | | `get-file-metadata` | Tool to get a file's metadata by ID. Use to verify `mimeType`, `parents`, and `trashed` status before destructive operations (delete/move/export), or... | | `get-file-property` | Tool to get a property by its key using Google Drive API v2. | | `get-file-v2` | DEPRECATED: Use GetFileMetadata instead. Tool to get a file's metadata or content by ID from Google Drive API v2. | | `get-filter` | Tool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter. | | `get-google-signals-settings` | Tool to retrieve Google Signals configuration settings for a GA4 property. | | `get-key-event` | Tool to retrieve a Key Event. Use after confirming the key event resource name. | | `get-label` | Gets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color. | | `get-language-settings` | Tool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or... | | `get-media-item-download` | Downloads a media item from Google Photos and returns it as a file. | | `get-meet` | Retrieve details of a Google Meet space using its unique identifier. | | `get-metadata` | Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. | | `get-page-thumbnail2` | Tool to generate a thumbnail of the latest version of a specified page. | | `get-parent` | Tool to get a specific parent reference for a file using Drive API v2. | | `get-participant-session` | Retrieves detailed information about a specific participant session from a Google Meet conference record. | | `get-people` | Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields`... | | `get-permission` | Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. | | `get-permission-id-for-email` | Tool to get the permission ID for an email address using the Drive API v2. | | `get-place-details` | Retrieves comprehensive details for a place using its resource name (places/\{place\_id} format). | | `get-profile` | Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual... | | `get-property` | Tool to retrieve a single GA4 Property by its resource name. | | `get-property-quotas-snapshot` | Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property. | | `get-recordings-by-conference-record-id` | Retrieves recordings from Google Meet for a given conference record ID. | | `get-recurring-audience-list` | Tool to get configuration metadata about a specific recurring audience list. | | `get-reply` | Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply. | | `get-report-task` | Tool to get report metadata about a specific report task. Use after creating a report task to check its processing state or inspect its report definition. | | `get-revision` | Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. | | `get-route` | Calculates one or more routes between two specified locations. | | `get-sheet-names` | Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations. | | `get-spreadsheet-by-data-filter` | Returns the spreadsheet at the given ID, filtered by the specified data filters. | | `get-spreadsheet-info` | Retrieves metadata for a Google Spreadsheet using its ID. By default, returns essential information (ID, title, sheet properties) to avoid payload size issues. | | `get-table-schema` | DEPRECATED: Use GOOGLESHEETS\_GET\_SHEET\_NAMES and GOOGLESHEETS\_GET\_SPREADSHEET\_INFO for sheet structure metadata, and GOOGLESHEETS\_VALUES\_GET for direct range inspection. | | `get-task` | Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. | | `get-task-list` | Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user. | | `get-team-drive` | Tool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead. | | `get-time-zone` | Retrieves time zone information for a specific geographic location and timestamp. | | `get-transcript` | Retrieves a specific transcript by its resource name. Returns transcript details including state (STARTED, ENDED, FILE\_GENERATED), start/end times... | | `get-transcript-entry` | Fetches a single transcript entry by resource name for targeted inspection or incremental processing. | | `get-transcripts-by-conference-record-id` | Retrieves all transcripts for a specific Google Meet conference using its conference\_record\_id. | | `get-vacation-settings` | Tool to retrieve vacation responder settings for a Gmail user. | | `google-drive-delete-folder-or-file-action` | Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. | | `hide-drive` | Tool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user's main Google Drive interface without deleting it. | | `import-message` | Tool to import a message into the user's mailbox with standard email delivery scanning and classification. | | `insert-child` | Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder. | | `insert-dimension` | Tool to insert new rows or columns into a sheet at a specified location. | | `insert-image-in-table-cell` | Inserts an image from a given URI into a specific table cell in a Google Document. | | `insert-inline-image` | Tool to insert an image from a given URI at a specified location in a Google Document as an inline image. | | `insert-message` | Tool to insert a message into the user's mailbox similar to IMAP APPEND. | | `insert-page-break` | Tool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section. | | `insert-table-action` | Tool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document... | | `insert-table-column` | Tool to insert a new column into a table in a Google Document. | | `insert-table-row` | Inserts a new row into a table in a Google Document at a specified location. | | `insert-task` | 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`... | | `insert-text-action` | Tool to insert a string of text at a specified location within a Google Document. | | `insert-text-in-table-cell` | Inserts text into a specific cell of a table in a Google Document by row and column position. | | `list-accessible-customers` | List Google Ads customer resource names directly accessible to the authenticated user. | | `list-access-proposals` | Tool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. | | `list-accounts` | DEPRECATED: Use ListAccountsV1Beta instead. Tool to list all Accounts accessible by the caller. | | `list-account-summaries` | Tool to retrieve summaries of all Google Analytics accounts accessible by the caller. | | `list-accounts-v1-beta` | Tool to list all Google Analytics accounts accessible by the caller using v1beta API. | | `list-adsense-links` | Tool to list all AdSenseLinks on a property. Use when you need to fetch all AdSense links for a given Google Analytics property. | | `list-albums` | Lists all albums shown to a user in the Albums tab of Google Photos. | | `list-all-tasks` | Tool to list all tasks across all of the user's task lists with optional filters. | | `list-approvals` | Tool to list approvals on a file for workflow-based access control. | | `list-audience-exports` | Tool to list all audience exports for a property. Use when you need to find and reuse existing audience exports rather than creating new ones. | | `list-audience-lists` | Tool to list all audience lists for a specified property to help find and reuse existing lists. | | `list-audiences` | Tool to list Audiences on a property. Use when you need to retrieve audience configurations for a Google Analytics property. | | `list-bigquery-links` | Tool to list BigQuery Links on a property. Use when you need to retrieve BigQuery link resources associated with a Google Analytics property. | | `list-buildings` | Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. | | `list-calculated-metrics` | List Calculated Metrics | | `list-calendar-resources` | Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. | | `list-calendars` | Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering. | | `list-changes` | Tool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer... | | `list-channel-groups` | Tool to list ChannelGroups on a property. Use when you need to retrieve channel groups that categorize traffic sources in Analytics reports. | | `list-charts` | Lists all charts in a Google Sheets spreadsheet across all sheets, returning chart\_id, sheet metadata, chart type, title, and position. | | `list-children-v2` | Tool to list a folder's children using Google Drive API v2. Use when you need to retrieve all files and folders within a specific folder. | | `list-comments` | Tool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. | | `list-conference-records` | Tool to list conference records. Use when you need to retrieve a list of past conferences, optionally filtering them by criteria like meeting code... | | `list-conversion-events` | Tool to list conversion events on a property. Use when you need to retrieve conversion events configured for a given property. | | `list-cse-identities` | Tool to list client-side encrypted identities for an authenticated user. | | `list-cse-keypairs` | Tool to list client-side encryption key pairs for an authenticated user. | | `list-custom-dimensions` | List Custom Dimensions | | `list-custom-metrics` | Tool to list CustomMetrics on a property. Use when you need to retrieve all custom metrics configured for a given property. | | `list-data-streams` | Tool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property. | | `list-drafts` | Retrieves a paginated list of email drafts from a user's Gmail account. | | `list-dv360-ad-links` | Tool to list Display & Video 360 advertiser links on a property. | | `list-dv360-link-proposals` | Tool to list DisplayVideo360AdvertiserLinkProposals on a property. | | `list-event-create-rules` | Tool to list EventCreateRules configured on a web data stream. | | `list-expanded-data-sets` | Tool to list ExpandedDataSets on a property. Use when you need to retrieve expanded data set configurations for a Google Analytics 360 property. | | `list-file-labels` | Tool to list the labels already applied to a file in Google Drive. | | `list-file-properties` | Tool to list a file's properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file. | | `list-files` | DEPRECATED: Use GOOGLEDRIVE\_FIND\_FILE instead. Tool to list a user's files and folders in Google Drive. | | `list-filters` | Tool to list all Gmail filters (rules) in the mailbox. Use for security audits to detect malicious filter rules or before creating new filters to avoid duplicates. | | `list-firebase-links` | Tool to list FirebaseLinks on a property. Use when you need to retrieve Firebase connections associated with a Google Analytics property. | | `list-forwarding-addresses` | Tool to list all forwarding addresses for the specified Gmail account. | | `list-google-ads-links` | Tool to list GoogleAdsLinks on a property. Use when you need to retrieve Google Ads account links configured for a Google Analytics property. | | `list-history` | Tool to list Gmail mailbox change history since a known startHistoryId. | | `list-key-events` | Tool to list Key Events. Use when you need to retrieve all key event definitions for a given property. | | `list-labels` | Retrieves all system and user-created labels for a Gmail account in a single unpaginated response. | | `list-measurement-protocol-secrets` | Tool to list MeasurementProtocolSecrets under a data stream. | | `list-media-items` | Lists media items created by this application from Google Photos. | | `list-messages` | DEPRECATED: Use GMAIL\_FETCH\_EMAILS instead. Lists the messages in the user's mailbox. | | `list-participants` | Lists the participants in a conference record. By default, ordered by join time descending. | | `list-participant-sessions` | Lists all participant sessions for a specific participant in a Google Meet conference. | | `list-permissions` | Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive. | | `list-properties` | DEPRECATED: Use ListPropertiesV1Beta instead. Tool to list GA4 properties under a specific account. | | `list-properties-filtered` | Tool to list GA4 properties based on filter criteria. Use when you need to find properties under a specific parent account or with specific firebase projects. | | `list-recordings` | Tool to list recording resources from a conference record. Use when you need to retrieve recordings from a specific Google Meet conference. | | `list-recurring-audience-lists` | Tool to list all recurring audience lists for a GA4 property. | | `list-replies` | Tool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file. | | `list-reporting-data-annotations` | Tool to list all Reporting Data Annotations for a specific property. | | `list-report-tasks` | Tool to list all report tasks for a Google Analytics property. | | `list-revisions` | Tool to list a file's revision metadata (not content) in Google Drive. | | `list-search-ads360-links` | Tool to list all SearchAds360Links on a property. Use when you need to retrieve all Search Ads 360 links for a given Google Analytics property. | | `list-send-as` | Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases. | | `list-settings` | DEPRECATED: Use GOOGLECALENDAR\_SETTINGS\_LIST instead. Tool to return all user settings for the authenticated user. | | `list-shared-albums` | \[DEPRECATED - sunset March 31, 2025] Lists all shared albums available in the Sharing tab of the user's Google Photos app. | | `list-shared-drives` | Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. | | `list-sk-ad-network-conversion-value-schemas` | Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream. | | `list-smime-info` | Lists S/MIME configs for the specified send-as alias. Use when you need to retrieve all S/MIME certificate configurations associated with a specific... | | `list-spreadsheet-charts` | Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet. | | `list-sub-accounts` | List direct child/sub-accounts under a Google Ads manager (MCC) account. | | `list-subproperty-event-filters` | Tool to list all subproperty event filters on a property. Use when you need to retrieve event filters that route events to subproperties. | | `list-subproperty-sync-configs` | Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. | | `list-tables` | DEPRECATED: Use GOOGLESHEETS\_GET\_SHEET\_NAMES for tab discovery and GOOGLESHEETS\_GET\_SPREADSHEET\_INFO for full sheet metadata. | | `list-task-lists` | Fetches the authenticated user's task lists from Google Tasks; results may be paginated. | | `list-tasks` | 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` | Tool to list Team Drives (deprecated, use List Shared Drives instead). | | `list-threads` | 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` | Tool to list structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript. | | `lookup-aerial-video` | Tool to look up an aerial view video by address or video ID. | | `lookup-spreadsheet-row` | 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... | | `maps-embed-api` | Tool to generate an embeddable Google Map URL and HTML iframe code. | | `modify-file-labels` | Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. | | `modify-thread-labels` | Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. | | `move-chart` | Move or resize an existing chart on a Google Sheets spreadsheet. | | `move-file` | Tool to move a file from one folder to another in Google Drive. | | `move-task` | Moves the specified task to another position in the task list or to a different task list. | | `move-thread-to-trash` | Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash. | | `move-to-trash` | Moves an existing, non-deleted email message to the trash for the specified user. | | `mutate-ad-group-ads` | Create, update, or remove ads in Google Ads ad groups, including responsive search ads. | | `mutate-ad-group-assets` | Create, update, or remove links between assets and ad groups. | | `mutate-ad-group-bid-modifiers` | Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria. | | `mutate-ad-group-criteria` | Create, update, or remove criteria attached to a Google Ads ad group in a single batch request. | | `mutate-ad-groups` | Create, update, or remove ad groups within Google Ads campaigns. | | `mutate-assets` | 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` | Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion... | | `mutate-campaign-assets` | Create, update, or remove links between assets and campaigns. | | `mutate-campaign-budgets` | Create, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign\_budget resource name. | | `mutate-campaign-criteria` | Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules... | | `mutate-campaign-labels` | Create or remove relationships between campaigns and labels. | | `mutate-campaigns` | Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request. | | `mutate-conditional-format-rules` | Add, update, delete, or reorder conditional format rules on a Google Sheet. | | `mutate-conversion-actions` | Create, update, or remove Google Ads conversion actions for conversion tracking configuration. | | `mutate-labels` | Create, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering. | | `nearby-search` | Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned... | | `parse-file` | DEPRECATED: 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` | Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. | | `patch-event` | Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if... | | `patch-label` | Patches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected. | | `patch-permission` | Tool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other... | | `patch-property` | Tool to update a property on a file using PATCH semantics (v2 API). | | `patch-send-as` | Tool to patch the specified send-as alias for a Gmail user. Use when you need to update properties of an existing send-as email address such as... | | `patch-task` | Partially updates an existing task (identified by `task_id`) within a specific Google Task list (identified by `tasklist_id`), modifying only the... | | `patch-task-list` | Updates the title of an existing Google Tasks task list. | | `place-photo` | Retrieves high quality photographic content from the Google Maps Places database. | | `presentations-batch-update` | Update Google Slides presentations using markdown content or raw API text. | | `presentations-copy-from-template` | Tool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy. | | `presentations-get` | Tool to retrieve the latest version of a presentation. Use after obtaining the presentation ID. | | `presentations-pages-get` | Tool to get the latest version of a specific page in a presentation. | | `presentations-pages-get-thumbnail` | DEPRECATED: Use GOOGLESLIDES\_GET\_PAGE\_THUMBNAIL2 instead. Tool to generate and return a thumbnail image URL for a specific page. | | `provision-account-ticket` | Tool to request a ticket for creating a Google Analytics account. | | `query-audience-export` | Tool to query a completed audience export. Use when you need to fetch user rows with pagination. | | `query-audience-list` | Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination. | | `query-report-task` | Tool to retrieve a report task's content. Use this after creating a report task with CreateReportTask and confirming it is in ACTIVE state. | | `query-table` | DEPRECATED: Use GOOGLESHEETS\_VALUES\_GET / GOOGLESHEETS\_BATCH\_GET for table reads and GOOGLESHEETS\_LOOKUP\_SPREADSHEET\_ROW for row lookup/filter workflows. | | `quick-add` | Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not... | | `remove-attendee` | Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. | | `remove-label` | DEPRECATED: Use GMAIL\_DELETE\_LABEL instead. Permanently deletes a specific, existing user-created Gmail label by its ID for a user; cannot delete system labels. | | `render-aerial-video` | Starts rendering an aerial view video for a US postal address. | | `replace-all-text` | Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. | | `replace-image` | Tool to replace a specific image in a document with a new image from a URI. | | `reply-to-thread` | 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... | | `resumable-upload` | Tool to start and complete a Google Drive resumable upload session. | | `run-funnel-report` | Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property. | | `run-pivot-report` | Tool to run a customized pivot report of Google Analytics event data. | | `run-realtime-report` | Tool to run a customized realtime report of Google Analytics event data. | | `run-report` | Tool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges. | | `search-developer-metadata` | Tool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters. | | `search-documents` | Search for Google Documents using various filters including name, content, date ranges, and more. | | `search-media-items` | Searches for media items in a user's Google Photos library. | | `search-people` | Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'. | | `search-spreadsheets` | Search for Google Spreadsheets using various filters including name, content, date ranges, and more. | | `search-stream-gaql` | Execute a Google Ads Query Language (GAQL) query and stream all results in a single response. | | `send-draft` | Sends an existing draft email AS-IS to recipients already defined within the draft. | | `send-email` | Sends an email via Gmail API using the authenticated user's Google profile display name. | | `send-events` | Tool to send event data to Google Analytics 4 using the Measurement Protocol. | | `set-basic-filter` | Tool to set a basic filter on a sheet in a Google Spreadsheet. | | `set-data-validation-rule` | Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets. | | `settings-get` | Tool to return a single user setting for the authenticated user. | | `settings-get-imap` | 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` | Tool to retrieve POP settings for a Gmail account. Use when you need to check the current POP configuration including access window and message disposition. | | `settings-list` | Returns all user settings for the authenticated user. Results include multiple settings keyed by id (e.g., `timeZone`); locate a specific setting by its `id` field. | | `settings-send-as-get` | Tool to retrieve a specific send-as alias configuration for a Gmail user. | | `settings-watch` | Watch for changes to Settings resources. | | `sheet-from-json` | DEPRECATED: Use GOOGLESHEETS\_CREATE\_GOOGLE\_SHEET1 + GOOGLESHEETS\_UPDATE\_VALUES\_BATCH (or GOOGLESHEETS\_VALUES\_UPDATE / GOOGLESHEETS\_SPREADSHEETS\_VALUES\_APPEND) instead. | | `sort-range` | Sorts data within a specified range in a Google Sheet based on one or more sort criteria. | | `spreadsheets-sheets-copy-to` | Tool to copy a single sheet from a spreadsheet to another spreadsheet. | | `spreadsheets-values-append` | Tool to append values to a spreadsheet. Use when you need to add new data to the end of an existing table in a Google Sheet. | | `spreadsheets-values-batch-clear` | Tool to clear one or more ranges of values from a spreadsheet. | | `spreadsheets-values-batch-get-by-data-filter` | Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. | | `stop-watch` | Tool to stop receiving push notifications for a Gmail mailbox. | | `stop-watch-channel` | Tool to stop watching resources through a specified channel. | | `sync-events` | DEPRECATED: Use GOOGLECALENDAR\_EVENTS\_LIST instead. EventsList already handles syncToken with automatic param stripping. | | `text-search` | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower"). | | `tiles-create-session` | Tool to create a session token required for accessing 2D Tiles and Street View imagery. | | `trash-file` | Tool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH\_FILE. | | `unhide-drive` | Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view. | | `unmerge-table-cells` | Tool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states. | | `untrash-file` | Tool to restore a file from the trash. Use when you need to recover a deleted file. | | `untrash-message` | Tool to remove a message from trash in Gmail. Use when you need to restore a previously trashed email message. | | `untrash-thread` | Tool to remove a thread from trash in Gmail. Use when you need to restore a deleted thread and its messages. | | `update-album` | Updates an album's title or cover photo in Google Photos. | | `update-chart` | Update the specification of an existing chart in a Google Sheets spreadsheet. | | `update-comment` | Tool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. | | `update-dimension-properties` | Tool to hide/unhide rows or columns and set row heights or column widths. | | `update-document-batch` | DEPRECATED: Use UpdateExistingDocument instead. Tool to apply one or more updates to a Google Document. | | `update-document-markdown` | Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document. | | `update-document-section-markdown` | Tool to insert or replace a section of a Google Docs document with Markdown content. | | `update-document-style` | Tool to update the overall document style, such as page size, margins, and default text direction. | | `update-draft` | Updates (replaces) an existing Gmail draft's content in-place by draft ID. | | `update-drive` | Tool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive. | | `update-event` | Updates an existing event in Google Calendar. REQUIRES event\_id - you MUST first search for the event using GOOGLECALENDAR\_FIND\_EVENT or... | | `update-existing-document` | Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method. | | `update-file-metadata-patch` | Tool to update file metadata using the Drive API v2 PATCH method. | | `update-file-property` | Tool to update a property on a file using Google Drive API v2. | | `update-file-put` | Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 - only explicitly provided fields are updated, so omit fields... | | `update-file-revision-metadata` | Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). | | `update-imap-settings` | Tool to update IMAP settings for a Gmail account. Use when you need to modify IMAP configuration such as enabling/disabling IMAP, setting... | | `update-label` | Tool to update the properties of an existing Gmail label. Use when you need to modify label name, visibility settings, or color. | | `update-language-settings` | Tool to update the language settings for a Gmail user. Use when you need to change the display language preference for the authenticated user or a specific Gmail account. | | `update-media-item` | Updates a media item's description in Google Photos. | | `update-permission` | Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. | | `update-pop-settings` | Tool to update POP settings for a Gmail account. Use when you need to configure POP access window or message disposition behavior. | | `update-property` | Tool to update an existing GA4 Property. Use when you need to modify property settings such as display name, time zone, currency code, or industry category. | | `update-reply` | Tool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply. | | `update-send-as` | Tool to update a send-as alias for a Gmail user. Use when you need to modify display name, signature, reply-to address, or SMTP settings for a send-as email address. | | `update-sheet-properties` | Tool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties. | | `update-space` | Updates the settings of an existing Google Meet space. Requires organizer/host privileges and the meetings.space.created OAuth scope. | | `update-spreadsheet-properties` | Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings. | | `update-table-row-style` | Tool to update the style of a table row in a Google Document. | | `update-tab-properties` | Updates properties of a document tab such as title, parent tab, index, and icon emoji. | | `update-task` | DEPRECATED: Use GOOGLETASKS\_PATCH\_TASK instead. Full-update (PUT-style) operation that overwrites unspecified fields with empty/default values, which can cause data loss. | | `update-task-full` | Tool to fully replace an existing Google Task using PUT method. | | `update-task-list` | Updates the authenticated user's specified task list. | | `update-team-drive` | Tool to update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. | | `update-user-attributes-values` | Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. | | `update-vacation-settings` | Tool to update vacation responder settings for a Gmail user. | | `update-values-batch` | Tool to set values in one or more ranges of a spreadsheet. Use when you need to update multiple ranges in a single operation for better performance. | | `upload-file` | 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` | Tool to fetch a file from a provided URL server-side and upload it into Google Drive. | | `upload-media` | Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB). | | `upload-update-file` | Tool to update file content in Google Drive by uploading new binary content. | | `upsert-rows` | Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. | | `validate-events` | Tool to validate Measurement Protocol events before sending them to production. | | `values-get` | Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet. | | `values-update` | Tool to set values in a range of a Google Spreadsheet. Use when you need to update or overwrite existing cell values in a specific range. | | `watch-changes` | Tool to subscribe to changes for a user or shared drive in Google Drive. | | `watch-file` | Tool to subscribe to push notifications for changes to a specific file. | ## Triggers (48) Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument. | Trigger | Needs | What fires it | | ------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | | 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 | nothing | Polling trigger that fires when any attendee's RSVP changes to | | Cell Range Values Changed | `spreadsheet_id`, `range` | Triggers when values in a specified A1 range change in Google Sheets. | | Comment Added (Docs/Sheets/Slides) | nothing | Triggers when a new comment is added to Google Docs, Sheets, or Slides. | | Conditional Format Rule Changed | `spreadsheet_id` | Triggers when conditional formatting rules change in a Google Spreadsheet. | | Data Validation Rule Changed | `spreadsheet_id` | Triggers when data validation rules change (added/updated/removed) in a Google Spreadsheet. | | Developer Metadata Changed | `spreadsheet_id` | Triggers when developer metadata entries change (new/updated/removed) in a Google Spreadsheet. | | New Document Created | nothing | Triggers when a new Google Doc is created. | | Document Deleted | nothing | Triggers when an existing Google Doc is deleted (moved to trash). | | Document Placeholder Filled | `document_id`, `placeholder_pattern` | Triggers when a Google Doc's plain text changes such that a configured placeholder | | 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_id` | Triggers when a Google Doc's structure changes (headers/footers added/removed, tables/images count changes). | | Document Updated | nothing | Triggers when an existing Google Doc is updated or modified. | | Document Word Count Threshold | `document_id` | Triggers when a Google Doc's word/character count crosses a user-defined threshold. | | Email Sent | nothing | Triggers when a Gmail message is sent by the authenticated user. It polls the | | Event Canceled or Deleted | nothing | Triggers when a Google Calendar event is cancelled or deleted. | | Event Starting Soon | nothing | Triggers when a calendar event is within a configured number of minutes from starting. | | File Created | nothing | Triggers when a new file is created in Google Drive. | | File Deleted or Trashed | nothing | Triggers when a file is moved to trash or permanently deleted in Drive. | | File Shared (Permissions Added) | nothing | Triggers when new sharing permissions are granted to a file or folder. | | File Updated | nothing | Triggers when a file's metadata or content changes in Google Drive. | | Filtered Range Values Changed | `spreadsheet_id`, `data_filters` | Polling trigger that monitors Google Sheets filtered ranges for value changes. | | New Folder Created in Root | nothing | Triggers when a new folder is created in the root folder of Google Drive. | | Calendar Event Changes | nothing | **SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead. | | Event Created | nothing | Polling trigger that fires when a new calendar event is created. | | Calendar Event Sync | nothing | Polling trigger that returns full event data including details, attendees, and metadata. | | Event Updated | nothing | Triggers when an existing Google Calendar event is modified. Returns the event ID, | | Google Drive Changes | nothing | Triggers when changes are detected in a Google Drive. | | Keyword Detected in Document | `document_id`, `keyword` | Triggers when a specific keyword or phrase first appears in a Google Doc. | | New File Matching Query | nothing | Triggers when a new Google Drive file matches a provided query. | | New Gmail Message Received Trigger | nothing | Triggers when a new message is received in Gmail. | | New Rows in Google Sheet | `spreadsheet_id` | Simple polling trigger that monitors Google Sheets for new rows. | | 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 | nothing | Triggers when a new Google Spreadsheet is created. | | New Task Created | nothing | Triggers when a new task is created in a Google Tasks list. | | New Task List Created | nothing | Triggers when a new Google Tasks task list is created. | | New Document Added | nothing | Triggers when a new Google Doc is added/created. | | New Slide Added | `presentation_id` | Fires when a new slide is added to a Google Slides presentation. | | Spreadsheet Metadata Changed | `spreadsheet_id` | Polling trigger that detects when a Google Spreadsheet's metadata changes. | | Spreadsheet Properties Changed | `spreadsheet_id` | Polling trigger that detects when a Google Spreadsheet's top-level properties change. | | Spreadsheet Row Changed | `spreadsheet_id`, `query` | Triggers when a looked-up spreadsheet row changes. | | Spreadsheet Search Match | nothing | Triggers when a new spreadsheet appears that matches a saved search. | | Table Query Result Changed | `spreadsheet_id`, `sql` | Triggers when the result set of a saved table query changes in Google Sheets. | | Table Schema Changed | `spreadsheet_id`, `table_name` | Polling trigger that detects when a table's schema changes in Google Sheets. | | Task Details Changed | `tasklist_id`, `task_id` | Triggers when a specific task's details change. | | Task List Changed | `tasklist_id` | Triggers when a task list changes (title or content updates). | | Task Updated | nothing | Triggers when an existing task is updated in a Google Tasks list. | | Worksheet Names Changed | `spreadsheet_id` | Triggers when the set of worksheet/tab names changes in a Google Spreadsheet. | [Open Google Workspace in the console →](https://app.boxd.sh/integrations/detail/googlesuper)