# Google Super — how to use (mcp.ai)

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

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_googlesuper?ms=1781542740000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `googlesuper_add_enrichment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/googlesuper`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/googlesuper/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/googlesuper/add/enrichment` — Adds an enrichment at a specified position in a defined album.
  - body: { albumId: string, albumPosition?: object, newEnrichmentItem: object }
- `POST https://api.mcp.ai/api/googlesuper/add/file/sharing/preference` — Modifies sharing permissions for an existing google drive file, granting a specified role to a user, group, domain, or 'anyone'.
  - body: { role: string, type: string, domain?: string, file_id: string, email_address?: string }
- `POST https://api.mcp.ai/api/googlesuper/add/label/to/email` — Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids).
  - body: { user_id?: string, message_id: string, add_label_ids?: string[], remove_label_ids?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { emails: string[], operation?: string, resource_name: string }
- `POST https://api.mcp.ai/api/googlesuper/add/sheet` — Adds a new sheet (worksheet) to a spreadsheet. use this tool to create a new tab within an existing google sheet, optionally specifying its title, index, size, and other properties.
  - body: { properties?: object, spreadsheetId: string, responseIncludeGridData?: boolean, includeSpreadsheetInResponse?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/aggregate/column/data` — Searches for rows where a specific column matches a value and performs mathematical operations on data from another column.
  - body: { operation: string, sheet_name: string, search_value: string, search_column: string, target_column: string, case_sensitive?: boolean, has_header_row?: boolean, spreadsheet_id: string, percentage_total?: number }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { length: integer, sheet_id: integer, dimension: string, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/batch/add/media/items` — Adds one or more media items to an album in google photos.
  - body: { albumId: string, mediaItemIds: string[] }
- `POST https://api.mcp.ai/api/googlesuper/batch/create/media/items` — Unified action to upload media files and create them as items in google photos.
  - body: { files: object[], albumId: string, albumPosition?: object }
- `POST https://api.mcp.ai/api/googlesuper/batch/get` — Retrieves data from specified cell ranges in a google spreadsheet; ensure the spreadsheet has at least one worksheet and any explicitly referenced sheet names in ranges exist.
  - body: { ranges?: string[], spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/batch/get/media/items` — Returns the list of media items for the specified media item identifiers.
  - body: { mediaItemIds: string[] }
- `POST https://api.mcp.ai/api/googlesuper/batch/update` — Updates a specified range in a google sheet with given values, or appends them as new rows if `first cell location` is omitted; ensure the target sheet exists and the spreadsheet contains at least one
  - body: { values: array[], sheet_name: string, spreadsheet_id: string, valueInputOption?: string, first_cell_location?: string, includeValuesInResponse?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { data: object[], spreadsheetId: string, valueInputOption: string, includeValuesInResponse?: boolean, responseValueRenderOption?: string, responseDateTimeRenderOption?: string }
- `POST https://api.mcp.ai/api/googlesuper/calendar/list/insert` — Inserts an existing calendar into the user's calendar list.
  - body: { id: string, hidden?: boolean, color_id?: string, selected?: boolean, background_color?: string, color_rgb_format?: boolean, foreground_color?: string, summary_override?: string, default_reminders?: object[], notification_settings?: object }
- `POST https://api.mcp.ai/api/googlesuper/calendar/list/update` — Updates an existing entry on the user\'s calendar list.
  - body: { hidden?: boolean, colorId?: string, selected?: boolean, calendar_id: string, colorRgbFormat?: boolean, backgroundColor?: string, foregroundColor?: string, summaryOverride?: string, defaultReminders?: object[], notificationSettings?: object }
- `POST https://api.mcp.ai/api/googlesuper/calendars/delete` — Deletes a secondary calendar. use calendars.clear for clearing all events on primary calendars.
  - body: { calendar_id: string }
- `POST https://api.mcp.ai/api/googlesuper/calendars/update` — Updates metadata for a calendar.
  - body: { summary: string, location?: string, timeZone?: string, calendarId: string, description?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { sheet_id: integer, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/clear/calendar` — Clears a primary calendar. this operation deletes all events associated with the primary calendar of an account.
  - body: { calendar_id: string }
- `POST https://api.mcp.ai/api/googlesuper/clear/tasks` — Permanently clears all completed tasks from a specified google tasks list; this action is destructive and idempotent.
  - body: { tasklist: string }
- `POST https://api.mcp.ai/api/googlesuper/clear/values` — Clears cell content (preserving formatting and notes) from a specified a1 notation range in a google spreadsheet; the range must correspond to an existing sheet and cells.
  - body: { range: string, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/copy/document` — Tool to create a copy of an existing google document. use this to duplicate a document, for example, when using an existing document as a template. the copied document will have a default title (e.g.,
  - body: { title?: string, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/copy/file` — Duplicates an existing file in google drive, identified by its `file id`.
  - body: { file_id: string, new_title?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/album` — Creates a new album in google photos.
  - body: { id?: string, title: string, productUrl?: string, isWriteable?: boolean, mediaItemsCount?: string, coverPhotoBaseUrl?: string, coverPhotoMediaItemId?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/chart` — Create a chart in a google sheets spreadsheet using the specified data range and chart type.
  - body: { title?: string, sheet_id?: integer, subtitle?: string, chart_type: string, data_range: string, x_axis_title?: string, y_axis_title?: string, background_red?: number, spreadsheet_id: string, background_blue?: number, legend_position?: string, background_green?: number }
- `POST https://api.mcp.ai/api/googlesuper/create/comment` — Tool to create a comment on a file. use when you need to add a new comment to a specific file in google drive.
  - body: { anchor?: string, content: string, file_id: string, quoted_file_content_value?: string, quoted_file_content_mime_type?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/customer/list` — Createcustomerlist tool will create a customer list in google ads.
  - body: { name: string, description?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/document` — Creates a new google docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's id and metadata (excluding body content).
  - body: { text: string, title: string }
- `POST https://api.mcp.ai/api/googlesuper/create/document/markdown` — Creates a new google docs document, optionally initializing it with a title and content provided as markdown text.
  - body: { title: string, markdown_text: string }
- `POST https://api.mcp.ai/api/googlesuper/create/drive` — Tool to create a new shared drive. use when you need to programmatically create a new shared drive for collaboration or storage.
  - body: { name: string, hidden?: boolean, themeId?: string, colorRgb?: string, requestId: string, backgroundImageFile?: object }
- `POST https://api.mcp.ai/api/googlesuper/create/email/draft` — Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading.
  - body: { cc?: string[], bcc?: string[], body: string, is_html?: boolean, subject: string, user_id?: string, thread_id?: string, attachment?: object, recipient_email: string, extra_recipients?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/create/event` — Creates an event on a google calendar, needing rfc3339 utc start/end times (end after start) and write access to the calendar. by default, adds the organizer as an attendee unless exclude organizer is
  - body: { summary?: string, location?: string, timezone?: string, attendees?: string[], eventType?: string, recurrence?: string[], visibility?: string, calendar_id?: string, description?: string, send_updates?: boolean, transparency?: string, start_datetime: string, exclude_organizer?: boolean, guests_can_modify?: boolean, create_meeting_room?: boolean, event_duration_hour?: integer, guestsCanInviteOthers?: boolean, event_duration_minutes?: integer, guestsCanSeeOtherGuests?: boolean, workingLocationProperties?: object }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { parent: string, expandedDataSet: object }
- `POST https://api.mcp.ai/api/googlesuper/create/file` — Creates a new file or folder with metadata. use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation).
  - body: { name?: string, fields?: string, parents?: string[], starred?: boolean, mimeType?: string, description?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/file/from/text` — Creates a new file in google drive from provided text content (up to 10mb), supporting various formats including automatic conversion to google workspace types.
  - body: { file_name: string, mime_type?: string, parent_id?: string, text_content: string }
- `POST https://api.mcp.ai/api/googlesuper/create/folder` — Creates a new folder in google drive, optionally within a parent folder specified by its id or name; if a parent name is provided but not found, the action will fail.
  - body: { parent_id?: string, folder_name: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { type: string, document_id: string, section_break_location?: object }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { location?: object, documentId: string, endOfSegmentLocation?: object }
- `POST https://api.mcp.ai/api/googlesuper/create/google/sheet1` — Creates a new google spreadsheet in google drive using the provided title.
  - body: { title: string }
- `POST https://api.mcp.ai/api/googlesuper/create/header` — Tool to create a new header in a google document. use this tool when you need to add a header to a document, optionally specifying the section it applies to.
  - body: { documentId: string, createHeader: object }
- `POST https://api.mcp.ai/api/googlesuper/create/label` — Creates a new label with a unique name in the specified user's gmail account.
  - body: { user_id?: string, label_name: string, text_color?: string, background_color?: string, label_list_visibility?: string, message_list_visibility?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/meet` — Creates a new google meet space, optionally configuring its access type and entry point access controls.
  - body: { access_type?: string, entry_point_access?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { name: string, documentId: string, rangeEndIndex: integer, rangeSegmentId?: string, rangeStartIndex: integer }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { document_id: string, createParagraphBullets: object }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { action?: string, fields?: string, content: string, file_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/create/shortcut/to/file` — 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.
  - body: { name: string, target_id: string, includeLabels?: string, target_mime_type?: string, supportsAllDrives?: boolean, keepRevisionForever?: boolean, ignoreDefaultVisibility?: boolean, includePermissionsForView?: string }
- `POST https://api.mcp.ai/api/googlesuper/create/spreadsheet/column` — Creates a new column in a google spreadsheet, requiring a valid `spreadsheet id` and an existing `sheet id`; an out-of-bounds `insert index` may append/prepend the column.
  - body: { sheet_id: integer, insert_index?: integer, spreadsheet_id: string, inherit_from_before?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { sheet_id: integer, insert_index?: integer, spreadsheet_id: string, inherit_from_before?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/create/task/list` — Creates a new task list with the specified title.
  - body: { tasklist_title: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/comment` — Deletes a comment from a file. use when you need to remove a specific comment from a google drive file.
  - body: { file_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/content/range` — Tool to delete a range of content from a google document. use when you need to remove a specific portion of text or other structural elements within a document.
  - body: { range: object, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/dimension` — 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.
  - body: { spreadsheet_id: string, response_ranges?: string[], delete_dimension_request: object, response_include_grid_data?: boolean, include_spreadsheet_in_response?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/delete/draft` — Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`.
  - body: { user_id?: string, draft_id: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/drive` — Tool to permanently delete a shared drive. use when you need to remove a shared drive and its contents (if specified).
  - body: { driveId: string, allowItemDeletion?: boolean, useDomainAdminAccess?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/delete/event` — Deletes a specified event by `event id` from a google calendar (`calendar id`); this action is idempotent and raises a 404 error if the event is not found.
  - body: { event_id: string, calendar_id?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { tab_id?: string, footer_id: string, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { tab_id?: string, header_id: string, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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
  - body: { user_id?: string, message_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { document_id: string, deleteNamedRange: object }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { range: object, tab_id?: string, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/permission` — Deletes a permission from a file by permission id. use when you need to revoke access for a specific user or group from a file.
  - body: { file_id: string, permission_id: string, supportsAllDrives?: boolean, useDomainAdminAccess?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/delete/reply` — Tool to delete a specific reply by reply id. use when you need to remove a reply from a comment on a file.
  - body: { file_id: string, reply_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { sheet_id: integer, spreadsheetId: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/table` — Tool to delete an entire table from a google document. use when you have the document id and the specific start and end index of the table element to be removed. the table's range can be found by insp
  - body: { tab_id?: string, segment_id?: string, document_id: string, table_end_index: integer, table_start_index: integer }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { requests: object[], document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { documentId: string, tableCellLocation: object }
- `POST https://api.mcp.ai/api/googlesuper/delete/task` — Deletes a specified task from a given task list in google tasks.
  - body: { task_id: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googlesuper/delete/task/list` — Permanently deletes an existing google task list, identified by `tasklist id`, along with all its tasks; this operation is irreversible.
  - body: { tasklist_id?: string }
- `POST https://api.mcp.ai/api/googlesuper/distance/matrix/api` — Calculates travel distance and time for a matrix of origins and destinations. supports different modes of transportation and options like departure/arrival times. use when needing to determine travel 
  - body: { key?: string, mode?: string, avoid?: string, units?: string, region?: string, origins: string, language?: string, arrival_time?: integer, destinations: string, transit_mode?: string, traffic_model?: string, departure_time?: integer, transit_routing_preference?: string }
- `POST https://api.mcp.ai/api/googlesuper/download/file` — Downloads a file from google drive by its id. for google workspace documents (docs, sheets, slides), optionally exports to a specified `mime type`. for other file types, downloads in their native form
  - body: { file_id: string, mime_type?: string }
- `POST https://api.mcp.ai/api/googlesuper/duplicate/calendar` — Creates a new, empty google calendar with the specified title (summary).
  - body: { summary?: string }
- `POST https://api.mcp.ai/api/googlesuper/edit/file` — Updates an existing google drive file by overwriting its entire content with new text (max 10mb).
  - body: { content: string, file_id: string, mime_type?: string }
- `POST https://api.mcp.ai/api/googlesuper/empty/trash` — Tool to permanently delete all of the user's trashed files. use when you want to empty the trash in google drive.
  - body: { driveId?: string, enforceSingleParent?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/events/instances` — Returns instances of the specified recurring event.
  - body: { eventId: string, timeMax?: string, timeMin?: string, timeZone?: string, pageToken?: string, calendarId: string, maxResults?: integer, showDeleted?: boolean, maxAttendees?: integer, originalStart?: string }
- `POST https://api.mcp.ai/api/googlesuper/events/list` — Returns events on the specified calendar.
  - body: { q?: string, iCalUID?: string, orderBy?: string, timeMax?: string, timeMin?: string, timeZone?: string, pageToken?: string, syncToken?: string, calendarId: string, eventTypes?: string, maxResults?: integer, updatedMin?: string, showDeleted?: boolean, maxAttendees?: integer, singleEvents?: boolean, alwaysIncludeEmail?: boolean, showHiddenInvitations?: boolean, sharedExtendedProperty?: string, privateExtendedProperty?: string }
- `POST https://api.mcp.ai/api/googlesuper/events/move` — Moves an event to another calendar, i.e., changes an event's organizer.
  - body: { event_id: string, calendar_id: string, destination: string, send_updates?: string }
- `POST https://api.mcp.ai/api/googlesuper/events/watch` — Watch for changes to events resources.
  - body: { id: string, type?: string, token?: string, params?: object, address: string, payload?: boolean, calendarId: string }
- `POST https://api.mcp.ai/api/googlesuper/execute/sql` — Execute sql queries against google sheets tables. supports select, insert, update, and delete operations with familiar sql syntax. tables are automatically detected and mapped from the spreadsheet str
  - body: { sql: string, dry_run?: boolean, delete_method?: string, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/fetch/emails` — Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.
  - body: { query?: string, user_id?: string, verbose?: boolean, ids_only?: boolean, label_ids?: string[], page_token?: string, max_results?: integer, include_payload?: boolean, include_spam_trash?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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`.
  - body: { format?: string, user_id?: string, message_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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`.
  - body: { user_id?: string, thread_id: string, page_token?: string }
- `POST https://api.mcp.ai/api/googlesuper/files/modify/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, upda
  - body: { kind?: string, file_id: string, label_modifications: object[] }
- `POST https://api.mcp.ai/api/googlesuper/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 pro
  - body: { query?: string, timeMax?: string, timeMin?: string, order_by?: string, page_token?: string, calendar_id?: string, event_types?: string[], max_results?: integer, updated_min?: string, show_deleted?: boolean, single_events?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/find/file` — Tool to list or search for files and folders in google drive. use when you need to find specific files based on query criteria or list contents of a drive/folder.
  - body: { q?: string, fields?: string, spaces?: string, corpora?: string, driveId?: string, orderBy?: string, pageSize?: integer, pageToken?: string, supportsAllDrives?: boolean, includeItemsFromAllDrives?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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 cont
  - body: { starred?: boolean, name_exact?: string, name_contains?: string, modified_after?: string, name_not_contains?: string, full_text_contains?: string, full_text_not_contains?: string }
- `POST https://api.mcp.ai/api/googlesuper/find/free/slots` — Finds both free and busy time slots in google calendars for specified calendars within a defined time range (defaults to the current day utc if `time min`/`time max` are omitted). returns busy interva
  - body: { items?: string[], time_max?: string, time_min?: string, timezone?: string, group_expansion_max?: integer, calendar_expansion_max?: integer }
- `POST https://api.mcp.ai/api/googlesuper/find/worksheet/by/title` — Finds a worksheet by its exact, case-sensitive title within a google spreadsheet; returns a boolean indicating if found and the complete metadata of the entire spreadsheet, regardless of whether the t
  - body: { title: string, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/format/cell` — Applies text and background cell formatting to a specified range in a google sheets worksheet.
  - body: { red?: number, blue?: number, bold?: boolean, green?: number, italic?: boolean, fontSize?: integer, underline?: boolean, worksheet_id: integer, end_row_index: integer, strikethrough?: boolean, spreadsheet_id: string, start_row_index: integer, end_column_index: integer, start_column_index: integer }
- `POST https://api.mcp.ai/api/googlesuper/forward/message` — Forward an existing gmail message to specified recipients, preserving original body and attachments.
  - body: { user_id?: string, message_id: string, additional_text?: string, recipient_email: string }
- `POST https://api.mcp.ai/api/googlesuper/free/busy/query` — Returns free/busy information for a set of calendars.
  - body: { items: object[], timeMax: string, timeMin: string, timeZone?: string, groupExpansionMax?: integer, calendarExpansionMax?: integer }
- `POST https://api.mcp.ai/api/googlesuper/generate/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.
  - body: { type?: string, count?: integer, space?: string }
- `POST https://api.mcp.ai/api/googlesuper/geocoding/api` — Deprecated: tool to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a place id. use for finding coordinates for an addr
  - body: { key: string, bounds?: string, latlng?: string, region?: string, address?: string, language?: string, place_id?: string, components?: string, result_type?: string, location_type?: string, extra_computations?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fields?: string }
- `POST https://api.mcp.ai/api/googlesuper/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).
  - body: { name: string }
- `POST https://api.mcp.ai/api/googlesuper/get/album` — Returns the album based on the specified albumid.
  - body: { albumId: string }
- `POST https://api.mcp.ai/api/googlesuper/get/attachment` — Retrieves a specific attachment by id from a message in a user's gmail mailbox, requiring valid message and attachment ids.
  - body: { user_id?: string, file_name: string, message_id: string, attachment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/calendar` — Retrieves a specific google calendar, identified by `calendar id`, to which the authenticated user has access.
  - body: { calendar_id?: string }
- `POST https://api.mcp.ai/api/googlesuper/get/campaign/by/id` — Getcampaignbyid tool will return details of a campaign in google ads.
  - body: { id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/campaign/by/name` — Getcampaignbyname tool will run a sql getcampaignbyname in google ads.
  - body: { name: string }
- `POST https://api.mcp.ai/api/googlesuper/get/changes/start/page/token` — Tool to get the starting pagetoken for listing future changes in google drive. use this when you need to track changes to files and folders.
  - body: { driveId?: string, teamDriveId?: string, supportsAllDrives?: boolean, supportsTeamDrives?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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 
  - body: { spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fileId: string, commentId: string, includeDeleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/conference/record/for/meet` — Get conference record
  - body: { end_time?: string, space_name?: string, start_time?: string, meeting_code?: string }
- `POST https://api.mcp.ai/api/googlesuper/get/contacts` — Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination.
  - body: { page_token?: string, person_fields?: string, resource_name?: string, include_other_contacts?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/current/date/time` — Gets the current date and time, allowing for a specific timezone offset.
  - body: { timezone?: number }
- `POST https://api.mcp.ai/api/googlesuper/get/customer/lists` — Getcustomerlists tool will list all customer lists in google ads.
- `POST https://api.mcp.ai/api/googlesuper/get/direction` — Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.
  - body: { mode?: string, avoid?: string, units?: string, origin: string, language?: string, waypoints?: string, destination: string }
- `POST https://api.mcp.ai/api/googlesuper/get/document/by/id` — Retrieves an existing google document by its id; will error if the document is not found.
  - body: { id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/drive` — Tool to get a shared drive by id. use when you need to retrieve information about a specific shared drive.
  - body: { drive_id: string, use_domain_admin_access?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/file/metadata` — Tool to get a file's metadata by id. use when you need to retrieve the metadata for a specific file in google drive.
  - body: { fileId: string, includeLabels?: string, acknowledgeAbuse?: boolean, supportsAllDrives?: boolean, includePermissionsForView?: string }
- `POST https://api.mcp.ai/api/googlesuper/get/media/item/download` — Downloads a media item from google photos and returns it as a file.
  - body: { mediaItemId: string }
- `POST https://api.mcp.ai/api/googlesuper/get/meet` — Retrieve details of a google meet space using its unique identifier.
  - body: { space_name: string }
- `POST https://api.mcp.ai/api/googlesuper/get/participant/session` — Tool to get a specific participant session from a conference record. use when you need to retrieve details about a particular participant in a past meeting.
  - body: { name: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { page_size?: integer, page_token?: string, sync_token?: string, person_fields?: string, resource_name?: string, other_contacts?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/permission` — Gets a permission by id. use this tool to retrieve a specific permission for a file or shared drive.
  - body: { file_id: string, permission_id: string, supports_all_drives?: boolean, use_domain_admin_access?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/profile` — Retrieves key gmail profile information (email address, message/thread totals, history id) for a user.
  - body: { user_id?: string }
- `POST https://api.mcp.ai/api/googlesuper/get/recordings/by/conference/record/id` — Retrieves recordings from google meet for a given conference record id.
  - body: { conferenceRecord_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fileId: string, replyId: string, commentId: string, includeDeleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/revision` — Tool to get a specific revision's metadata by revision id. use when you need to retrieve information about a particular version of a file.
  - body: { file_id: string, revision_id: string, acknowledge_abuse?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/route` — Calculates one or more routes between two specified locations using various travel modes and preferences; addresses must be resolvable by google maps.
  - body: { units?: string, fieldMask?: string, travelMode?: string, languageCode?: string, origin_address: string, routingPreference?: string, destination_address: string, computeAlternativeRoutes?: boolean, routeModifiers_avoidTolls?: boolean, routeModifiers_avoidFerries?: boolean, routeModifiers_avoidHighways?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/sheet/names` — Lists all worksheet names from a specified google spreadsheet (which must exist), useful for discovering sheets before further operations.
  - body: { spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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
  - body: { dataFilters: object[], spreadsheetId: string, includeGridData?: boolean, excludeTablesInBandedRanges?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/get/spreadsheet/info` — Retrieves comprehensive metadata for a google spreadsheet using its id, excluding cell data.
  - body: { spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/table/schema` — This action is used to get the schema of a table in a google spreadsheet, call this action to get the schema of a table in a spreadsheet before you query the table. analyze table structure and infer c
  - body: { sheet_name?: string, table_name: string, sample_size?: integer, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/task` — Use to retrieve a specific google task if its `task id` and parent `tasklist id` are known.
  - body: { task_id: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/task/list` — Retrieves a specific task list from the user's google tasks if the `tasklist id` exists for the authenticated user.
  - body: { tasklist_id: string }
- `POST https://api.mcp.ai/api/googlesuper/get/transcripts/by/conference/record/id` — Retrieves all transcripts for a specific google meet conference using its conferencerecord id.
  - body: { conferenceRecord_id: string }
- `POST https://api.mcp.ai/api/googlesuper/google/drive/delete/folder/or/file/action` — Tool to delete a file or folder in google drive. use when you need to permanently remove a specific file or folder using its id. note: this action is irreversible.
  - body: { fileId: string, supportsAllDrives?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/hide/drive` — Tool to hide a shared drive from the default view. use when you want to remove a shared drive from the user's main google drive interface without deleting it.
  - body: { drive_id: string }
- `POST https://api.mcp.ai/api/googlesuper/insert/dimension` — 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.
  - body: { spreadsheet_id: string, response_ranges?: string[], insert_dimension: object, response_include_grid_data?: boolean, include_spreadsheet_in_response?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { uri: string, location: object, documentId: string, objectSize?: object }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { documentId: string, insertPageBreak: object }
- `POST https://api.mcp.ai/api/googlesuper/insert/table/action` — Tool to insert a table into a google document. use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document.
  - body: { rows: integer, index?: integer, tabId?: string, columns: integer, segmentId?: string, documentId: string, insertAtEndOfSegment?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { requests: object[], document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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` 
  - body: { id?: string, due?: string, etag?: string, notes?: string, title: string, hidden?: boolean, status: string, deleted?: boolean, completed?: string, task_parent?: string, tasklist_id: string, task_previous?: string }
- `POST https://api.mcp.ai/api/googlesuper/insert/text/action` — 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.
  - body: { document_id: string, text_to_insert: string, insertion_index: integer }
- `POST https://api.mcp.ai/api/googlesuper/list/accounts` — Tool to list all accounts accessible by the caller. use when you need to enumerate all google analytics accounts your credentials can access.
  - body: { pageSize?: integer, pageToken?: string, showDeleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { page_token?: string, sync_token?: string, calendar_id: string, max_results?: integer, show_deleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/list/albums` — Lists all albums shown to a user in the albums tab of google photos.
  - body: { pageSize?: integer, pageToken?: string, excludeNonAppCreatedData?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/list/audiences` — Tool to list all audiences on a property. use when you need to fetch all audiences for a ga4 property after confirming its existence.
  - body: { parent: string, pageSize?: integer, pageToken?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/calendars` — Retrieves calendars from the user's google calendar list, with options for pagination and filtering.
  - body: { page_token?: string, sync_token?: string, max_results?: integer, show_hidden?: boolean, show_deleted?: boolean, min_access_role?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/changes` — Tool to list the changes for a user or shared drive. use when you need to track modifications to files and folders, such as creations, deletions, or permission changes. this action requires a `pagetok
  - body: { spaces?: string, driveId?: string, pageSize?: integer, pageToken: string, includeLabels?: string, includeRemoved?: boolean, restrictToMyDrive?: boolean, supportsAllDrives?: boolean, includeCorpusRemovals?: boolean, includeItemsFromAllDrives?: boolean, includePermissionsForView?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/comments` — Tool to list all comments for a file in google drive. use when you need to retrieve comments associated with a specific file.
  - body: { fields?: string, fileId: string, pageSize?: integer, pageToken?: string, includeDeleted?: boolean, startModifiedTime?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { filter?: string, page_size?: integer, page_token?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { user_id?: string, verbose?: boolean, page_token?: string, max_results?: integer }
- `POST https://api.mcp.ai/api/googlesuper/list/file/labels` — Tool to list the labels on a file. use when you need to retrieve all labels associated with a specific file in google drive.
  - body: { file_id: string, page_token?: string, max_results?: integer }
- `POST https://api.mcp.ai/api/googlesuper/list/files` — Tool to list a user's files and folders in google drive. use this to search or browse for files and folders based on various criteria.
  - body: { q?: string, fields?: string, spaces?: string, corpora?: string, driveId?: string, orderBy?: string, folderId?: string, pageSize?: integer, pageToken?: string, includeLabels?: string, supportsAllDrives?: boolean, includeItemsFromAllDrives?: boolean, includePermissionsForView?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/labels` — Retrieves a list of all system and user-created labels for the specified gmail account.
  - body: { user_id?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/media/items` — Lists all media items from a user's google photos library.
  - body: { pageSize?: integer, pageToken?: string }
- `POST https://api.mcp.ai/api/googlesuper/list/participant/sessions` — Tool to list all participant sessions for a specific conference record in google meet. use this when you need to retrieve a list of participants who joined a particular meeting.
  - body: { filter?: string, parent: string, page_size?: integer, page_token?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fileId: string, pageSize?: integer, pageToken?: string, supportsAllDrives?: boolean, useDomainAdminAccess?: boolean, includePermissionsForView?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fields?: string, file_id: string, page_size?: integer, comment_id: string, page_token?: string, include_deleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/list/revisions` — Tool to list a file's revisions. use when you need to retrieve the revision history of a specific file in google drive.
  - body: { fileId: string, pageSize?: integer, pageToken?: string, supportsAllDrives?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { q?: string, pageSize?: integer, pageToken?: string, useDomainAdminAccess?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/list/spreadsheet/charts/action` — Tool to retrieve a list of charts with their ids and metadata from a google sheets spreadsheet. use to identify charts available for embedding into google docs.
  - body: { fields_mask?: string, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/list/tables` — This action is used to list all tables in a google spreadsheet, call this action to get the list of tables in a spreadsheet. discover all tables in a google spreadsheet by analyzing sheet structure an
  - body: { min_rows?: integer, min_columns?: integer, min_confidence?: number, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/list/task/lists` — Fetches the authenticated user's task lists from google tasks; results may be paginated.
  - body: { pageToken?: string, maxResults?: integer }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { dueMax?: string, dueMin?: string, pageToken?: string, maxResults?: integer, showHidden?: boolean, updatedMin?: string, showDeleted?: boolean, tasklist_id: string, completedMax?: string, completedMin?: string, showCompleted?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/list/threads` — Retrieves a list of email threads from a gmail account, identified by `user id` (email address or 'me'), supporting filtering and pagination.
  - body: { query?: string, user_id?: string, verbose?: boolean, page_token?: string, max_results?: integer }
- `POST https://api.mcp.ai/api/googlesuper/lookup/spreadsheet/row` — Finds the first row in a google spreadsheet where a cell's entire content exactly matches the query string, searching within a specified a1 notation range or the first sheet by default.
  - body: { query: string, range?: string, case_sensitive?: boolean, spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/maps/embed/api` — 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.
  - body: { mode: string, view_params?: object, place_params?: object, search_params?: object, directions_params?: object, streetview_params?: object }
- `POST https://api.mcp.ai/api/googlesuper/modify/thread/labels` — Adds or removes specified existing label ids from a gmail thread, affecting all its messages; ensure the thread id is valid.
  - body: { user_id?: string, thread_id: string, add_label_ids?: string[], remove_label_ids?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/move/file` — Tool to move a file from one folder to another in google drive. use when you need to reorganize files by changing their parent folder(s).
  - body: { file_id: string, add_parents?: string, ocr_language?: string, include_labels?: string, remove_parents?: string, supports_all_drives?: boolean, keep_revision_forever?: boolean, include_permissions_for_view?: string, use_content_as_indexable_text?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/move/task` — Moves the specified task to another position in the destination task list.
  - body: { task: string, parent?: string, previous?: string, tasklist: string, destinationTasklist?: string }
- `POST https://api.mcp.ai/api/googlesuper/move/to/trash` — Moves an existing, non-deleted email message to the trash for the specified user.
  - body: { user_id?: string, message_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { radius: number, latitude: number, fieldMask?: string, longitude: number, excludedTypes?: string[], includedTypes?: string[], maxResultCount?: integer }
- `POST https://api.mcp.ai/api/googlesuper/parse/file` — Deprecated: exports google workspace files (max 10mb) to a specified format using `mime type`, or downloads other file types; use `googledrive download file` instead.
  - body: { file_id: string, mime_type?: string }
- `POST https://api.mcp.ai/api/googlesuper/patch/calendar` — Partially updates (patches) an existing google calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` c
  - body: { summary: string, location?: string, timezone?: string, calendar_id: string, description?: string }
- `POST https://api.mcp.ai/api/googlesuper/patch/event` — Updates 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 val
  - body: { summary?: string, end_time?: string, event_id: string, location?: string, timezone?: string, attendees?: string[], start_time?: string, calendar_id: string, description?: string, send_updates?: string, max_attendees?: integer, rsvp_response?: string, supports_attachments?: boolean, conference_data_version?: integer }
- `POST https://api.mcp.ai/api/googlesuper/patch/label` — Patches the specified label.
  - body: { id: string, name?: string, color?: object, userId: string, labelListVisibility?: string, messageListVisibility?: string }
- `POST https://api.mcp.ai/api/googlesuper/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`, `
  - body: { id?: string, due?: string, etag?: string, notes?: string, title: string, hidden?: boolean, status: string, deleted?: boolean, task_id: string, completed?: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googlesuper/patch/task/list` — Updates the title of an existing google tasks task list.
  - body: { tasklist_id: string, updated_title: string }
- `POST https://api.mcp.ai/api/googlesuper/query/table` — This action is used to query a table in a google spreadsheet, call this action to query a table in a spreadsheet. execute sql-like select queries against spreadsheet tables. supports where conditions,
  - body: { sql: string, spreadsheet_id: string, include_formulas?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/quick/add` — Parses natural language text to quickly create a basic google calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring even
  - body: { text?: string, calendar_id?: string, send_updates?: string }
- `POST https://api.mcp.ai/api/googlesuper/remove/attendee` — Removes an attendee from a specified event in a google calendar; the calendar and event must exist.
  - body: { event_id: string, calendar_id?: string, attendee_email: string }
- `POST https://api.mcp.ai/api/googlesuper/remove/label` — Permanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels.
  - body: { user_id?: string, label_id: string }
- `POST https://api.mcp.ai/api/googlesuper/replace/all/text` — 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.
  - body: { tab_ids?: string[], find_text: string, match_case: boolean, document_id: string, replace_text: string, search_by_regex?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/replace/image` — 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.
  - body: { document_id: string, replace_image: object }
- `POST https://api.mcp.ai/api/googlesuper/reply/to/thread` — Sends a reply within a specific gmail thread using the original thread's subject, requiring a valid `thread id` and correctly formatted email addresses. supports attachments via the `attachment` param
  - body: { cc?: string[], bcc?: string[], is_html?: boolean, user_id?: string, thread_id: string, attachment?: object, message_body: string, recipient_email: string, extra_recipients?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/search/developer/metadata` — Tool to search for developer metadata in a spreadsheet. use when you need to find specific metadata entries based on filters.
  - body: { dataFilters: object[], spreadsheetId: string }
- `POST https://api.mcp.ai/api/googlesuper/search/documents` — Search for google documents using various filters including name, content, date ranges, and more.
  - body: { query?: string, order_by?: string, max_results?: integer, starred_only?: boolean, created_after?: string, modified_after?: string, shared_with_me?: boolean, include_trashed?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/search/media/items` — Searches for media items in a user's google photos library.
  - body: { albumId?: string, filters?: object, orderBy?: string, pageSize?: integer, pageToken?: string }
- `POST https://api.mcp.ai/api/googlesuper/search/people` — Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'other contacts'.
  - body: { query: string, pageSize?: integer, person_fields?: string, other_contacts?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/search/spreadsheets` — Search for google spreadsheets using various filters including name, content, date ranges, and more.
  - body: { query?: string, order_by?: string, max_results?: integer, starred_only?: boolean, created_after?: string, modified_after?: string, shared_with_me?: boolean, include_trashed?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/send/draft` — Sends the specified, existing draft to the recipients in the to, cc, and bcc headers.
  - body: { user_id?: string, draft_id: string }
- `POST https://api.mcp.ai/api/googlesuper/send/email` — Sends an email via gmail api using the authenticated user's google profile display name, requiring `is html=true` if the body contains html and valid `s3key`, `mimetype`, `name` for any attachment.
  - body: { cc?: string[], bcc?: string[], body: string, is_html?: boolean, subject?: string, user_id?: string, attachment?: object, recipient_email: string, extra_recipients?: string[] }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { filter: object, spreadsheetId: string }
- `POST https://api.mcp.ai/api/googlesuper/settings/list` — Returns all user settings for the authenticated user.
  - body: { pageToken?: string, syncToken?: string, maxResults?: integer }
- `POST https://api.mcp.ai/api/googlesuper/settings/watch` — Watch for changes to settings resources.
  - body: { id: string, type: string, token?: string, params?: object, address: string }
- `POST https://api.mcp.ai/api/googlesuper/sheet/from/json` — Creates a new google spreadsheet and populates its first worksheet from `sheet json`, which must be non-empty as its first item's keys establish the headers.
  - body: { title: string, sheet_json: object[], sheet_name: string }
- `POST https://api.mcp.ai/api/googlesuper/spreadsheets/sheets/copy/to` — Tool to copy a single sheet from a spreadsheet to another spreadsheet. use when you need to duplicate a sheet into a different spreadsheet.
  - body: { sheet_id: integer, spreadsheet_id: string, destination_spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/spreadsheets/values/append` — Tool to append values to a spreadsheet. use when you need to add new data to the end of an existing table in a google sheet.
  - body: { range: string, values: array[], spreadsheetId: string, majorDimension?: string, insertDataOption?: string, valueInputOption: string, includeValuesInResponse?: boolean, responseValueRenderOption?: string, responseDateTimeRenderOption?: string }
- `POST https://api.mcp.ai/api/googlesuper/spreadsheets/values/batch/clear` — 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.
  - body: { ranges: string[], spreadsheet_id: string }
- `POST https://api.mcp.ai/api/googlesuper/spreadsheets/values/batch/clear/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 wil
  - body: { dataFilters: object[], spreadsheetId: string }
- `POST https://api.mcp.ai/api/googlesuper/spreadsheets/values/batch/get/by/data/filter` — Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. use when you need to retrieve specific data sets based on filtering criteria rather than entire sh
  - body: { dataFilters: object[], spreadsheetId: string, majorDimension?: string, valueRenderOption?: string, dateTimeRenderOption?: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { id: string, kind?: string, token?: string, params?: object, address?: string, payload?: boolean, expiration?: string, resourceId: string, channelType?: string, resourceUri?: string }
- `POST https://api.mcp.ai/api/googlesuper/sync/events` — Synchronizes google calendar events, performing a full sync if no `sync token` is provided or if a 410 gone error (due to an expired token) necessitates it, otherwise performs an incremental sync for 
  - body: { pageToken?: string, sync_token?: string, calendar_id?: string, event_types?: string[], max_results?: integer, single_events?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/text/search` — Searches for places on google maps using a textual query (e.g., "restaurants in london", "eiffel tower").
  - body: { fieldMask?: string, textQuery: string, maxResultCount?: integer }
- `POST https://api.mcp.ai/api/googlesuper/unhide/drive` — Tool to unhide a shared drive. use when you need to restore a shared drive to the default view.
  - body: { driveId: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { tableRange: object, document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { file_id: string, supportsAllDrives?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/update/acl/rule` — Updates an access control rule for the specified calendar.
  - body: { role: string, rule_id: string, calendar_id: string, send_notifications?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/update/album` — Updates an album's title or cover photo in google photos.
  - body: { title?: string, albumId: string, coverPhotoMediaItemId?: string }
- `POST https://api.mcp.ai/api/googlesuper/update/comment` — Tool to update an existing comment on a google drive file. use when you need to change the content or status (e.g., resolve) of a comment.
  - body: { fields?: string, content?: string, file_id: string, resolved?: boolean, comment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/update/document/markdown` — Replaces the entire content of an existing google docs document with new markdown text; requires edit permissions for the document.
  - body: { document_id: string, new_markdown_text: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fields: string, tab_id?: string, document_id: string, document_style: object }
- `POST https://api.mcp.ai/api/googlesuper/update/drive` — Tool to update the metadata for a shared drive. use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.
  - body: { name?: string, hidden?: boolean, driveId: string, themeId?: string, colorRgb?: string, restrictions?: object, backgroundImageFile?: object, useDomainAdminAccess?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/update/event` — Updates an existing event by `event id` in a google calendar; this is a full put replacement, so provide all desired fields as unspecified ones may be cleared or reset.
  - body: { summary?: string, event_id: string, location?: string, timezone?: string, attendees?: string[], eventType?: string, recurrence?: string[], visibility?: string, calendar_id?: string, description?: string, send_updates?: boolean, transparency?: string, start_datetime: string, guests_can_modify?: boolean, create_meeting_room?: boolean, event_duration_hour?: integer, guestsCanInviteOthers?: boolean, event_duration_minutes?: integer, guestsCanSeeOtherGuests?: boolean, workingLocationProperties?: object }
- `POST https://api.mcp.ai/api/googlesuper/update/existing/document` — Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified google doc using the `batchupdate` api method.
  - body: { editDocs: object[], document_id: string }
- `POST https://api.mcp.ai/api/googlesuper/update/file/put` — Updates file metadata. uses patch semantics (partial update) as per google drive api v3. use this tool to modify attributes of an existing file like its name, description, or parent folders. note: thi
  - body: { name?: string, file_id: string, starred?: boolean, mime_type?: string, add_parents?: string, description?: string, ocr_language?: string, remove_parents?: string, writers_can_share?: boolean, supports_all_drives?: boolean, keep_revision_forever?: boolean, use_domain_admin_access?: boolean, viewers_can_copy_content?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/update/file/revision/metadata` — Updates metadata of a file revision (e.g., keepforever, publish). use this tool to modify the metadata of a specific revision of a file in google drive.
  - body: { file_id: string, published?: boolean, publishAuto?: boolean, revision_id: string, keep_forever?: boolean, publishedOutsideDomain?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/update/media/item` — Updates a media item's description in google photos.
  - body: { description?: string, mediaItemId: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fileId: string, permission: object, permissionId: string, removeExpiration?: boolean, supportsAllDrives?: boolean, transferOwnership?: boolean, useDomainAdminAccess?: boolean, enforceExpansiveAccess?: boolean }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { fields: string, content: string, file_id: string, reply_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/googlesuper/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 appe
  - body: { spreadsheetId: string, updateSheetProperties: object }
- `POST https://api.mcp.ai/api/googlesuper/update/space` — Updates a meeting space. use this tool to modify the settings of an existing google meet space. requires the space resource in the request body and the space name in the path.
  - body: { name: string, config?: object, updateMask?: string }
- `POST https://api.mcp.ai/api/googlesuper/update/spreadsheet/properties` — Tool to update properties of a spreadsheet, such as its title, locale, or auto-recalculation settings. use when you need to modify the overall configuration of a google sheet.
  - body: { fields: string, properties: object, spreadsheetId: string }
- `POST https://api.mcp.ai/api/googlesuper/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.
  - body: { documentId: string, updateTableRowStyle: object }
- `POST https://api.mcp.ai/api/googlesuper/update/task` — Updates the specified task.
  - body: { due?: string, task: string, notes?: string, title?: string, status?: string, tasklist: string }
- `POST https://api.mcp.ai/api/googlesuper/update/task/list` — Updates the authenticated user's specified task list.
  - body: { title: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googlesuper/upload/file` — Uploads a file (max 5mb) to google drive, moving it to a specified folder if a valid folder id is provided, otherwise uploads to root.
  - body: { file_to_upload: object, folder_to_upload_to?: string }
- `POST https://api.mcp.ai/api/googlesuper/upload/media` — Upload a media file to google photos. supports images (up to 200mb) and videos (up to 20gb).
  - body: { description?: string, file_to_upload: object }
- `POST https://api.mcp.ai/api/googlesuper/watch/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.
  - body: { id: string, type: string, token?: string, params?: object, spaces?: string, address: string, drive_id?: string, page_size?: integer, expiration?: integer, page_token?: string, include_labels?: string, include_removed?: boolean, supports_all_drives?: boolean, restrict_to_my_drive?: boolean, include_corpus_removals?: boolean, include_permissions_for_view?: string, include_items_from_all_drives?: boolean }

## More
- Page: https://mcp.ai/googlesuper
- Agent spec (llms.txt): https://mcp.ai/googlesuper/llms.txt
- Postman collection: https://mcp.ai/googlesuper/postman.json