# How to connect Google Super to Claude Cowork

```json
{
  "title": "How to connect Google Super to Claude Cowork",
  "toolkit": "Google Super",
  "toolkit_slug": "googlesuper",
  "framework": "Claude Cowork",
  "framework_slug": "claude-cowork",
  "url": "https://composio.dev/toolkits/googlesuper/framework/claude-cowork",
  "markdown_url": "https://composio.dev/toolkits/googlesuper/framework/claude-cowork.md",
  "updated_at": "2026-05-12T10:14:08.720Z"
}
```

## Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.
This guide walks you through the easiest and most secure way to connect your Google Super account to Cowork via Composio Connect, enabling it to share this Google Drive file with your team, summarize unread Gmail messages from today, add a new sheet to your budget spreadsheet, and more such actions on your behalf without compromising your account security.

## Also integrate Google Super with

- [ChatGPT](https://composio.dev/toolkits/googlesuper/framework/chatgpt)
- [Antigravity](https://composio.dev/toolkits/googlesuper/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/googlesuper/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/googlesuper/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/googlesuper/framework/claude-code)
- [Codex](https://composio.dev/toolkits/googlesuper/framework/codex)
- [Cursor](https://composio.dev/toolkits/googlesuper/framework/cursor)
- [VS Code](https://composio.dev/toolkits/googlesuper/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/googlesuper/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/googlesuper/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/googlesuper/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/googlesuper/framework/cli)
- [Google ADK](https://composio.dev/toolkits/googlesuper/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/googlesuper/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/googlesuper/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/googlesuper/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/googlesuper/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/googlesuper/framework/crew-ai)

## Connect Google Super to Claude Cowork

### Connecting Google Super to Claude Cowork
1. Open Customize
In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.
2. Add the Composio MCP server
Click Add custom connector and paste in the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

## What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.
With Composio Connect, Cowork can securely access apps like Google Super through MCP without you sharing account credentials directly with the agent.

## What is the Google Super MCP server, and what's possible with it?

The Google Super MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Super account. It provides structured and secure access to all your core Google services—Drive, Calendar, Gmail, Sheets, Analytics, Ads, Photos, and more—so your agent can perform actions like managing files, organizing emails, updating spreadsheets, and handling media on your behalf.
- Unified email and label management: Enable your agent to organize Gmail by adding or removing labels, and streamline inbox workflows for faster, smarter communication.
- Spreadsheet creation and data operations: Direct your agent to create new sheets, aggregate and analyze column data, or append rows and columns to Google Sheets for seamless data management.
- Collaborative file sharing and permissions: Have your agent update Google Drive file sharing settings, granting roles or access to users, groups, or domains effortlessly.
- Media upload and organization in Google Photos: Let your agent batch upload media files, add them to albums, or enrich your photo library by automating media management tasks.
- Customer and ads list management: Empower your agent to add or remove contacts from Google Ads customer lists, making marketing and outreach a breeze without manual effort.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `GOOGLESUPER_ACL_DELETE` | Delete ACL Rule | Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain. |
| `GOOGLESUPER_ACL_GET` | Get ACL Rule | Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain. |
| `GOOGLESUPER_ACL_INSERT` | Create ACL Rule | Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain. |
| `GOOGLESUPER_ACL_LIST` | List ACL Rules | Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules. |
| `GOOGLESUPER_ACL_PATCH` | Patch ACL Rule | Updates an existing access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. IMPORTANT: The ACL rule must already exist on the calendar. This action cannot create new rules. If you receive a 404 Not Found error, the rule does not exist - use ACL insert to create it first, or use ACL list to verify available rules. Each patch request consumes three quota units. For domain-type ACL rules, if PATCH fails with 500 error, this action will automatically fallback to UPDATE method. |
| `GOOGLESUPER_ACL_UPDATE` | Update ACL Rule | Updates an access control rule for the specified calendar. |
| `GOOGLESUPER_ACL_WATCH` | Watch ACL Changes | 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. |
| `GOOGLESUPER_ADD_ENRICHMENT` | Add Enrichment | Adds an enrichment at a specified position in a defined album. |
| `GOOGLESUPER_ADD_LABEL_TO_EMAIL` | Modify email labels | 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). |
| `GOOGLESUPER_ADD_OR_REMOVE_TO_CUSTOMER_LIST` | Add or remove to customer list | AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list. Email addresses must comply with Google Ads policies and applicable privacy/consent laws. |
| `GOOGLESUPER_ADD_PARENT` | Insert File Parent (v2) | Tool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder. |
| `GOOGLESUPER_ADD_PROPERTY` | Insert Property (v2 API) | Tool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file. |
| `GOOGLESUPER_ADD_SHEET` | Add Sheet to Existing Spreadsheet | Adds a new sheet to a spreadsheet. Supports three sheet types: GRID, OBJECT, and DATA_SOURCE. SHEET TYPES: - GRID (default): Standard spreadsheet with rows/columns. Use properties to set dimensions, tab color, etc. - OBJECT: Sheet containing a chart. Requires objectSheetConfig with chartSpec (basicChart or pieChart). - DATA_SOURCE: Sheet connected to BigQuery. Requires dataSourceConfig with bigQuery spec and bigquery.readonly OAuth scope. OTHER NOTES: - Sheet names must be unique; use forceUnique=true to auto-append suffix (_2, _3) if name exists - For tab colors, use EITHER rgbColor OR themeColor, not both - Avoid 'index' when creating sheets in parallel (causes errors) - OBJECT sheets are created via addChart with position.newSheet=true - DATA_SOURCE sheets require bigquery.readonly OAuth scope Use cases: Add standard grid sheet, create chart on dedicated sheet, connect to BigQuery data source. |
| `GOOGLESUPER_AGGREGATE_COLUMN_DATA` | Aggregate Column Data | Searches for rows where a specific column matches a value and performs mathematical operations on data from another column. |
| `GOOGLESUPER_APPEND_DIMENSION` | Append Dimension | Tool to append new rows or columns to a sheet, increasing its size. Use when you need to add empty rows or columns to an existing sheet. |
| `GOOGLESUPER_ARCHIVE_CUSTOM_DIMENSION` | 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. Archived dimensions cannot be used in new reports. |
| `GOOGLESUPER_AUTOCOMPLETE` | Autocomplete Place Predictions | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance. |
| `GOOGLESUPER_AUTO_RESIZE_DIMENSIONS` | Auto-Resize Rows or Columns | Auto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions. Use when you need to automatically adjust row heights or column widths to fit content after writing data. |
| `GOOGLESUPER_BATCH_ADD_MEDIA_ITEMS` | Batch Add Media Items | Adds one or more media items to an album in Google Photos. |
| `GOOGLESUPER_BATCH_CLEAR_VALUES_BY_DATA_FILTER` | Batch Clear Values By Data Filter | Clears one or more ranges of values from a spreadsheet using data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept. |
| `GOOGLESUPER_BATCH_CREATE_MEDIA_ITEMS` | 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 automatically) 2. 'media_files': List of objects with url/file, file_name, and description 3. 'files': List of FileUploadable objects for pre-uploaded files Media items can optionally be added to an album at a specific position. Maximum 50 items per request. |
| `GOOGLESUPER_BATCH_DELETE_MESSAGES` | Batch delete Gmail messages | Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed. Always obtain explicit user confirmation and verify a sample of message IDs before executing. High-volume calls may trigger 429 rateLimitExceeded or 403 userRateLimitExceeded errors; apply exponential backoff. |
| `GOOGLESUPER_BATCH_EVENTS` | Batch Events | Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates. |
| `GOOGLESUPER_BATCH_EXECUTE` | Batch Execute Google Tasks Operations | Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. Use this to reduce LLM tool invocations when performing bulk operations like updating many tasks, moving tasks, or deleting multiple items. Note: Each sub-request still counts toward API quota; batching primarily reduces HTTP overhead and tool call count. |
| `GOOGLESUPER_BATCH_GET` | Batch get spreadsheet | Retrieves data from specified cell ranges in a Google Spreadsheet. |
| `GOOGLESUPER_BATCH_GET_MEDIA_ITEMS` | Batch Get Media Items | Returns the list of media items for the specified media item identifiers. |
| `GOOGLESUPER_BATCH_MODIFY_MESSAGES` | Batch modify Gmail messages | Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; apply exponential backoff. |
| `GOOGLESUPER_BATCH_RUN_PIVOT_REPORTS` | Batch Run Pivot Reports | Tool to return multiple pivot reports in a batch for a GA4 property. Use when you need to fetch multiple pivot table reports with multi-dimensional analysis in a single request. |
| `GOOGLESUPER_BATCH_RUN_REPORTS` | 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. |
| `GOOGLESUPER_BATCH_UPDATE_VALUES_BY_DATA_FILTER` | 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. |
| `GOOGLESUPER_CALENDAR_LIST_DELETE` | Remove Calendar from List | 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. |
| `GOOGLESUPER_CALENDAR_LIST_GET` | Get Single Calendar by ID | Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user's calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead. |
| `GOOGLESUPER_CALENDAR_LIST_INSERT` | Insert Calendar into List | Inserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted. |
| `GOOGLESUPER_CALENDAR_LIST_PATCH` | Patch Calendar List Entry | Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields. |
| `GOOGLESUPER_CALENDAR_LIST_UPDATE` | Update Calendar List Entry | 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, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE. |
| `GOOGLESUPER_CALENDAR_LIST_WATCH` | Watch Calendar List | Watch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified. |
| `GOOGLESUPER_CALENDARS_DELETE` | Delete Calendar | Deletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions. |
| `GOOGLESUPER_CALENDARS_UPDATE` | Update Calendar | Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color. |
| `GOOGLESUPER_CHANNELS_STOP` | Stop Channel | Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription. |
| `GOOGLESUPER_CHECK_COMPATIBILITY` | Check Compatibility | Tool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report. |
| `GOOGLESUPER_CLEAR_BASIC_FILTER` | 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. |
| `GOOGLESUPER_CLEAR_CALENDAR` | Clear Calendar | Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely. |
| `GOOGLESUPER_CLEAR_TASKS` | Clear tasks | Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking. |
| `GOOGLESUPER_CLEAR_VALUES` | Clear spreadsheet values | 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. |
| `GOOGLESUPER_COLORS_GET` | Get Color Definitions | Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events. |
| `GOOGLESUPER_COMPUTE_ROUTE_MATRIX` | Compute Route Matrix | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes. Matrix is capped at 625 elements (e.g., 25×25); chunk larger sets to avoid RESOURCE_EXHAUSTED errors. Response elements may be returned out of input order — always use originIndex and destinationIndex to map results. Only use elements where condition='ROUTE_EXISTS'; the matrix may be incomplete. |
| `GOOGLESUPER_COPY_DOCUMENT` | Copy Google 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. The copied document will have a default title (e.g., 'Copy of [original title]') if no new title is provided, and will be placed in the user's root Google Drive folder. |
| `GOOGLESUPER_COPY_FILE_ADVANCED` | Copy file with advanced options | Creates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata. |
| `GOOGLESUPER_CREATE_ALBUM` | Create Album | Creates a new album in Google Photos. |
| `GOOGLESUPER_CREATE_AUDIENCE_EXPORT` | 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. This initiates a long-running asynchronous request that returns an operation resource name immediately. The export begins in CREATING state with rowCount=0; the operation must complete before export data is accessible for querying. |
| `GOOGLESUPER_CREATE_AUDIENCE_LIST` | Create Audience List | Tool to create an audience list for later retrieval by initiating a long-running asynchronous request. Use when you need to create a snapshot of users currently in an audience. The method returns quickly with an Operation resource while processing occurs in the background. |
| `GOOGLESUPER_CREATE_CHART` | Create Chart in Google Sheets | Create a chart in a Google Sheets spreadsheet using the specified data range and chart type. Conditional requirements: - Provide either a simple chart via chart_type + data_range (basicChart), OR supply a full chart_spec supporting all chart types. Exactly one approach should be used. - When using chart_spec, set exactly one of the union fields (basicChart \| pieChart \| bubbleChart \| candlestickChart \| histogramChart \| waterfallChart \| treemapChart \| orgChart \| scorecardChart). |
| `GOOGLESUPER_CREATE_COMMENT` | 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. Omit `anchor` and `quoted_file_content_*` for general file-level comments. |
| `GOOGLESUPER_CREATE_CUSTOM_DIMENSION` | Create Custom Dimension | Tool to create a CustomDimension for a Google Analytics property. Use when you need to add a new custom dimension to track specific user properties, event parameters, or eCommerce item parameters. |
| `GOOGLESUPER_CREATE_CUSTOMER_LIST` | Create customer list | Creates a customer list in Google Ads. Note: Requires an authenticated Google Ads connection with customer_id configured. Email-based lists must comply with Google Ads policies and applicable privacy/consent laws. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation. |
| `GOOGLESUPER_CREATE_CUSTOM_METRIC` | 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. |
| `GOOGLESUPER_CREATE_DOCUMENT` | Create a 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 document's ID and metadata (excluding body content). |
| `GOOGLESUPER_CREATE_DOCUMENT_MARKDOWN` | Create Document Markdown | Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text. |
| `GOOGLESUPER_CREATE_DRIVE` | Create Shared Drive | Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage. |
| `GOOGLESUPER_CREATE_EMAIL_DRAFT` | 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 bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. Returns a draft_id that must be used as-is with GMAIL_SEND_DRAFT — synthetic or stale IDs will fail. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead. HTTP 429 may occur on rapid creation/send sequences; apply exponential backoff. |
| `GOOGLESUPER_CREATE_EVENT` | Create Event | Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. No conflict checking is performed; use GOOGLECALENDAR_FREE_BUSY_QUERY to detect overlaps before creating. Returns event id and htmlLink nested under data.response_data. Example: { "start_datetime": "2025-01-16T13:00:00", "timezone": "America/New_York", "event_duration_hour": 1, "event_duration_minutes": 30, "summary": "Client sync", "attendees": ["required@example.com", {"email": "optional@example.com", "optional": true}] } |
| `GOOGLESUPER_CREATE_EXPANDED_DATA_SET` | 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. |
| `GOOGLESUPER_CREATE_FILE` | Create File or Folder | Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER. |
| `GOOGLESUPER_CREATE_FILE_FROM_TEXT` | Create a 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. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases. |
| `GOOGLESUPER_CREATE_FILTER` | Create Gmail filter | Tool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a maximum of 1,000 filters per account. |
| `GOOGLESUPER_CREATE_FOLDER` | Create a folder | Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups. |
| `GOOGLESUPER_CREATE_FOOTER` | 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. |
| `GOOGLESUPER_CREATE_FOOTNOTE` | 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. |
| `GOOGLESUPER_CREATE_GOOGLE_SHEET1` | Create a Google Sheet | Creates a new Google Spreadsheet in Google Drive. If a title is provided, the spreadsheet will be created with that name. If no title is provided, Google will create a spreadsheet with a default name like 'Untitled spreadsheet'. Optionally create the spreadsheet in a specific folder by providing either: - folder_id: The Google Drive folder ID (preferred, unambiguous) - folder_name: The folder name (searches for exact match; if multiple folders match, returns choices) If neither folder_id nor folder_name is provided, the spreadsheet is created in the root Drive folder. |
| `GOOGLESUPER_CREATE_HEADER` | Create Header | Tool to create a new header in a Google Document, optionally with text content. Use this tool when you need to add a header to a document. You can provide: - document_id: The ID of the document (required) - type: The header type (DEFAULT is the standard header) - text: Optional text content to add to the header - section_break_location: Optional location for section-specific headers |
| `GOOGLESUPER_CREATE_LABEL` | Create label | Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names. |
| `GOOGLESUPER_CREATE_MEET` | Create Google Meet Space | Creates a new Google Meet space with optional configuration. Does not attach to any calendar event — calendar linking requires a separate Calendar tool call. Capture `meetingUri`, `meetingCode`, and `space.name` from the response immediately for downstream lookups. Requires `meetings.space.created` OAuth scope. Returns HTTP 429 under rapid calls; apply exponential backoff. Use when you need a meeting space with specific access controls, moderation, recording, or transcription settings. |
| `GOOGLESUPER_CREATE_NAMED_RANGE` | 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. |
| `GOOGLESUPER_CREATE_PARAGRAPH_BULLETS` | Create Paragraph Bullets | Tool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points. |
| `GOOGLESUPER_CREATE_PERMISSION` | 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 accessible. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied. |
| `GOOGLESUPER_CREATE_PRESENTATION` | Create Google Slides 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. |
| `GOOGLESUPER_CREATE_PROMPT_POST` | Create Prompt Post | Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context. |
| `GOOGLESUPER_CREATE_RECURRING_AUDIENCE_LIST` | Create Recurring Audience List | Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data. Use when you need to automate audience list creation and reduce quota token consumption. |
| `GOOGLESUPER_CREATE_REPLY` | 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. |
| `GOOGLESUPER_CREATE_REPORT_TASK` | Create Report Task | Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports. Use when you need to generate large or complex reports that process asynchronously. |
| `GOOGLESUPER_CREATE_ROLLUP_PROPERTY` | Create Rollup Property | Tool to create a roll-up property. Use when consolidating multiple GA4 properties into one aggregated view. |
| `GOOGLESUPER_CREATE_SHORTCUT_TO_FILE` | Create Shortcut to File/Folder | Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location. |
| `GOOGLESUPER_CREATE_SLIDES_MARKDOWN` | Create Slides from Markdown | Creates a new Google Slides presentation from Markdown text. Automatically splits content into slides using '---' separators and applies appropriate templates based on content structure. |
| `GOOGLESUPER_CREATE_SPREADSHEET_COLUMN` | Create spreadsheet column | Creates a new column in a Google Spreadsheet. Specify the target sheet using sheet_id (numeric) or sheet_name (text). If neither is provided, defaults to the first sheet (sheet_id=0). |
| `GOOGLESUPER_CREATE_SPREADSHEET_ROW` | 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. |
| `GOOGLESUPER_CREATE_TASK_LIST` | Create a task list | Creates a new task list with the specified title and returns a tasklist_id. Use the returned tasklist_id (not the title) when calling GOOGLETASKS_INSERT_TASK or other task operations. Duplicate titles are permitted by the API, so verify existing lists before creating to avoid unintended duplicates. |
| `GOOGLESUPER_DELETE_CHART` | Delete Chart from Google Sheets | 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. This action is irreversible — once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed. |
| `GOOGLESUPER_DELETE_CHILD` | Delete Child (v2) | Tool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder. |
| `GOOGLESUPER_DELETE_COMMENT` | Delete Comment | Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling. |
| `GOOGLESUPER_DELETE_CONTENT_RANGE` | Delete Content Range in Document | 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. Note: Every segment (body, header, footer, footnote) in Google Docs ends with a final newline character that cannot be deleted. Ensure the endIndex does not include this trailing newline. |
| `GOOGLESUPER_DELETE_DIMENSION` | Delete Dimension (Rows/Columns) | Tool to delete specified rows or columns from a sheet in a Google Spreadsheet. Use when you need to remove a range of rows or columns. |
| `GOOGLESUPER_DELETE_DRAFT` | 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. Ensure the draft exists and the user has necessary permissions for the given `user_id`. |
| `GOOGLESUPER_DELETE_DRIVE` | Delete Shared Drive | Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified). |
| `GOOGLESUPER_DELETE_EVENT` | 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. Bulk deletions may trigger `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5–10 requests and apply exponential backoff. |
| `GOOGLESUPER_DELETE_FILTER` | Delete Gmail filter | Tool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule. |
| `GOOGLESUPER_DELETE_FOOTER` | 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. |
| `GOOGLESUPER_DELETE_HEADER` | Delete Header | Deletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document. |
| `GOOGLESUPER_DELETE_LABEL` | Delete label from account (permanent) | Permanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages, use GMAIL_ADD_LABEL_TO_EMAIL action instead. |
| `GOOGLESUPER_DELETE_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 to which the authenticated user has delegated access. |
| `GOOGLESUPER_DELETE_NAMED_RANGE` | 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. |
| `GOOGLESUPER_DELETE_PARAGRAPH_BULLETS` | Delete Paragraph Bullets | Tool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document. |
| `GOOGLESUPER_DELETE_PARENT` | Delete Parent (v2) | Tool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder. |
| `GOOGLESUPER_DELETE_PERMISSION` | Delete Permission | Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file. |
| `GOOGLESUPER_DELETE_PROPERTY` | Delete Property (v2 API) | Tool to delete a property from a file using Google Drive API v2. Use when you need to remove custom key-value metadata from a file. |
| `GOOGLESUPER_DELETE_REPLY` | Delete Reply | Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread. |
| `GOOGLESUPER_DELETE_REVISION` | 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.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision. |
| `GOOGLESUPER_DELETE_SHEET` | 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. |
| `GOOGLESUPER_DELETE_TABLE_COLUMN` | 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. |
| `GOOGLESUPER_DELETE_TABLE_ROW` | 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. |
| `GOOGLESUPER_DELETE_TASK` | Delete task | Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible — confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. The Google Tasks API does not support deleting tasks by task_id alone — you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list. |
| `GOOGLESUPER_DELETE_TASK_LIST` | Delete task list | Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows. |
| `GOOGLESUPER_DELETE_THREAD` | Delete thread | Tool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion. |
| `GOOGLESUPER_DOWNLOAD_FILE` | Download a file from Google Drive | Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified `mime_type`. For other file types, downloads in their native format regardless of mime_type. Examples: Export a Google Doc to plain text: {"file_id": "1N2o5xQWmAbCdEfGhIJKlmnOPq", "mime_type": "text/plain"} Download a Google Sheet as CSV: {"file_id": "1ZyXwVuTsRqPoNmLkJiHgFeDcB", "mime_type": "text/csv"} |
| `GOOGLESUPER_DOWNLOAD_FILE_OPERATION` | Download file via operation | Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call. |
| `GOOGLESUPER_DUPLICATE_CALENDAR` | Create a calendar | Creates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed. |
| `GOOGLESUPER_EDIT_FILE` | Edit File | Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID). |
| `GOOGLESUPER_EMPTY_TRASH` | Empty Trash | Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash. |
| `GOOGLESUPER_END_ACTIVE_CONFERENCE` | End active conference | Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end. Immediately drops all active participants — obtain explicit user confirmation before calling. |
| `GOOGLESUPER_EVENTS_GET` | Get Event | 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. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead. |
| `GOOGLESUPER_EVENTS_IMPORT` | Import Event | 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. Only events with eventType='default' can be imported. |
| `GOOGLESUPER_EVENTS_INSTANCES` | Get Event 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. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying. |
| `GOOGLESUPER_EVENTS_LIST` | List Events | Returns events on the specified calendar. TIMEZONE WARNING: When using timeMin/timeMax with UTC timestamps (ending in 'Z'), the time window is interpreted in UTC regardless of the calendar's timezone. For example, querying '2026-01-19T00:00:00Z' to '2026-01-20T00:00:00Z' on a calendar in America/Los_Angeles (UTC-8) covers 2026-01-18 4pm to 2026-01-19 4pm local time, potentially missing events on the intended local date. To query for a specific local date, use timestamps with the appropriate timezone offset in timeMin/timeMax (e.g., '2026-01-19T00:00:00-08:00' for PST). |
| `GOOGLESUPER_EVENTS_LIST_ALL_CALENDARS` | List Events from All Calendars | Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items` list means no events matched the filters—adjust `time_min`, `time_max`, or `q` before concluding no events exist. |
| `GOOGLESUPER_EVENTS_MOVE` | Move Event | Moves an event to another calendar, i.e., changes an event's organizer. |
| `GOOGLESUPER_EVENTS_WATCH` | Watch Events | Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts. |
| `GOOGLESUPER_EXPORT_DOCUMENT_AS_PDF` | Export Google Doc as PDF | Tool to export a Google Docs file as PDF using the Google Drive API. Use when you need to generate a PDF version of a Google Docs document for download or distribution. Note: Google Drive enforces a 10MB limit on export content. |
| `GOOGLESUPER_EXPORT_GOOGLE_WORKSPACE_FILE` | Export Google Workspace file | Exports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API. |
| `GOOGLESUPER_FETCH_EMAILS` | Fetch emails | Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-check before accessing messageId or threadId. Null-check subject and header fields before string operations. For large result sets, prefer ids_only=true or metadata-only listing, then hydrate via GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID. |
| `GOOGLESUPER_FETCH_MESSAGE_BY_MESSAGE_ID` | 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`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather than header `Date` for recency checks. |
| `GOOGLESUPER_FETCH_MESSAGE_BY_THREAD_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`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Check `labelIds` per message to filter drafts. Concurrent bulk calls may trigger 403 `userRateLimitExceeded` or 429; cap concurrency ~10 and use exponential backoff. |
| `GOOGLESUPER_FIND_EVENT` | Find event | Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are provided. Results may span multiple pages; always follow `nextPageToken` until absent to avoid silently missing events. Validate the correct match from results by checking summary, start.dateTime, and organizer.email before using event_id for mutations. An empty `items` array means no events matched — widen filters rather than treating it as an error. |
| `GOOGLESUPER_FIND_FILE` | Find file | The comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q="mimeType = 'application/pdf'" - Find recent files: q="modifiedTime > '2024-01-01T00:00:00'" - Search by name: q="name contains 'report'" - Files in folder: folderId="abc123" or q="'FOLDER_ID' in parents" |
| `GOOGLESUPER_FIND_FOLDER` | Find folder | Tool to find a folder in Google Drive by its name and optionally a parent folder. Use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents. |
| `GOOGLESUPER_FIND_FREE_SLOTS` | Find free slots | Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods. Returned free slots are unfiltered by duration; callers must filter intervals to those fully containing the required meeting length. No event metadata (titles, descriptions, links) is returned; use GOOGLECALENDAR_EVENTS_LIST for event details. |
| `GOOGLESUPER_FIND_REPLACE` | Find and Replace in Spreadsheet | 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. Common use cases: - Fix #ERROR! cells by replacing with empty string or correct formula - Update old values with new ones across multiple cells - Fix formula references or patterns - Clean up data formatting issues |
| `GOOGLESUPER_FORMAT_CELL` | Format cell | Applies text and background cell formatting to a specified range in a Google Sheets worksheet. |
| `GOOGLESUPER_FORWARD_MESSAGE` | Forward email message | Forward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Messages near Gmail's size limits may fail; reconstruct a smaller draft if needed. |
| `GOOGLESUPER_GENERATE_IDS` | Generate File IDs | Generates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies. |
| `GOOGLESUPER_GEOCODE_ADDRESS_WITH_QUERY` | Geocode Address With Query | Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates. |
| `GOOGLESUPER_GEOCODE_DESTINATIONS` | Geocode Destinations | Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates. |
| `GOOGLESUPER_GEOCODE_LOCATION` | Reverse Geocode Location | Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result. |
| `GOOGLESUPER_GEOCODE_PLACE` | Geocode Place by ID | Tool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID. |
| `GOOGLESUPER_GEOCODING_API` | Geocoding API | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication. Exactly one of `address`, `latlng`, or `place_id` must be provided per request; omitting all three or mixing incompatible combinations yields no useful results. |
| `GOOGLESUPER_GEOLOCATE` | Geolocate Device | Tool to determine location based on cell towers and WiFi access points. Use when you need to find the geographic location of a device using network infrastructure data. |
| `GOOGLESUPER_GET2D_TILE` | Get 2D Map Tile | Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint. |
| `GOOGLESUPER_GET3D_TILES_ROOT` | Get 3D Tiles Root | Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls. |
| `GOOGLESUPER_GET_ABOUT` | Get about | Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately. |
| `GOOGLESUPER_GET_ACCOUNT` | 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). |
| `GOOGLESUPER_GET_ALBUM` | Get Album | Returns the album based on the specified albumId. |
| `GOOGLESUPER_GET_APP` | 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. |
| `GOOGLESUPER_GET_ATTACHMENT` | Get Gmail attachment | Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns base64url-encoded binary data (up to ~25 MB); the downloaded file location is at data.file.s3url (also exposes mimetype and name; no s3key). Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_FILE when a Drive file_id is present instead. |
| `GOOGLESUPER_GET_ATTRIBUTION_SETTINGS` | Get Attribution Settings | Tool to retrieve attribution configuration for a Google Analytics property. Use when you need to check attribution models, lookback windows, and conversion export settings. |
| `GOOGLESUPER_GET_AUDIENCE` | Get Audience | Tool to retrieve a single Audience configuration from a Google Analytics property. Use when you need detailed audience information including membership criteria and filter clauses. |
| `GOOGLESUPER_GET_AUDIENCE_EXPORT` | Get Audience Export | Tool to get configuration metadata about a specific audience export. Use when you need to understand an audience export after it has been created or check its status. |
| `GOOGLESUPER_GET_AUDIENCE_LIST` | Get Audience List | Tool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name. |
| `GOOGLESUPER_GET_AUTO_FORWARDING` | Get Auto-Forwarding Settings | Tool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition. |
| `GOOGLESUPER_GET_CALENDAR` | Get Google Calendar | Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access. Response includes `timeZone` (IANA format, e.g., 'America/Los_Angeles') — use it directly when constructing `timeMin`/`timeMax` in other tools to avoid DST errors. An empty `defaultReminders` list is valid (no defaults configured). Insufficient `accessRole` may omit fields like `defaultReminders` and `colorId`. |
| `GOOGLESUPER_GET_CAMPAIGN_BY_ID` | Get Campaign By Id | GetCampaignById Tool returns details of a campaign in Google Ads. Requires an active Google Ads OAuth connection with the correct customer_id configured; missing or mismatched customer_id will cause empty results. |
| `GOOGLESUPER_GET_CAMPAIGN_BY_NAME` | Get campaign by name | Queries Google Ads via SQL to retrieve a campaign by its exact name. Requires an active Google Ads connection with valid customer_id and appropriate OAuth scopes. |
| `GOOGLESUPER_GET_CHANGES_START_PAGE_TOKEN` | Get Changes Start Page Token | Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows. |
| `GOOGLESUPER_GET_CHILD` | Get Child Reference (v2) | Tool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder. |
| `GOOGLESUPER_GET_COMMENT` | 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. |
| `GOOGLESUPER_GET_CONDITIONAL_FORMAT_RULES` | Get conditional format rules | List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form. Use when you need to view, audit, or prepare to modify conditional format rules. |
| `GOOGLESUPER_GET_CONFERENCE_RECORD_BY_NAME` | Get conference record by name | Tool to get a specific conference record by its resource name. Use when you have the conference record ID and need to retrieve detailed information about a single meeting instance. |
| `GOOGLESUPER_GET_CONTACTS` | Get contacts | Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fields gracefully. People API shares a per-user QPS quota; HTTP 429 requires exponential backoff (1s, 2s, 4s). |
| `GOOGLESUPER_GET_CURRENT_DATE_TIME` | Get current date and time | Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones. |
| `GOOGLESUPER_GET_CUSTOM_DIMENSION` | Get Custom Dimension | Tool to retrieve a single CustomDimension by its resource name. Use when you need detailed information about a specific custom dimension including its display name, scope, and parameter name. |
| `GOOGLESUPER_GET_CUSTOMER_LISTS` | Get customer lists | GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads. These are user segments for targeting, not Google Ads accounts — list IDs are distinct from account IDs. When multiple lists share similar names, review all returned results before selecting one for downstream operations. |
| `GOOGLESUPER_GET_DATA_RETENTION_SETTINGS` | Get Data Retention Settings | Tool to retrieve data retention configuration for a Google Analytics property. Use when you need to check event-level and user-level data retention durations and reset settings. |
| `GOOGLESUPER_GET_DATA_SHARING_SETTINGS` | Get Data Sharing Settings | Tool to retrieve data sharing configuration for a Google Analytics account. Use when you need to check which data sharing settings are enabled for an account, including sharing with Google support, sales teams, products, and benchmarking. |
| `GOOGLESUPER_GET_DATA_VALIDATION_RULES` | Get Data Validation Rules | Tool to extract data validation rules from a Google Sheets spreadsheet. Use when you need to understand dropdown lists, allowed values, custom formulas, or other validation constraints for cells. |
| `GOOGLESUPER_GET_DOCUMENT_BY_ID` | Get document by id | Retrieves an existing Google Document by its ID; will error if the document is not found. |
| `GOOGLESUPER_GET_DOCUMENT_PLAINTEXT` | Get document plain text | Retrieve a Google Doc by ID and return a best-effort plain-text rendering. Converts document structure into plain text including paragraphs, lists, and tables without requiring clients to traverse complex Docs API JSON. |
| `GOOGLESUPER_GET_DRAFT` | Get Draft | Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned. |
| `GOOGLESUPER_GET_DRIVE` | Get Shared Drive | Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results. |
| `GOOGLESUPER_GET_FILE_METADATA` | 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 to confirm `mimeType='application/vnd.google-apps.document'` before calling GOOGLEDOCS_* tools (non-native files require GOOGLEDRIVE_DOWNLOAD_FILE). Only returns metadata visible to the connected account; public access requires GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE. High-frequency calls risk `403 rateLimitExceeded`; apply exponential backoff. |
| `GOOGLESUPER_GET_FILE_PROPERTY` | Get Property (v2) | Tool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file. |
| `GOOGLESUPER_GET_FILTER` | Get Gmail 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. |
| `GOOGLESUPER_GET_GOOGLE_SIGNALS_SETTINGS` | Get Google Signals Settings | Tool to retrieve Google Signals configuration settings for a GA4 property. Use when you need to check whether Google Signals is enabled and the consent status for a property. |
| `GOOGLESUPER_GET_KEY_EVENT` | Get Key Event | Tool to retrieve a Key Event. Use after confirming the key event resource name. Read-only; create, update, or delete operations require the Google Analytics UI. |
| `GOOGLESUPER_GET_LABEL` | Get label details | Gets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color. |
| `GOOGLESUPER_GET_LANGUAGE_SETTINGS` | 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 a specific Gmail account. |
| `GOOGLESUPER_GET_MEDIA_ITEM_DOWNLOAD` | Download Photos Media Item | Downloads a media item from Google Photos and returns it as a file. |
| `GOOGLESUPER_GET_MEET` | Get Meet details | Retrieve details of a Google Meet space using its unique identifier. Newly created spaces may return incomplete data; retry after 1–3 seconds if needed. |
| `GOOGLESUPER_GET_METADATA` | Get Metadata | Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use to discover available fields before building a report — always derive dimension/metric apiNames from this output rather than hardcoding from GA4 UI labels, which differ. Available fields vary per property; skip validation and downstream report tools like GOOGLE_ANALYTICS_RUN_REPORT return 400 INVALID_ARGUMENT on incompatible or invalid field combinations. Response can contain hundreds of fields; filter to relevant subset before passing to downstream logic. |
| `GOOGLESUPER_GET_PAGE_THUMBNAIL2` | Get Page Thumbnail v2 | Tool to generate a thumbnail of the latest version of a specified page. Use when you need a preview image URL for a slide page. This request counts as an expensive read request for quota purposes. |
| `GOOGLESUPER_GET_PARENT` | Get Parent Reference (v2) | Tool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file. |
| `GOOGLESUPER_GET_PARTICIPANT_SESSION` | Get Participant Details | Retrieves detailed information about a specific participant session from a Google Meet conference record. Returns session details including start time and end time for a single join/leave session. A participant session represents each unique join or leave session when a user joins a conference from a device. If a user joins multiple times from the same device, each join creates a new session. PREREQUISITE: You must first obtain the participant session resource name. Use LIST_PARTICIPANT_SESSIONS with a conference record ID and participant ID to get available sessions and their resource names. The 'name' parameter is REQUIRED and must be in the format: 'conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}' |
| `GOOGLESUPER_GET_PEOPLE` | Get People | 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. Scope is limited to the authenticated user's own contacts and 'Other Contacts' history only. |
| `GOOGLESUPER_GET_PERMISSION` | Get Permission | Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing. |
| `GOOGLESUPER_GET_PERMISSION_ID_FOR_EMAIL` | Get Permission ID for Email | Tool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID. |
| `GOOGLESUPER_GET_PLACE_DETAILS` | Get Place Details | Retrieves comprehensive details for a place using its resource name (places/{place_id} format). Use when you need detailed information about a specific place. |
| `GOOGLESUPER_GET_PROFILE` | Get Profile | Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label — use GMAIL_FETCH_EMAILS with label filters for label-specific counts. The returned historyId seeds incremental sync via GMAIL_LIST_HISTORY; if historyIdTooOld is returned, rescan with GMAIL_FETCH_EMAILS before resuming. Response may be wrapped under a top-level data field; unwrap before reading fields. A successful call confirms mailbox connectivity but not full mailbox access if granted scopes are narrow. Use the returned email address to dynamically identify the authenticated account rather than hard-coding it. |
| `GOOGLESUPER_GET_PROPERTY` | Get Property | Tool to retrieve a single GA4 Property by its resource name. Use when you need detailed property configuration including display name, time zone, currency, and other settings. |
| `GOOGLESUPER_GET_PROPERTY_QUOTAS_SNAPSHOT` | Get Property Quotas Snapshot | Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property. Use when you need to check current quota usage. Snapshot data can lag real consumption by several minutes; treat reported values as approximate and avoid scheduling high-volume jobs at full apparent capacity. |
| `GOOGLESUPER_GET_RECORDINGS_BY_CONFERENCE_RECORD_ID` | Get recordings by conference record ID | Retrieves recordings from Google Meet for a given conference record ID. Only returns recordings if recording was enabled and permitted by the organizer's domain policies; a valid conference_record_id does not guarantee recordings exist. After a meeting ends, recordings may take several minutes to process — an empty result may be temporary, not permanent. |
| `GOOGLESUPER_GET_RECURRING_AUDIENCE_LIST` | Get Recurring Audience List | Tool to get configuration metadata about a specific recurring audience list. Use when you need to understand a recurring audience list's state after it has been created or to get the resource name of the most recent audience list instance. |
| `GOOGLESUPER_GET_REPLY` | 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. |
| `GOOGLESUPER_GET_REPORT_TASK` | 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. |
| `GOOGLESUPER_GET_REVISION` | Get Revision | Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision. |
| `GOOGLESUPER_GET_ROUTE` | Get Route | Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response `duration` is a string with 's' suffix (e.g., `"4557s"`); parse before displaying. |
| `GOOGLESUPER_GET_SHEET_NAMES` | Get sheet names | Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations. |
| `GOOGLESUPER_GET_SPREADSHEET_BY_DATA_FILTER` | Get Spreadsheet by Data Filter | Returns the spreadsheet at the given ID, filtered by the specified data filters. Use this tool when you need to retrieve specific subsets of data from a Google Sheet based on criteria like A1 notation, developer metadata, or grid ranges. Important: This action is designed for filtered data retrieval. While it accepts empty filters and returns full metadata in that case, GOOGLESHEETS_GET_SPREADSHEET_INFO is the recommended action for unfiltered spreadsheet retrieval. |
| `GOOGLESUPER_GET_SPREADSHEET_INFO` | 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. Use the fields parameter for comprehensive metadata or specific fields. |
| `GOOGLESUPER_GET_TASK` | Get Task | Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task. Use this to refresh task details before display or edits rather than relying on potentially stale results from GOOGLETASKS_LIST_TASKS. |
| `GOOGLESUPER_GET_TASK_LIST` | Get task list | Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user. |
| `GOOGLESUPER_GET_TRANSCRIPT` | Get Transcript | Retrieves a specific transcript by its resource name. Returns transcript details including state (STARTED, ENDED, FILE_GENERATED), start/end times, and Google Docs destination. PREREQUISITE: Obtain the transcript resource name first by using GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID or construct it from known IDs. |
| `GOOGLESUPER_GET_TRANSCRIPT_ENTRY` | Get Transcript Entry | Fetches a single transcript entry by resource name for targeted inspection or incremental processing. Use when you have a specific transcript entry resource name and need to retrieve its details (text, speaker, timestamps, language). PREREQUISITE: Obtain the transcript entry resource name first by using LIST_TRANSCRIPT_ENTRIES or construct it from known IDs. The 'name' parameter is REQUIRED and must follow the format: 'conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}' |
| `GOOGLESUPER_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID` | Get transcripts by conference record ID | Retrieves all transcripts for a specific Google Meet conference using its conference_record_id. Transcripts require processing time after a meeting ends — empty results may be transient; retry after a delay before concluding no transcripts exist. Returns results only if transcription was enabled during the meeting and permitted by the organizer's domain policies; an empty list may also indicate transcription was never generated. |
| `GOOGLESUPER_GET_VACATION_SETTINGS` | Get Vacation Settings | Tool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content. |
| `GOOGLESUPER_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION` | Delete folder or file | 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. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders. |
| `GOOGLESUPER_HIDE_DRIVE` | Hide Shared 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. |
| `GOOGLESUPER_IMPORT_MESSAGE` | Import message | Tool to import a message into the user's mailbox with standard email delivery scanning and classification. Use when you need to add an existing email to a Gmail account without sending it through SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages. |
| `GOOGLESUPER_INSERT_CHILD` | Insert Child Into Folder (v2) | Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder. |
| `GOOGLESUPER_INSERT_DIMENSION` | Insert Dimension in Google Sheet | Tool to insert new rows or columns into a sheet at a specified location. Use when you need to add empty rows or columns within an existing Google Sheet. |
| `GOOGLESUPER_INSERT_INLINE_IMAGE` | Insert Inline Image | Tool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically. |
| `GOOGLESUPER_INSERT_MESSAGE` | Insert message into mailbox | Tool to insert a message into the user's mailbox similar to IMAP APPEND. Use when you need to add an email directly to a mailbox bypassing most scanning and classification. This does not send a message. |
| `GOOGLESUPER_INSERT_PAGE_BREAK` | 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. |
| `GOOGLESUPER_INSERT_TABLE_ACTION` | Insert Table in Google Doc | 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 body, header, or footer) in a document. |
| `GOOGLESUPER_INSERT_TABLE_COLUMN` | Insert Table Column | Tool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location. |
| `GOOGLESUPER_INSERT_TASK` | 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` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API. Not idempotent — repeated calls with identical parameters create duplicate tasks; track returned task IDs to avoid duplication. High-volume inserts may trigger 403 rateLimitExceeded or 429; apply exponential backoff. |
| `GOOGLESUPER_INSERT_TEXT_ACTION` | Insert Text into Document | Tool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document. IMPORTANT: Two ways to specify insertion location: 1. Use 'insertion_index' to insert at a specific position (index 1 is safe for document start) 2. Use 'append_to_end=true' to append text to the end of the document (recommended for appending) CRITICAL CONSTRAINT: When using insertion_index, the index MUST fall within the bounds of an EXISTING paragraph. You cannot insert text at arbitrary indices or at structural boundaries (e.g., table starts). The index must also be strictly less than the document's end index. To safely append text without index concerns, use append_to_end=true. |
| `GOOGLESUPER_LIST_ACCESSIBLE_CUSTOMERS` | List Accessible Customers | ListAccessibleCustomers retrieves all Google Ads customer accounts accessible to the authenticated user. Returns resource names of customers (e.g., customers/1234567890) that can be accessed with the current OAuth credentials. Use this action to discover which customer IDs are available before making other API calls. Use this action when you need to determine which customer accounts the authenticated user has access to, or when you want to populate a dropdown of available accounts for the user to select from. |
| `GOOGLESUPER_LIST_ACCESS_PROPOSALS` | List Access Proposals | Tool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 error. |
| `GOOGLESUPER_LIST_ACCOUNT_SUMMARIES` | List Account Summaries | Tool to retrieve summaries of all Google Analytics accounts accessible by the caller. Use when you need a high-level overview of accounts and their properties without fetching full account details. |
| `GOOGLESUPER_LIST_ACCOUNTS_V1_BETA` | List Accounts (v1beta) | Tool to list all Google Analytics accounts accessible by the caller using v1beta API. Use when you need to enumerate accounts. Note that these accounts might not have GA properties yet. Soft-deleted accounts are excluded by default. |
| `GOOGLESUPER_LIST_ADSENSE_LINKS` | 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. |
| `GOOGLESUPER_LIST_ALBUMS` | List Albums | Lists all albums shown to a user in the Albums tab of Google Photos. |
| `GOOGLESUPER_LIST_ALL_TASKS` | List All Tasks Across All Lists | Tool to list all tasks across all of the user's task lists with optional filters. Use when the agent needs to see all tasks without knowing which list to query first. Each returned task is annotated with its tasklist_id and tasklist_title for context. |
| `GOOGLESUPER_LIST_APPROVALS` | List Approvals | Tool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive. |
| `GOOGLESUPER_LIST_AUDIENCE_EXPORTS` | 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. |
| `GOOGLESUPER_LIST_AUDIENCE_LISTS` | List Audience Lists | Tool to list all audience lists for a specified property to help find and reuse existing lists. Use when you need to retrieve a property's configured audience lists after confirming the property ID. |
| `GOOGLESUPER_LIST_AUDIENCES` | List Audiences | Tool to list Audiences on a property. Use when you need to retrieve audience configurations for a Google Analytics property. Audiences created before 2020 may not be supported. |
| `GOOGLESUPER_LIST_BIGQUERY_LINKS` | 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. Results support pagination for large datasets. |
| `GOOGLESUPER_LIST_BUILDINGS` | List Buildings | Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical building locations configured in Google Workspace Calendar resources. This is useful for workspace administrators managing conference room and resource scheduling across multiple office buildings. Requires Google Workspace administrator privileges with Directory API access. |
| `GOOGLESUPER_LIST_CALCULATED_METRICS` | List Calculated Metrics | List Calculated Metrics |
| `GOOGLESUPER_LIST_CALENDAR_RESOURCES` | List Calendar Resources | Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains. |
| `GOOGLESUPER_LIST_CALENDARS` | List Google Calendars | Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering. Loop through all pages using nextPageToken until absent to avoid missing calendars. Use the primary flag and accessRole field from the response to identify calendars — display names are not valid calendar_id values. Read access (listing) does not imply write OAuth scopes. |
| `GOOGLESUPER_LIST_CHANGES` | 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 GOOGLEDRIVE_FIND_FILE instead). Tracks modifications such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: ```json { "pageToken": "22633", "pageSize": 100, "includeRemoved": true } ``` Returns changes with timestamps, file IDs, and modification details. Paginate by following `nextPageToken` until it is absent — stopping early will silently omit changes. Save `newStartPageToken` to monitor future changes efficiently. |
| `GOOGLESUPER_LIST_CHANNEL_GROUPS` | 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. |
| `GOOGLESUPER_LIST_CHILDREN_V2` | List Folder 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. |
| `GOOGLESUPER_LIST_COMMENTS` | 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. Filtering by author, content, or other criteria must be done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them. |
| `GOOGLESUPER_LIST_CONFERENCE_RECORDS` | 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, space name, or time range. |
| `GOOGLESUPER_LIST_CONVERSION_EVENTS` | List Conversion Events | Tool to list conversion events on a property. Use when you need to retrieve conversion events configured for a given property. |
| `GOOGLESUPER_LIST_CSE_IDENTITIES` | List CSE identities | Tool to list client-side encrypted identities for an authenticated user. Use when you need to retrieve CSE identity configurations including key pair associations. |
| `GOOGLESUPER_LIST_CSE_KEYPAIRS` | List CSE key pairs | Tool to list client-side encryption key pairs for an authenticated user. Use when you need to retrieve CSE keypair configurations including public keys and enablement states. Supports pagination for large result sets. |
| `GOOGLESUPER_LIST_CUSTOM_DIMENSIONS` | List Custom Dimensions | List Custom Dimensions |
| `GOOGLESUPER_LIST_CUSTOM_METRICS` | List Custom Metrics | Tool to list CustomMetrics on a property. Use when you need to retrieve all custom metrics configured for a given property. |
| `GOOGLESUPER_LIST_DATA_STREAMS` | List DataStreams | Tool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property. |
| `GOOGLESUPER_LIST_DRAFTS` | List Drafts | Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp. Draft ordering is non-guaranteed; iterate using page_token until it is absent to retrieve all drafts. Newly created drafts may not appear immediately. Rapid calls may trigger 403 userRateLimitExceeded or 429 errors; apply exponential backoff (1s, 2s, 4s) before retrying. |
| `GOOGLESUPER_LIST_DV360_AD_LINKS` | List Display & Video 360 Advertiser Links | Tool to list Display & Video 360 advertiser links on a property. Use when you need to retrieve DisplayVideo360AdvertiserLink resources associated with a Google Analytics property. Results support pagination for large datasets. |
| `GOOGLESUPER_LIST_DV360_LINK_PROPOSALS` | List DisplayVideo360 Advertiser Link Proposals | Tool to list DisplayVideo360AdvertiserLinkProposals on a property. Use when you need to retrieve Display & Video 360 advertiser link proposals associated with a Google Analytics property. Results support pagination for large datasets. |
| `GOOGLESUPER_LIST_EVENT_CREATE_RULES` | List Event Create Rules | Tool to list EventCreateRules configured on a web data stream. Use when you need to retrieve event create rules for a specific GA4 property data stream. |
| `GOOGLESUPER_LIST_EXPANDED_DATA_SETS` | 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. |
| `GOOGLESUPER_LIST_FILE_LABELS` | List File Labels | Tool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label_id and field_id values required by other Drive label tools must be obtained from admin configuration. |
| `GOOGLESUPER_LIST_FILE_PROPERTIES` | List Properties (v2 API) | 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. |
| `GOOGLESUPER_LIST_FILTERS` | List Gmail 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. |
| `GOOGLESUPER_LIST_FIREBASE_LINKS` | List Firebase Links | Tool to list FirebaseLinks on a property. Use when you need to retrieve Firebase connections associated with a Google Analytics property. Each property can have at most one FirebaseLink. |
| `GOOGLESUPER_LIST_FORWARDING_ADDRESSES` | List forwarding addresses | Tool to list all forwarding addresses for the specified Gmail account. Use when you need to retrieve the email addresses that are allowed to be used for forwarding messages. |
| `GOOGLESUPER_LIST_GOOGLE_ADS_LINKS` | 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. Supports pagination for large result sets. |
| `GOOGLESUPER_LIST_HISTORY` | List Gmail history | Tool to list Gmail mailbox change history since a known startHistoryId. Use for incremental mailbox syncs. Persist the latest historyId as a checkpoint across sessions; without it, incremental sync is unreliable. An empty history list in the response is valid and means no new changes occurred. |
| `GOOGLESUPER_LIST_KEY_EVENTS` | List Key Events | Tool to list Key Events. Use when you need to retrieve all key event definitions for a given property. Key events are read-only via API; creation, updates, and deletion require the Google Analytics UI. An empty results list means no key events are configured, not a failure. Do not infer key-event status from report data (e.g., eventCount); use this tool to confirm. |
| `GOOGLESUPER_LIST_LABELS` | List Gmail labels | Retrieves all system and user-created labels for a Gmail account in a single unpaginated response. Primary use: obtain internal label IDs (e.g., 'Label_123') required by other Gmail tools — display names cannot be used as label identifiers and cause silent failures or errors. System labels (INBOX, UNREAD, SPAM, TRASH, etc.) are case-sensitive and must be used exactly as returned; INBOX, SPAM, and TRASH are read-only and cannot be added/removed via label modification tools. The Gmail search 'label:' operator accepts display names, but label_ids parameters in tools like GMAIL_FETCH_EMAILS require internal IDs from this tool — mixing conventions yields zero results silently. Do not hardcode label IDs across sessions; refresh via this tool on conflict errors. |
| `GOOGLESUPER_LIST_MEASUREMENT_PROTOCOL_SECRETS` | List Measurement Protocol Secrets | Tool to list MeasurementProtocolSecrets under a data stream. Use when you need to retrieve measurement protocol secrets for server-side event tracking. |
| `GOOGLESUPER_LIST_MEDIA_ITEMS` | List Media Items (App-Created Only) | Lists media items created by this application from Google Photos. DEPRECATION NOTICE: As of March 31, 2025, the Google Photos Library API ONLY returns media items that were uploaded/created by your application. This action CANNOT access the user's full photo library. Use cases this action SUPPORTS: - Listing photos/videos your app previously uploaded to the user's library - Managing app-created content in Google Photos Use cases this action DOES NOT SUPPORT: - Accessing photos taken by the user's camera - Viewing photos from other apps or web uploads - Listing the user's entire photo library For accessing a user's full library, use the Google Photos Picker API instead: https://developers.google.com/photos/picker |
| `GOOGLESUPER_LIST_PARTICIPANTS` | List Participants | Lists the participants in a conference record. By default, ordered by join time descending. Use to retrieve all participants who joined a specific Google Meet conference, with support for filtering active participants (where `latest_end_time IS NULL`). |
| `GOOGLESUPER_LIST_PARTICIPANT_SESSIONS` | List Participant Sessions | Lists all participant sessions for a specific participant in a Google Meet conference. A participant session represents each unique join or leave session when a user joins a conference from a device. If a user joins multiple times from the same device, each join creates a new session. Returns session details including start time and end time for each session. |
| `GOOGLESUPER_LIST_PERMISSIONS` | 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. |
| `GOOGLESUPER_LIST_PROPERTIES_FILTERED` | List Property | 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. Supports pagination and including soft-deleted properties. |
| `GOOGLESUPER_LIST_RECORDINGS` | List Recordings | Tool to list recording resources from a conference record. Use when you need to retrieve recordings from a specific Google Meet conference. Recordings are created when meeting recording is enabled and saved to Google Drive as MP4 files. |
| `GOOGLESUPER_LIST_RECURRING_AUDIENCE_LISTS` | List Recurring Audience Lists | Tool to list all recurring audience lists for a GA4 property. Use when you need to find and reuse existing recurring audience lists. |
| `GOOGLESUPER_LIST_REPLIES` | List Replies to Comment | 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. |
| `GOOGLESUPER_LIST_REPORTING_DATA_ANNOTATIONS` | List Reporting Data Annotations | Tool to list all Reporting Data Annotations for a specific property. Use when you need to retrieve annotations that document important events or periods in GA4 reporting data. |
| `GOOGLESUPER_LIST_REPORT_TASKS` | List Report Tasks | Tool to list all report tasks for a Google Analytics property. Use when you need to retrieve report task definitions and their execution status. |
| `GOOGLESUPER_LIST_REVISIONS` | List File Revisions | Tool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version. |
| `GOOGLESUPER_LIST_SEARCH_ADS360_LINKS` | List Search Ads 360 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. Supports pagination for large result sets. |
| `GOOGLESUPER_LIST_SEND_AS` | List send-as aliases | Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases. Use when you need to retrieve available sending addresses for composing emails. |
| `GOOGLESUPER_LIST_SHARED_DRIVES` | 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. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages. |
| `GOOGLESUPER_LIST_SK_AD_NETWORK_CONVERSION_VALUE_SCHEMAS` | List SKAdNetwork Conversion Value Schemas | Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream. Use when you need to retrieve conversion value schemas for iOS app tracking. Maximum one schema per property is supported. |
| `GOOGLESUPER_LIST_SMIME_INFO` | List S/MIME configs | 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 send-as email address. |
| `GOOGLESUPER_LIST_SPREADSHEET_CHARTS` | Get Charts from Spreadsheet | Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs. |
| `GOOGLESUPER_LIST_SUBPROPERTY_EVENT_FILTERS` | 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. |
| `GOOGLESUPER_LIST_SUBPROPERTY_SYNC_CONFIGS` | List Subproperty Sync Configs | Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. Use when you need to fetch subproperty sync configs for a GA4 property. |
| `GOOGLESUPER_LIST_TASK_LISTS` | List task lists | Fetches the authenticated user's task lists from Google Tasks; results may be paginated. Response contains task lists under the `items` key. Multiple lists may share similar names — confirm the correct list by ID before passing to other tools. |
| `GOOGLESUPER_LIST_TASKS` | 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. Response key for tasks is `tasks` (not `items`). No full-text search; filter client-side by title/notes. Results ordered by position, not by date. |
| `GOOGLESUPER_LIST_THREADS` | List threads | Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination. Spam and trash are excluded by default unless explicitly targeted via `label:spam` or `label:trash` in the query. |
| `GOOGLESUPER_LIST_TRANSCRIPT_ENTRIES` | List Transcript Entries | Tool to list structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript. Use when you need to access the detailed content of a transcript, including individual spoken segments with timestamps and speaker information. Note: The transcript entries returned by the API might not match the transcription in Google Docs due to interleaved speakers or post-generation modifications. |
| `GOOGLESUPER_LOOKUP_AERIAL_VIDEO` | Lookup Aerial Video | Tool to look up an aerial view video by address or video ID. Returns video metadata including state and URIs for playback. Use when you need to retrieve a previously rendered aerial video or check the status of a video render request. Note that receiving a video is a billable event. |
| `GOOGLESUPER_LOOKUP_SPREADSHEET_ROW` | Look up 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 range or the first sheet by default. |
| `GOOGLESUPER_MAPS_EMBED_API` | Embed Google Map | Tool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does not make direct API calls. Generated embed URLs are publicly accessible; avoid passing sensitive or internal location queries. |
| `GOOGLESUPER_MODIFY_FILE_LABELS` | Modify File Labels | Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, updating, or removing them. |
| `GOOGLESUPER_MODIFY_THREAD_LABELS` | Modify thread labels | Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. To modify a single message only, use a message-level tool instead. |
| `GOOGLESUPER_MOVE_FILE` | Move File | Tool to move a file from one folder to another in Google Drive. To truly move (not just copy the parent), always provide both `add_parents` (destination folder ID) and `remove_parents` (source folder ID); omitting `remove_parents` leaves the file in multiple folders. Useful for reorganizing files, including newly created Google Docs/Sheets that default to Drive root. |
| `GOOGLESUPER_MOVE_TASK` | Move Task | Moves the specified task to another position in the task list or to a different task list. Use cases: - Reorder tasks within a list (use 'previous' parameter) - Create subtasks by moving a task under a parent (use 'parent' parameter) - Move tasks between different task lists (use 'destinationTasklist' parameter) - Move a subtask back to top-level (omit 'parent' parameter) |
| `GOOGLESUPER_MOVE_THREAD_TO_TRASH` | Trash thread | Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash. |
| `GOOGLESUPER_MOVE_TO_TRASH` | Move to Trash | Moves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool. |
| `GOOGLESUPER_MUTATE_AD_GROUPS` | Mutate Ad Groups | Create, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations — deleted ad groups cannot be recovered once removed. |
| `GOOGLESUPER_MUTATE_CAMPAIGNS` | Mutate Campaigns | Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request. Use when managing campaign lifecycle, applying bulk changes, or automating campaign management workflows. This action is irreversible for remove operations — deleted campaigns cannot be recovered. Plan accordingly and consider using validate_only=true to test changes before applying them. |
| `GOOGLESUPER_MUTATE_CONDITIONAL_FORMAT_RULES` | Mutate conditional format rules | Add, update, delete, or reorder conditional format rules on a Google Sheet. Use when you need to create, modify, or remove conditional formatting without manually building batchUpdate requests. Supports four operations: ADD (create new rule), UPDATE (replace existing rule), DELETE (remove rule), MOVE (reorder rules by changing index). |
| `GOOGLESUPER_NEARBY_SEARCH` | 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 fields and number of results. |
| `GOOGLESUPER_PATCH_CALENDAR` | Patch Calendar | Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for `description` or `location` clear them. |
| `GOOGLESUPER_PATCH_EVENT` | Patch Event | 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 valid and the user has write access to the calendar. |
| `GOOGLESUPER_PATCH_LABEL` | Patch Label | Patches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected. |
| `GOOGLESUPER_PATCH_PERMISSION` | 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 fields. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied. |
| `GOOGLESUPER_PATCH_PROPERTY` | Patch Property (v2 API) | Tool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file. |
| `GOOGLESUPER_PATCH_SEND_AS` | Patch send-as alias | 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 display name, reply-to address, signature, default status, or SMTP configuration. |
| `GOOGLESUPER_PATCH_TASK` | Patch Task | 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`, `notes`, `due` date, `status`) and requiring both the task and list to exist. |
| `GOOGLESUPER_PATCH_TASK_LIST` | Patch task list | Updates the title of an existing Google Tasks task list. |
| `GOOGLESUPER_PLACE_PHOTO` | Get Place Photo | Retrieves high quality photographic content from the Google Maps Places database. Use when you need to download a place photo using a photo_reference obtained from Place Details, Nearby Search, or Text Search requests. Images are scaled proportionally to fit within specified dimensions. |
| `GOOGLESUPER_PRESENTATIONS_BATCH_UPDATE` | Update Presentation (Batch/Markdown) | Update Google Slides presentations using markdown content or raw API text. Supports professional themes, auto-formatting, and multiple slide types (title, bullet, table, quote, image, two-column). |
| `GOOGLESUPER_PRESENTATIONS_COPY_FROM_TEMPLATE` | Copy Google Slides from Template | Tool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy. Use when you need to preserve themes, masters, and layouts exactly as they appear in the template. After copying, use GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE to replace placeholder text or images. |
| `GOOGLESUPER_PRESENTATIONS_GET` | Get Presentation | Tool to retrieve the latest version of a presentation. Use after obtaining the presentation ID. |
| `GOOGLESUPER_PRESENTATIONS_PAGES_GET` | Get Presentation Page | Tool to get the latest version of a specific page in a presentation. Use when you need to inspect slide, layout, master, or notes page details. |
| `GOOGLESUPER_PROVISION_ACCOUNT_TICKET` | Provision Account Ticket | Tool to request a ticket for creating a Google Analytics account. Use when you need to initiate the account creation flow that requires user acceptance of Terms of Service. |
| `GOOGLESUPER_QUERY_AUDIENCE_EXPORT` | Query Audience Export | Tool to query a completed audience export. Use when you need to fetch user rows with pagination. |
| `GOOGLESUPER_QUERY_AUDIENCE_LIST` | Query Audience List | Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination. |
| `GOOGLESUPER_QUERY_REPORT_TASK` | 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. This method returns an error if the report task's state is not ACTIVE. |
| `GOOGLESUPER_QUICK_ADD` | Quick Add Event | 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 events, and `calendar_id` must be valid if not 'primary'. |
| `GOOGLESUPER_REMOVE_ATTENDEE` | Remove attendee from event | Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event. |
| `GOOGLESUPER_RENDER_AERIAL_VIDEO` | Render Aerial Video | Starts rendering an aerial view video for a US postal address. Returns a video ID that can be used with lookupVideo to retrieve the video once rendering completes. Rendering typically takes up to a few hours. |
| `GOOGLESUPER_REPLACE_ALL_TEXT` | Replace All Text in Document | Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document. |
| `GOOGLESUPER_REPLACE_IMAGE` | Replace Image in Document | Tool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc. |
| `GOOGLESUPER_REPLY_TO_THREAD` | Reply to email 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 instead of replying in-thread. Requires a valid `thread_id` and at least one of `recipient_email`, `cc`, or `bcc`. Supports attachments via the `attachment` parameter with `name`, `mimetype`, and `s3key` fields. |
| `GOOGLESUPER_RESUMABLE_UPLOAD` | Resumable Upload | Tool to start and complete a Google Drive resumable upload session. Use for files larger than ~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required. |
| `GOOGLESUPER_RUN_FUNNEL_REPORT` | Run Funnel Report | Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property. Funnel step sequence is determined by step attributes in the response, not row order. |
| `GOOGLESUPER_RUN_PIVOT_REPORT` | Run Pivot Report | Tool to run a customized pivot report of Google Analytics event data. Use when you need a pivot table view with advanced segmentation and multi-dimensional analysis of GA4 data. |
| `GOOGLESUPER_RUN_REALTIME_REPORT` | Run Realtime Report | Tool to run a customized realtime report of Google Analytics event data. Use when you need realtime data (last 30-60 minutes) with dimensions and metrics for a GA4 property. |
| `GOOGLESUPER_RUN_REPORT` | Run Report | Tool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges. IMPORTANT - DIMENSION/METRIC COMPATIBILITY: The Google Analytics Data API has strict compatibility rules between dimensions and metrics. Not all combinations are valid. If you receive a 400 error with a message about incompatible dimensions/metrics, use the GOOGLE_ANALYTICS_CHECK_COMPATIBILITY action first to validate your dimension/metric combinations before running reports. Common incompatibilities include: - Demographic dimensions (userAgeBracket, userGender) with session-scoped dimensions/filters (sessionCampaignName, sessionSource) - Certain user-scoped dimensions with event-scoped metrics For complex queries, consider starting with simpler dimension/metric combinations or use CHECK_COMPATIBILITY to pre-validate your request. |
| `GOOGLESUPER_SEARCH_DEVELOPER_METADATA` | Search Developer Metadata | Tool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters. |
| `GOOGLESUPER_SEARCH_DOCUMENTS` | Search Documents | Search for Google Documents using various filters including name, content, date ranges, and more. |
| `GOOGLESUPER_SEARCH_MEDIA_ITEMS` | Search Media Items | Searches for media items in a user's Google Photos library. |
| `GOOGLESUPER_SEARCH_PEOPLE` | Search People | Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'. Only searches the authenticated user's contact directory — people existing solely in message headers won't appear; use GMAIL_FETCH_EMAILS for those. Results may be zero or multiple; never auto-select from ambiguous results. Results paginate via next_page_token; follow until empty and deduplicate by email. Many records lack emailAddresses or names even when requested — handle missing keys. Directory/organization policies may suppress entries. |
| `GOOGLESUPER_SEARCH_SPREADSHEETS` | Search Spreadsheets | Search for Google Spreadsheets using various filters including name, content, date ranges, and more. |
| `GOOGLESUPER_SEARCH_STREAM_GAQL` | Search Stream GAQL | Execute a Google Ads Query Language (GAQL) query and stream all results in a single response. This method is more efficient than paginated search for bulk data retrieval of campaigns, ad groups, and performance metrics (clicks, impressions, cost). Use this action when you need the entire result set without pagination. Results are returned as a single response containing all matching rows. |
| `GOOGLESUPER_SEND_DRAFT` | Send Draft | Sends an existing draft email AS-IS to recipients already defined within the draft. IMPORTANT: This action does NOT accept recipient parameters (to, cc, bcc). The Gmail API's drafts/send endpoint sends drafts to whatever recipients are already set in the draft's To, Cc, and Bcc headers - it cannot add or override recipients. If the draft has no recipients, you must either: 1. Create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, then send it 2. Use GMAIL_SEND_EMAIL to send a new email directly with recipients. Send is immediate and irreversible — confirm recipients and content before calling. No scheduling support; trigger at the desired UTC time externally. Gmail enforces ~25 MB message size limit and daily send caps (~500 recipients/day personal, ~2,000/day Workspace). |
| `GOOGLESUPER_SEND_EMAIL` | Send Email | Sends an email via Gmail API using the authenticated user's Google profile display name. Sends immediately and is irreversible — confirm recipients, subject, body, and attachments before calling. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. All common file types including PNG, JPG, PDF, MP4, etc. are supported as attachments. Gmail API limits total message size to ~25 MB after base64 encoding. To reply in an existing thread, use GMAIL_REPLY_TO_THREAD instead. No scheduled send support; enforce timing externally. |
| `GOOGLESUPER_SEND_EVENTS` | Send Events | Tool to send event data to Google Analytics 4 using the Measurement Protocol. Use when you need to track server-side events that supplement client-side gtag.js or Firebase tracking. The Measurement Protocol allows sending event data directly to GA4 from servers, applications, or other devices. Events are processed asynchronously and typically appear in reports within 24-48 hours. For validation, use the validation server endpoint first (mp/collect/validate). |
| `GOOGLESUPER_SET_BASIC_FILTER` | Set Basic Filter | Tool to set a basic filter on a sheet in a Google Spreadsheet. Use when you need to filter or sort data within a specific range on a sheet. |
| `GOOGLESUPER_SET_DATA_VALIDATION_RULE` | Set Data Validation Rule | Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets. Use when you need to apply dropdown lists, range-based dropdowns, or custom formula validation to cells. |
| `GOOGLESUPER_SETTINGS_GET` | Get Calendar Setting | Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value. |
| `GOOGLESUPER_SETTINGS_GET_IMAP` | Get IMAP Settings | Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size. |
| `GOOGLESUPER_SETTINGS_GET_POP` | Get POP settings | 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. |
| `GOOGLESUPER_SETTINGS_LIST` | List Settings | 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. `timeZone` values are IANA identifiers (e.g., `America/New_York`) — use directly in datetime and event logic; align with `timeZone` from GOOGLECALENDAR_GET_CALENDAR for consistent notification times. |
| `GOOGLESUPER_SETTINGS_SEND_AS_GET` | Get send-as alias | Tool to retrieve a specific send-as alias configuration for a Gmail user. Use when you need to get details about a send-as email address including display name, signature, SMTP settings, and verification status. Fails with HTTP 404 if the specified address is not a member of the send-as collection. |
| `GOOGLESUPER_SETTINGS_WATCH` | Watch Settings | Watch for changes to Settings resources. |
| `GOOGLESUPER_SPREADSHEETS_SHEETS_COPY_TO` | Copy Sheet to Another Spreadsheet | Tool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet. |
| `GOOGLESUPER_SPREADSHEETS_VALUES_APPEND` | Append Values to Spreadsheet | 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. |
| `GOOGLESUPER_SPREADSHEETS_VALUES_BATCH_CLEAR` | Batch Clear Spreadsheet Values | Tool to clear one or more ranges of values from a spreadsheet. Use when you need to remove data from specific cells or ranges while keeping formatting and other properties intact. |
| `GOOGLESUPER_SPREADSHEETS_VALUES_BATCH_GET_BY_DATA_FILTER` | Batch Get Spreadsheet Values by Data Filter | Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. Use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges. |
| `GOOGLESUPER_STOP_WATCH` | Stop watch notifications | Tool to stop receiving push notifications for a Gmail mailbox. Use when you need to disable watch notifications previously set up via the watch endpoint. |
| `GOOGLESUPER_STOP_WATCH_CHANNEL` | Stop Watch Channel | Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from the original watch response — they cannot be retrieved after the fact. |
| `GOOGLESUPER_TEXT_SEARCH` | Text Search | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower"). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places — filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff. |
| `GOOGLESUPER_TILES_CREATE_SESSION` | Create Tiles Session | Tool to create a session token required for accessing 2D Tiles and Street View imagery. Use when you need to initialize tile-based map rendering or street view display. The session token is valid for approximately two weeks and must be included in all subsequent tile requests. Each call consumes quota — cache and reuse the returned token across all tile requests within its validity window rather than creating a new session per request. |
| `GOOGLESUPER_TRASH_FILE` | 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. This action is distinct from permanent deletion and provides a safer cleanup workflow. |
| `GOOGLESUPER_UNHIDE_DRIVE` | Unhide Shared Drive | Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view. |
| `GOOGLESUPER_UNMERGE_TABLE_CELLS` | 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. |
| `GOOGLESUPER_UNTRASH_FILE` | Untrash File | Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in trash — recovery is impossible after trash is emptied via GOOGLEDRIVE_EMPTY_TRASH or auto-purged by policy. |
| `GOOGLESUPER_UNTRASH_MESSAGE` | Untrash Message | Tool to remove a message from trash in Gmail. Use when you need to restore a previously trashed email message. |
| `GOOGLESUPER_UNTRASH_THREAD` | Untrash thread | Tool to remove a thread from trash in Gmail. Use when you need to restore a deleted thread and its messages. |
| `GOOGLESUPER_UPDATE_ALBUM` | Update Album | Updates an album's title or cover photo in Google Photos. |
| `GOOGLESUPER_UPDATE_CHART` | Update Chart in Google Sheets | Update the specification of an existing chart in a Google Sheets spreadsheet. Use this action when you need to modify an existing chart's properties such as its title, chart type, data ranges, colors, axes, or other visual settings. This action updates the chart's specification but does not change its position or size on the sheet. |
| `GOOGLESUPER_UPDATE_COMMENT` | Update Comment | Tool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The 'resolved' field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE_REPLY with action='resolve' or action='reopen'. |
| `GOOGLESUPER_UPDATE_DIMENSION_PROPERTIES` | Update Dimension Properties (Hide/Unhide & Resize) | Tool to hide/unhide rows or columns and set row heights or column widths. Use when you need to change visibility or pixel sizing of dimensions in a Google Sheet. |
| `GOOGLESUPER_UPDATE_DOCUMENT_MARKDOWN` | Update Document Markdown | Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document. |
| `GOOGLESUPER_UPDATE_DOCUMENT_SECTION_MARKDOWN` | Update Document Section Markdown | Tool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting. |
| `GOOGLESUPER_UPDATE_DOCUMENT_STYLE` | Update Document Style | Tool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document. |
| `GOOGLESUPER_UPDATE_DRAFT` | Update draft | Updates (replaces) an existing Gmail draft's content in-place by draft ID. This action replaces the entire draft content with the new message - it does not patch individual fields. All fields are optional; if not provided, you should provide complete draft content to avoid data loss. |
| `GOOGLESUPER_UPDATE_DRIVE` | Update Shared 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. |
| `GOOGLESUPER_UPDATE_EVENT` | Update Google event | Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement: omitted fields (including attendees, reminders, recurrence, conferencing) are cleared. Always provide the complete desired event state. Use GOOGLECALENDAR_PATCH_EVENT instead for partial edits. |
| `GOOGLESUPER_UPDATE_EXISTING_DOCUMENT` | Update existing document | Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method. |
| `GOOGLESUPER_UPDATE_FILE_METADATA_PATCH` | Update File Metadata (PATCH v2) | Tool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics. |
| `GOOGLESUPER_UPDATE_FILE_PROPERTY` | Update Property (v2 API) | Tool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file. |
| `GOOGLESUPER_UPDATE_FILE_PUT` | Update File (Metadata) | Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented. |
| `GOOGLESUPER_UPDATE_FILE_REVISION_METADATA` | Update File Revision Metadata | Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action. |
| `GOOGLESUPER_UPDATE_IMAP_SETTINGS` | 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 auto-expunge behavior, or configuring folder size limits. |
| `GOOGLESUPER_UPDATE_LABEL` | Update Label | Tool to update the properties of an existing Gmail label. Use when you need to modify label name, visibility settings, or color. |
| `GOOGLESUPER_UPDATE_LANGUAGE_SETTINGS` | 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. The returned displayLanguage may differ from the requested value if Gmail selects a close variant. |
| `GOOGLESUPER_UPDATE_MEDIA_ITEM` | Update Media Item | Updates a media item's description in Google Photos. |
| `GOOGLESUPER_UPDATE_PERMISSION` | 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. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating. |
| `GOOGLESUPER_UPDATE_POP_SETTINGS` | 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. |
| `GOOGLESUPER_UPDATE_PROPERTY` | 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. |
| `GOOGLESUPER_UPDATE_REPLY` | 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. |
| `GOOGLESUPER_UPDATE_SEND_AS` | Update send-as alias | 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. Gmail sanitizes HTML signatures before saving. Addresses other than the primary can only be updated by service accounts with domain-wide authority. |
| `GOOGLESUPER_UPDATE_SHEET_PROPERTIES` | 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. Use this when you need to modify the metadata or appearance of a specific sheet. |
| `GOOGLESUPER_UPDATE_SPACE` | Update Google Meet Space | Updates the settings of an existing Google Meet space. Requires organizer/host privileges and the meetings.space.created OAuth scope. REQUIRED PARAMETER: - name: The space identifier (e.g., 'spaces/jQCFfuBOdN5z'). This is always required to identify which space to update. OPTIONAL PARAMETERS: - config: The new configuration settings to apply (accessType, entryPointAccess, moderation, etc.) - updateMask: Specify which fields to update. If omitted, all provided config fields are updated. Example: To change access type, provide name='spaces/abc123' and config={'accessType': 'OPEN'} |
| `GOOGLESUPER_UPDATE_SPREADSHEET_PROPERTIES` | Update Spreadsheet Properties | Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings. Use when you need to modify the overall configuration of a Google Spreadsheet. NOTE: To update individual SHEET properties (like renaming a specific sheet/tab), use GOOGLESHEETS_UPDATE_SHEET_PROPERTIES instead. |
| `GOOGLESUPER_UPDATE_TABLE_ROW_STYLE` | Update Table Row Style | Tool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers. |
| `GOOGLESUPER_UPDATE_TASK_FULL` | Update Task (Full Replacement) | Tool to fully replace an existing Google Task using PUT method. Use when you need to update the entire task resource, not just specific fields. This method requires all required fields (id, title) and replaces the complete task, unlike PATCH which supports partial updates. |
| `GOOGLESUPER_UPDATE_TASK_LIST` | Update Task List | Updates the authenticated user's specified task list. |
| `GOOGLESUPER_UPDATE_USER_ATTRIBUTES_VALUES` | 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. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value. |
| `GOOGLESUPER_UPDATE_VACATION_SETTINGS` | Update Vacation Settings | Tool to update vacation responder settings for a Gmail user. Use when you need to configure out-of-office auto-replies. |
| `GOOGLESUPER_UPDATE_VALUES_BATCH` | Batch update spreadsheet values | 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. |
| `GOOGLESUPER_UPLOAD_FILE` | 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. Always creates a new file (never updates existing); use GOOGLEDRIVE_EDIT_FILE to update with a stable file_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE. |
| `GOOGLESUPER_UPLOAD_FROM_URL` | Upload File from URL to Drive | Tool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage. |
| `GOOGLESUPER_UPLOAD_MEDIA` | Upload Media | Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB). |
| `GOOGLESUPER_UPLOAD_UPDATE_FILE` | Upload/Update File Content | Tool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data. |
| `GOOGLESUPER_UPSERT_ROWS` | Upsert Rows (Smart Update/Insert) | Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. Use for: CRM syncs (match Lead ID), transaction imports (match Transaction ID), inventory updates (match SKU), calendar syncs (match Event ID). Features: - Auto-adds missing columns to sheet - Partial column updates (only update Phone + Status, preserve other columns) - Column order doesn't matter (auto-maps by header name) - Prevents duplicates by matching key column Example inputs: - Contact update: keyColumn='Email', headers=['Email','Phone','Status'], data=[['john@ex.com','555-0101','Active']] - Inventory sync: keyColumn='SKU', headers=['SKU','Stock','Price'], data=[['WIDGET-001',50,9.99],['GADGET-002',30,19.99]] - CRM lead update: keyColumn='Lead ID', headers=['Lead ID','Score','Status'], data=[['L-12345',85,'Hot']] - Partial update: keyColumn='Email', headers=['Email','Phone'] (only updates Phone, preserves Name/Address/etc) |
| `GOOGLESUPER_VALIDATE_EVENTS` | Validate Events | Tool to validate Measurement Protocol events before sending them to production. Use when you need to verify event structure and parameters are correct before sending real data. |
| `GOOGLESUPER_VALUES_GET` | Get spreadsheet values | Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet. |
| `GOOGLESUPER_VALUES_UPDATE` | Update spreadsheet values | 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. |
| `GOOGLESUPER_WATCH_CHANGES` | Watch Drive Changes | Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page_token on each notification. |
| `GOOGLESUPER_WATCH_FILE` | Watch File for Changes | Tool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL. |

