mcp-google-multi 6.0.0-alpha.76 → 6.0.0-alpha.78

package/skills/google-workspace/reference/gmail.md

@@ -0,0 +1,305 @@
+# gmail
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+23 curated tools, plus 57 generated tools (Google Discovery parameter names; see `gmail_discover`).
+
+## `gmail_batch_delete`
+
+Class: delete
+
+Permanently delete multiple Gmail messages. Irreversible.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageIds` | array | required | Message IDs (up to 1000) |
+
+## `gmail_batch_modify`
+
+Class: update
+
+Add/remove labels across up to 1000 Gmail messages at once. Useful for bulk archiving, marking as read, etc.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageIds` | array | required | Message IDs (up to 1000) |
+| `addLabelIds` | array | optional | Label IDs to add |
+| `removeLabelIds` | array | optional | Label IDs to remove |
+
+## `gmail_create_draft`
+
+Class: create
+
+Create a Gmail draft without sending
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `to` | string | optional | Recipient(s), comma-separated. Optional when replyToMessageId is set (derived from the source); a supplied value wins. |
+| `subject` | string | optional | Email subject. Optional when replyToMessageId is set (derived as "Re: ..."); a supplied value wins. |
+| `body` | string | required | Email body as Markdown (headings, links, lists, tables, blockquotes). Rendered to HTML for the rich part; the Markdown source is the plain-text part. |
+| `htmlBody` | string | optional | REMOVED in v6: author Markdown in `body` instead; for literal HTML (e.g. inline color) pass `allowRawHtml: true`. Passing htmlBody now errors. |
+| `allowRawHtml` | boolean | optional | When true, raw HTML in `body` passes through into the HTML part instead of being escaped. Default false (HTML is shown literally). |
+| `cc` | string | optional | CC recipients, comma-separated. With replyToMessageId + replyAll, derived from the source minus your own addresses; a supplied value wins. |
+| `replyToMessageId` | string | optional | Message ID to reply to. Sets In-Reply-To/References and, unless overridden, derives to/subject (and cc when replyAll) from the source, so you need not read it first. |
+| `replyAll` | boolean | optional | With replyToMessageId: include the source To+Cc (minus your own addresses) in cc. Default false (reply to sender only). |
+| `replyToThreadId` | string | optional | Thread ID to associate the draft with |
+| `attachments` | array | optional | Files to attach (each { path, filename?, contentType? }); path must be absolute |
+
+## `gmail_create_label`
+
+Class: create
+
+Create a new custom Gmail label
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `name` | string | required | Label name, e.g. "Work/Projects" (nested labels use "/") |
+| `messageListVisibility` | enum | optional | Whether messages with this label show in message list (default: show) |
+| `labelListVisibility` | enum | optional | Whether the label appears in the label list (default: labelShow) |
+
+## `gmail_delete`
+
+Class: delete
+
+Permanently and irreversibly delete a Gmail message. No recovery possible.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageId` | string | required | Gmail message ID |
+
+## `gmail_delete_draft`
+
+Class: delete
+
+Permanently delete a Gmail draft by its draft ID
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `draftId` | string | required | Draft ID to delete |
+
+## `gmail_delete_label`
+
+Class: delete
+
+Permanently delete a Gmail label and remove it from all messages
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `labelId` | string | required | Label ID to delete |
+
+## `gmail_download_attachment`
+
+Class: read
+
+Download an email attachment to local disk. Use gmail_read first to get the attachmentId.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageId` | string | required | The Gmail message ID |
+| `attachmentId` | string | required | The attachment ID from gmail_read response |
+| `filename` | string | required | Filename to save as (e.g. report.xlsx) |
+| `savePath` | string | required | Absolute DIRECTORY path to save into (created if missing, on the machine running the server), e.g. /home/user/Downloads; the file name comes from `filename` |
+
+## `gmail_get_draft`
+
+Class: read
+
+Read the full content of a specific Gmail draft
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `draftId` | string | required | Draft ID |
+
+## `gmail_get_profile`
+
+Class: read
+
+Get Gmail account profile: email address, total messages, total threads, and current history ID
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+
+## `gmail_get_vacation`
+
+Class: read
+
+Read current Gmail vacation responder settings
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+
+## `gmail_list_drafts`
+
+Class: read
+
+List all drafts in a Gmail mailbox
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `maxResults` | number | optional | Max results to return (default: 20) |
+| `query` | string | optional | Gmail search syntax to filter drafts |
+
+## `gmail_list_history`
+
+Class: read
+
+Get all mailbox changes since a given historyId. Useful for detecting new emails since last check.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `startHistoryId` | string | required | History ID from a previous gmail_get_profile or gmail_read response |
+| `maxResults` | number | optional | Max results to return (default: 100) |
+| `historyTypes` | array | optional | Filter by history event types |
+
+## `gmail_list_labels`
+
+Class: read
+
+List all Gmail labels (system and user-defined). Use to get label IDs for gmail_modify_labels.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+
+## `gmail_modify_labels`
+
+Class: update
+
+Add or remove labels on a Gmail message. Use system label IDs like STARRED, UNREAD, INBOX, TRASH, or custom label IDs from gmail_list_labels.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageId` | string | required | Gmail message ID |
+| `addLabelIds` | array | optional | Label IDs to add |
+| `removeLabelIds` | array | optional | Label IDs to remove |
+
+## `gmail_read`
+
+Class: read
+
+Read a full Gmail message by ID (body capped at 50k chars unless full=true). Pass `headers` for metadata mode: no body decoding, just id, threadId, labelIds and the named headers.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `messageId` | string | required | Gmail message ID |
+| `full` | boolean | optional | Return the entire body without the character cap |
+| `rawHtml` | boolean | optional | Return the HTML body unconverted instead of the plain-text rendering (HTML-only messages) |
+| `headers` | array | optional | Header names to fetch in metadata mode instead of the full body (e.g. ["Subject", "From"]) |
+
+## `gmail_read_batch`
+
+Class: read
+
+Read many Gmail messages by ID in one call, collapsing the search→read triage loop. Bodies are capped at 50k chars each (unless full=true) and the aggregate output is bounded. Returns one ordered entry per id plus a trailing counts summary; a single failed id does NOT fail the batch. Pass `headers` for metadata mode: no body decoding, just id, threadId, labelIds and the named headers per entry.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `ids` | array | required | Gmail message IDs to read (1..100). Comma-separated string or JSON array. |
+| `full` | boolean | optional | Return entire bodies without the per-message 50k character cap |
+| `rawHtml` | boolean | optional | Return HTML bodies unconverted instead of the plain-text rendering (HTML-only messages) |
+| `headers` | array | optional | Header names to fetch in metadata mode instead of full bodies (e.g. ["Subject", "From"]) |
+
+## `gmail_read_thread`
+
+Class: read
+
+Read all messages in a Gmail thread (bodies capped at 50k chars each unless full=true). mode=summary returns headers + snippets only.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `threadId` | string | required | Gmail thread ID |
+| `full` | boolean | optional | Return entire bodies without the character cap |
+| `rawHtml` | boolean | optional | Return HTML bodies unconverted instead of the plain-text rendering (HTML-only messages) |
+| `mode` | enum | optional | full = complete bodies; summary = per-message headers and snippet only |
+
+## `gmail_search`
+
+Class: read
+
+Search messages in a Gmail account. Returns compact rows (id, from, subject, date, snippet); pass full=true for threadId, to, labelIds and the untruncated snippet. For a recurring "what is new" sweep, prefer gmail_list_history over polling this with since.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `query` | string | required | Gmail search syntax, e.g. "from:alice is:unread" |
+| `maxResults` | number | optional | Max results to return (default: 20, max: 100) |
+| `full` | boolean | optional | Return the full row shape instead of the compact default |
+| `since` | string | optional | Only messages on/after this ISO 8601 date (00:00 UTC) or date-time with Z or offset, added to the query as after:<epoch seconds> |
+| `until` | string | optional | Only messages before this ISO 8601 date (00:00 UTC) or date-time with Z or offset, added to the query as before:<epoch seconds> |
+| `includeSpamTrash` | boolean | optional | Include Spam and Trash in the search. Gmail excludes both by default, even for in:anywhere. |
+
+## `gmail_send`
+
+Class: create
+
+Send an email from a Gmail account
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `to` | string | optional | Recipient(s), comma-separated. Optional when replyToMessageId is set (derived from the source); a supplied value wins. |
+| `subject` | string | optional | Email subject. Optional when replyToMessageId is set (derived as "Re: ..."); a supplied value wins. |
+| `body` | string | required | Email body as Markdown (headings, links, lists, tables, blockquotes). Rendered to HTML for the rich part; the Markdown source is the plain-text part. |
+| `htmlBody` | string | optional | REMOVED in v6: author Markdown in `body` instead; for literal HTML (e.g. inline color) pass `allowRawHtml: true`. Passing htmlBody now errors. |
+| `allowRawHtml` | boolean | optional | When true, raw HTML in `body` passes through into the HTML part instead of being escaped. Default false (HTML is shown literally). |
+| `cc` | string | optional | CC recipients, comma-separated. With replyToMessageId + replyAll, derived from the source minus your own addresses; a supplied value wins. |
+| `replyToMessageId` | string | optional | Message ID to reply to. Sets In-Reply-To/References and, unless overridden, derives to/subject (and cc when replyAll) from the source, so you need not read it first. |
+| `replyAll` | boolean | optional | With replyToMessageId: include the source To+Cc (minus your own addresses) in cc. Default false (reply to sender only). |
+| `replyToThreadId` | string | optional | Thread ID to send the message in |
+| `attachments` | array | optional | Files to attach (each { path, filename?, contentType? }); path must be absolute |
+
+## `gmail_send_draft`
+
+Class: create
+
+Send an existing Gmail draft by its draft ID
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `draftId` | string | required | Draft ID to send |
+
+## `gmail_set_vacation`
+
+Class: update
+
+Enable or disable Gmail vacation responder with a custom message
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `enableAutoReply` | boolean | required | Whether to enable the vacation responder |
+| `responseSubject` | string | optional | Subject line for auto-reply |
+| `responseBodyPlainText` | string | optional | Plain text body for auto-reply |
+| `startTime` | string | optional | Start time as Unix timestamp in ms |
+| `endTime` | string | optional | End time as Unix timestamp in ms |
+| `restrictToContacts` | boolean | optional | Only reply to contacts (default: false) |
+| `restrictToDomain` | boolean | optional | Only reply to same domain (default: false) |
+
+## `gmail_trash`
+
+Class: delete
+
+Move a Gmail message to Trash (recoverable)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `messageId` | string | required | Gmail message ID |

package/skills/google-workspace/reference/groupsmigration.md

@@ -0,0 +1,5 @@
+# groupsmigration
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 1 `groupsmigration` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `groupsmigration_discover` lists each one with its arguments.

package/skills/google-workspace/reference/groupssettings.md

@@ -0,0 +1,5 @@
+# groupssettings
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 3 `groupssettings` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `groupssettings_discover` lists each one with its arguments.

package/skills/google-workspace/reference/keep.md

@@ -0,0 +1,5 @@
+# keep
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 7 `keep` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `keep_discover` lists each one with its arguments.

package/skills/google-workspace/reference/licensing.md

@@ -0,0 +1,5 @@
+# licensing
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 7 `licensing` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `licensing_discover` lists each one with its arguments.

package/skills/google-workspace/reference/meet.md

@@ -0,0 +1,68 @@
+# meet
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+5 curated tools, plus 13 generated tools (Google Discovery parameter names; see `meet_discover`).
+
+## `meet_conference_record_get`
+
+Class: read
+
+Get a single conference record by resource name (e.g. conferenceRecords/abc123)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `name` | string | required | Resource name, format: conferenceRecords/{conference_record} |
+
+## `meet_conference_records_list`
+
+Class: read
+
+List past conference records (completed Meet sessions) the user has access to
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+| `filter` | string | optional | Filter expression, e.g. "space.meeting_code=abc-defg-hij" |
+
+## `meet_recordings_list`
+
+Class: read
+
+List recordings within a conference record. Returns Drive file IDs that can be downloaded via drive_download.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `parent` | string | required | Parent conference record, format: conferenceRecords/{id} |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+
+## `meet_transcript_entries_list`
+
+Class: read
+
+List entries (per-speaker text segments) within a transcript. The actual transcript content.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `parent` | string | required | Parent transcript, format: conferenceRecords/{id}/transcripts/{id} |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+
+## `meet_transcripts_list`
+
+Class: read
+
+List transcripts within a conference record
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `parent` | string | required | Parent conference record, format: conferenceRecords/{id} |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |

package/skills/google-workspace/reference/postmaster.md

@@ -0,0 +1,5 @@
+# postmaster
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 4 `postmaster` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `postmaster_discover` lists each one with its arguments.

package/skills/google-workspace/reference/reseller.md

@@ -0,0 +1,5 @@
+# reseller
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 17 `reseller` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `reseller_discover` lists each one with its arguments.

package/skills/google-workspace/reference/script.md

@@ -0,0 +1,5 @@
+# script
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+This service has no curated tools. All 16 `script` tools are generated from Google's API Discovery document: they take Google's own Discovery parameter names (not a hand-written schema), and `script_discover` lists each one with its arguments.

package/skills/google-workspace/reference/searchconsole.md

@@ -0,0 +1,128 @@
+# searchconsole
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+10 curated tools, plus 1 generated tool (Google Discovery parameter names; see `searchconsole_discover`).
+
+## `searchconsole_searchanalytics_query`
+
+Class: read
+
+Query Google Search Console search analytics data. Returns clicks, impressions, CTR, and position for your site. Supports filtering by query, page, country, device, search type, and date range.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `siteUrl` | string | required | Site URL (e.g. "https://example.com/" or "sc-domain:example.com") |
+| `startDate` | string | required | Start date (YYYY-MM-DD). Data is available starting ~3 days ago. |
+| `endDate` | string | required | End date (YYYY-MM-DD) |
+| `dimensions` | array | optional | Dimensions to group by. Common: ["query", "page"], ["date"], ["query", "date"] |
+| `type` | enum | optional | Search type filter (default: web) |
+| `dimensionFilterGroups` | array | optional | Filters to narrow results. Example: filter by page containing "/blog/" or query containing "keyword" |
+| `rowLimit` | number | optional | Max rows to return (default: 1000, max: 25000) |
+| `startRow` | number | optional | Zero-based row offset for pagination (default: 0) |
+| `aggregationType` | enum | optional | How to aggregate data (default: auto) |
+| `dataState` | enum | optional | "all" includes fresh (not finalized) data; "final" only finalized data |
+
+## `searchconsole_sitemaps_delete`
+
+Class: delete
+
+Delete a sitemap from Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `siteUrl` | string | required | Site URL |
+| `feedpath` | string | required | Full URL of the sitemap to delete |
+
+## `searchconsole_sitemaps_get`
+
+Class: read
+
+Get details for a specific sitemap submitted to Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `siteUrl` | string | required | Site URL |
+| `feedpath` | string | required | Full URL of the sitemap (e.g. "https://example.com/sitemap.xml") |
+
+## `searchconsole_sitemaps_list`
+
+Class: read
+
+List all sitemaps submitted for a site in Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `siteUrl` | string | required | Site URL (e.g. "https://example.com/" or "sc-domain:example.com") |
+
+## `searchconsole_sitemaps_submit`
+
+Class: create
+
+Submit a sitemap to Google Search Console for a site
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `siteUrl` | string | required | Site URL |
+| `feedpath` | string | required | Full URL of the sitemap to submit (e.g. "https://example.com/sitemap.xml") |
+
+## `searchconsole_sites_add`
+
+Class: create
+
+Add a site (property) to Google Search Console. You still need to verify ownership separately.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `siteUrl` | string | required | Site URL to add (e.g. "https://example.com/" or "sc-domain:example.com") |
+
+## `searchconsole_sites_delete`
+
+Class: delete
+
+Remove a site (property) from Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `siteUrl` | string | required | Site URL to remove |
+
+## `searchconsole_sites_get`
+
+Class: read
+
+Get details for a specific site (property) in Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `siteUrl` | string | required | Site URL exactly as it appears in Search Console (e.g. "https://example.com/" or "sc-domain:example.com") |
+
+## `searchconsole_sites_list`
+
+Class: read
+
+List all sites (properties) the account has access to in Google Search Console
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+
+## `searchconsole_url_inspect`
+
+Class: read
+
+Inspect a URL using the Google Search Console URL Inspection API. Returns indexing status, crawl info, rich results, AMP status, and mobile usability for a specific URL.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `siteUrl` | string | required | Site URL as registered in Search Console (e.g. "https://example.com/" or "sc-domain:example.com") |
+| `inspectionUrl` | string | required | The fully-qualified URL to inspect (must be under the siteUrl property) |
+| `languageCode` | string | optional | BCP-47 language code for localized results (e.g. "en-US", "fr") |