## Supported Triggers

| Trigger slug | Name | Description |
|---|---|---|
| `GOOGLESUPER_AGGREGATE_METRIC_CHANGED_TRIGGER` | Aggregate Metric Changed | Triggers when an aggregate metric (SUM/COUNT/AVG/MIN/MAX) changes in a Google Sheets spreadsheet. This trigger monitors an aggregate calculation on a target column (optionally filtered by a search column/value) and fires when the calculated result changes. |
| `GOOGLESUPER_ATTENDEE_RESPONSE_CHANGED_TRIGGER` | Attendee Response Changed | Polling trigger that fires when any attendee's RSVP changes to accepted, declined, or tentative. Returns attendee info and current status. |
| `GOOGLESUPER_CELL_RANGE_VALUES_CHANGED_TRIGGER` | Cell Range Values Changed | Triggers when values in a specified A1 range change in Google Sheets. This trigger monitors a specific cell or range of cells and fires when any values change. |
| `GOOGLESUPER_COMMENT_ADDED_TRIGGER` | Comment Added (Docs/Sheets/Slides) | Triggers when a new comment is added to Google Docs, Sheets, or Slides. |
| `GOOGLESUPER_CONDITIONAL_FORMAT_RULE_CHANGED_TRIGGER` | Conditional Format Rule Changed | Triggers when conditional formatting rules change in a Google Spreadsheet. Detects when rules are added, updated, or removed. Uses snapshot-based diffing to detect changes between polls. |
| `GOOGLESUPER_DATA_VALIDATION_RULE_CHANGED_TRIGGER` | Data Validation Rule Changed | Triggers when data validation rules change (added/updated/removed) in a Google Spreadsheet. Uses snapshot-based diffing to detect changes between polls. |
| `GOOGLESUPER_DEVELOPER_METADATA_CHANGED_TRIGGER` | Developer Metadata Changed | Triggers when developer metadata entries change (new/updated/removed) in a Google Spreadsheet. Uses snapshot-based diffing to detect changes between polls. |
| `GOOGLESUPER_DOCUMENT_CREATED_TRIGGER` | New Document Created | Triggers when a new Google Doc is created. This trigger monitors Google Docs and fires when new documents are detected. Uses timestamp filtering to efficiently poll for new documents. |
| `GOOGLESUPER_DOCUMENT_DELETED_TRIGGER` | Document Deleted | Triggers when an existing Google Doc is deleted (moved to trash). This trigger monitors Google Docs and fires when documents are trashed. |
| `GOOGLESUPER_DOCUMENT_PLACEHOLDER_FILLED_TRIGGER` | Document Placeholder Filled | Triggers when a Google Doc's plain text changes such that a configured placeholder token/pattern is no longer present (i.e., the document has been filled in). This trigger monitors a specific Google Doc and fires when a placeholder pattern that was previously present is no longer found in the document's plain text. |
| `GOOGLESUPER_DOCUMENT_SEARCH_UPDATE_TRIGGER` | Document Search Update | Triggers when a Google Doc matching a user-defined search query is newly created or updated since the last poll. This trigger uses timestamp filtering to efficiently monitor documents. |
| `GOOGLESUPER_DOCUMENT_STRUCTURE_CHANGED_TRIGGER` | Document Structure Changed | Triggers when a Google Doc's structure changes (headers/footers added/removed, tables/images count changes). This trigger monitors a specific document for structural changes like: - Headers added or removed - Footers added or removed - Tables added or removed - Images (inline objects) added or removed - Positioned objects added or removed - Footnotes added or removed |
| `GOOGLESUPER_DOCUMENT_UPDATED_TRIGGER` | Document Updated | Triggers when an existing Google Doc is updated or modified. This trigger monitors Google Docs and fires when documents are updated. |
| `GOOGLESUPER_DOCUMENT_WORD_COUNT_THRESHOLD_TRIGGER` | Document Word Count Threshold | Triggers when a Google Doc's word/character count crosses a user-defined threshold. This trigger monitors a specific Google Doc and fires when its word or character count becomes greater than or equal to the configured threshold value. |
| `GOOGLESUPER_EMAIL_SENT_TRIGGER` | Email Sent | Triggers when a Gmail message is sent by the authenticated user. It polls the 'SENT' label and emits metadata including sender, recipients, subject, timestamp, and thread ID. |
| `GOOGLESUPER_EVENT_CANCELED_DELETED_TRIGGER` | Event Canceled or Deleted | Triggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event_id, summary (if available), and cancellation timestamp. |
| `GOOGLESUPER_EVENT_STARTING_SOON_TRIGGER` | Event Starting Soon | Triggers when a calendar event is within a configured number of minutes from starting. Returns event details, time remaining, attendees, and join links when available. |
| `GOOGLESUPER_FILE_CREATED_TRIGGER` | File Created | Triggers when a new file is created in Google Drive. |
| `GOOGLESUPER_FILE_DELETED_OR_TRASHED_TRIGGER` | File Deleted or Trashed | Triggers when a file is moved to trash or permanently deleted in Drive. |
| `GOOGLESUPER_FILE_SHARED_PERMISSIONS_ADDED` | File Shared (Permissions Added) | Triggers when new sharing permissions are granted to a file or folder. Uses Drive's `changes.list` endpoint with inline `permissions` in the `fields` mask so each change carries the file's current permission set provider-atomically. We diff that against `seen_permission_keys` to identify newly added grants. Drive page tokens are the primary cursor; if Drive rejects a stored token, the trigger raises `PollingTriggerError` without clearing state rather than silently re-baselining and dropping events. Limitation: truly ephemeral permissions (added and revoked between two polls without any other file modification in between) are not detected. Drive Activity API would catch those but requires an additional OAuth scope and a different payload contract. |
| `GOOGLESUPER_FILE_UPDATED_TRIGGER` | File Updated | Triggers when a file's metadata or content changes in Google Drive. |
| `GOOGLESUPER_FILTERED_RANGE_VALUES_CHANGED_TRIGGER` | Filtered Range Values Changed | Polling trigger that monitors Google Sheets filtered ranges for value changes. Uses snapshot-based diffing to detect when values matching a data filter change. Emits the matched values when changes are detected. |
| `GOOGLESUPER_FOLDER_CREATED_TRIGGER` | New Folder Created in Root | Triggers when a new folder is created in the root folder of Google Drive. This trigger monitors Google Drive and fires when new folders are detected in the root directory. |
| `GOOGLESUPER_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGER` | Calendar Event Changes | **SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead. Real-time webhook trigger for calendar event changes. Returns event metadata only. For full event data, use Calendar Event Sync (polling trigger). |
| `GOOGLESUPER_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER` | Event Created | Polling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info. |
| `GOOGLESUPER_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER` | Calendar Event Sync | Polling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook). |
| `GOOGLESUPER_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER` | Event Updated | Triggers when an existing Google Calendar event is modified. Returns the event ID, change type, and the specific fields that changed with their previous and new values. |
| `GOOGLESUPER_GOOGLE_DRIVE_CHANGES` | Google Drive Changes | Triggers when changes are detected in a Google Drive. |
| `GOOGLESUPER_KEYWORD_DETECTED_TRIGGER` | Keyword Detected in Document | Triggers when a specific keyword or phrase first appears in a Google Doc. This trigger monitors a Google Doc and fires once when the specified keyword is detected. After the keyword is found, the trigger will not fire again until reset. |
| `GOOGLESUPER_NEW_FILE_MATCHING_QUERY_TRIGGER` | New File Matching Query | Triggers when a new Google Drive file matches a provided query. This is the legacy query-centric trigger: it preserves Drive API query config such as ``corpora`` / ``driveId`` aliases and emits the historical ``file_matching_query`` event type. ``FileCreatedTrigger`` covers the broader "new file" case and emits ``file_created``. |
| `GOOGLESUPER_NEW_MESSAGE` | New Gmail Message Received Trigger | Triggers when a new message is received in Gmail. |
| `GOOGLESUPER_NEW_ROWS_TRIGGER` | New Rows in Google Sheet | Simple polling trigger that monitors Google Sheets for new rows. Detects when new rows are added and returns the complete row data. Perfect for triggering any workflow based on new sheet entries. |
| `GOOGLESUPER_NEW_SHEET_ADDED_TRIGGER` | New Sheet Added in Google Spreadsheet | Polling trigger that detects when a new sheet is added to a Google Spreadsheet. |
| `GOOGLESUPER_NEW_SPREADSHEET_CREATED_TRIGGER` | New Spreadsheet Created | Triggers when a new Google Spreadsheet is created. This trigger monitors Google Spreadsheets and fires when new spreadsheets are detected. Uses timestamp filtering to efficiently detect newly created spreadsheets. |
| `GOOGLESUPER_NEW_TASK_CREATED_TRIGGER` | New Task Created | Triggers when a new task is created in a Google Tasks list. Uses timestamp filtering (updatedMin) to efficiently detect new tasks. |
| `GOOGLESUPER_NEW_TASK_LIST_CREATED_TRIGGER` | New Task List Created | Triggers when a new Google Tasks task list is created. This trigger monitors Google Tasks and fires when new task lists are detected. |
| `GOOGLESUPER_PAGE_ADDED_TRIGGER` | New Document Added | Triggers when a new Google Doc is added/created. This trigger monitors Google Docs and fires when new documents are detected. |
| `GOOGLESUPER_SLIDE_ADDED_TRIGGER` | New Slide Added | Fires when a new slide is added to a Google Slides presentation. |
| `GOOGLESUPER_SPREADSHEET_METADATA_CHANGED_TRIGGER` | Spreadsheet Metadata Changed | Polling trigger that detects when a Google Spreadsheet's metadata changes. Uses snapshot-based diffing to detect any changes in spreadsheet properties, sheets, named ranges, developer metadata, data sources, etc. |
| `GOOGLESUPER_SPREADSHEET_PROPERTIES_CHANGED_TRIGGER` | Spreadsheet Properties Changed | Polling trigger that detects when a Google Spreadsheet's top-level properties change. Monitors properties such as title, locale, timeZone, and autoRecalc settings. |
| `GOOGLESUPER_SPREADSHEET_ROW_CHANGED_TRIGGER` | Spreadsheet Row Changed | Triggers when a looked-up spreadsheet row changes. This trigger monitors a specific row (located by searching for a query value within a user-specified range) and fires when the row's values change, when the row appears, or when the row disappears. |
| `GOOGLESUPER_SPREADSHEET_SEARCH_MATCH_TRIGGER` | Spreadsheet Search Match | Triggers when a new spreadsheet appears that matches a saved search. This trigger uses snapshot-based diffing to detect when spreadsheets matching the search criteria are newly created or become visible to the user. |
| `GOOGLESUPER_TABLE_QUERY_RESULT_CHANGED_TRIGGER` | Table Query Result Changed | Triggers when the result set of a saved table query changes in Google Sheets. Detects rows added, removed, or updated in the query output. This trigger monitors the result of a SQL query against a Google Sheets table and fires when changes are detected. |
| `GOOGLESUPER_TABLE_SCHEMA_CHANGED_TRIGGER` | Table Schema Changed | Polling trigger that detects when a table's schema changes in Google Sheets. Monitors columns added/removed/renamed and inferred type/format changes. Uses snapshot-based diffing to compare schemas between polls. |
| `GOOGLESUPER_TASK_DETAILS_CHANGED_TRIGGER` | Task Details Changed | Triggers when a specific task's details change. This trigger monitors a single Google Task and fires when any of its details (title, notes, status, due date, completion, position) are modified. |
| `GOOGLESUPER_TASK_LIST_CHANGED_TRIGGER` | Task List Changed | Triggers when a task list changes (title or content updates). This trigger monitors a specific Google Tasks list and fires when changes are detected. |
| `GOOGLESUPER_TASK_UPDATED_TRIGGER` | Task Updated | Triggers when an existing task is updated in a Google Tasks list. This trigger monitors a specific task list and fires when tasks are modified. |
| `GOOGLESUPER_WORKSHEET_NAMES_CHANGED_TRIGGER` | Worksheet Names Changed | Triggers when the set of worksheet/tab names changes in a Google Spreadsheet. Detects when sheets are added, deleted, or renamed. |

## Creating MCP Server - Stand-alone vs Composio SDK

The Google Super MCP server connects Claude Cowork to your Google Super account through Composio. Once connected, Cowork can use the available Google Super tools and triggers to complete tasks on your behalf.

## Complete Code

None listed.

## How to build Google Super MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/googlesuper/framework/chatgpt)
- [Antigravity](https://composio.dev/toolkits/googlesuper/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/googlesuper/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/googlesuper/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/googlesuper/framework/claude-code)
- [Codex](https://composio.dev/toolkits/googlesuper/framework/codex)
- [Cursor](https://composio.dev/toolkits/googlesuper/framework/cursor)
- [VS Code](https://composio.dev/toolkits/googlesuper/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/googlesuper/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/googlesuper/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/googlesuper/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/googlesuper/framework/cli)
- [Google ADK](https://composio.dev/toolkits/googlesuper/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/googlesuper/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/googlesuper/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/googlesuper/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/googlesuper/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/googlesuper/framework/crew-ai)

## Related Toolkits

- [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.
- [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.
- [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.
- [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease.
- [Algodocs](https://composio.dev/toolkits/algodocs) - Algodocs is an AI-powered platform that automates data extraction from business documents. It delivers fast, secure, and accurate processing without templates or manual training.
- [Api2pdf](https://composio.dev/toolkits/api2pdf) - Api2Pdf is a REST API for generating PDFs from HTML, URLs, and documents using powerful engines like wkhtmltopdf and Headless Chrome. It streamlines document conversion and automation for developers and businesses.
- [Aryn](https://composio.dev/toolkits/aryn) - Aryn is an AI-powered platform for parsing, extracting, and analyzing data from unstructured documents. Use it to automate document processing and unlock actionable insights from your files.
- [Boldsign](https://composio.dev/toolkits/boldsign) - Boldsign is a digital eSignature platform for sending, signing, and tracking documents online. Organizations use it to automate agreements and manage legally binding workflows efficiently.
- [Boloforms](https://composio.dev/toolkits/boloforms) - BoloForms is an eSignature platform built for small businesses, offering unlimited signatures, templates, and forms. It simplifies digital document signing and team collaboration at a predictable, fixed price.
- [Box](https://composio.dev/toolkits/box) - Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere.
- [Carbone](https://composio.dev/toolkits/carbone) - Carbone is a blazing-fast report generator that turns JSON data into PDFs, Word docs, spreadsheets, and more using flexible templates. It lets you automate document creation at scale with minimal code.
- [Castingwords](https://composio.dev/toolkits/castingwords) - CastingWords is a transcription service specializing in human-powered, accurate transcripts via a simple API. Get seamless audio-to-text conversion for interviews, meetings, podcasts, and more.
- [Cloudconvert](https://composio.dev/toolkits/cloudconvert) - CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place.
- [Cloudlayer](https://composio.dev/toolkits/cloudlayer) - Cloudlayer is a document and asset generation service for creating PDFs and images via API or SDKs. It lets you automate high-quality doc creation, saving dev time and reducing manual work.
- [Cloudpress](https://composio.dev/toolkits/cloudpress) - Cloudpress is a content export tool for Google Docs and Notion. It automates publishing to your favorite Content Management Systems.
- [Contentful graphql](https://composio.dev/toolkits/contentful_graphql) - Contentful graphql is a content delivery API that lets you access Contentful data using GraphQL queries. It gives you efficient, flexible ways to fetch and manage structured content for any digital project.
- [Conversion tools](https://composio.dev/toolkits/conversion_tools) - Conversion Tools is an online service for converting documents between formats such as PDF, Word, Excel, XML, and CSV. It lets you automate complex document workflows with just a few clicks.
- [Convertapi](https://composio.dev/toolkits/convertapi) - ConvertAPI is a robust file conversion service for documents, images, and spreadsheets. It streamlines programmatic format changes and lets developers automate complex workflows with a single API.
- [Craftmypdf](https://composio.dev/toolkits/craftmypdf) - CraftMyPDF is a web-based service for designing and generating PDFs with templates and live data. It streamlines document creation by automating personalized PDFs at scale.
- [Docmosis](https://composio.dev/toolkits/docmosis) - Docmosis generates PDF and Word documents from user-defined templates. It's perfect for merging data fields to quickly produce reports, invoices, and business letters.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Google Super MCP?

With a standalone Google Super MCP server, the agents and LLMs can only access a fixed set of Google Super tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Super and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Claude Cowork?

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Super tools.

### Can I manage the permissions and scopes for Google Super while using Tool Router?

Yes, absolutely. You can configure which Google Super scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Super data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)