mcp-google-multi 6.0.0-beta.4 → 6.0.0

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

@@ -0,0 +1,485 @@
+# drive
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+36 curated tools, plus 35 generated tools (Google Discovery parameter names; see `drive_discover`).
+
+## `drive_access_proposal_list`
+
+Class: read
+
+List pending "Request access" proposals on a file. Useful for programmatic triage of share requests from external collaborators.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+
+## `drive_access_proposal_resolve`
+
+Class: update
+
+Resolve a pending access proposal. Action ACCEPT requires a role array (e.g. ["reader"]).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `proposalId` | string | required | Access proposal ID |
+| `action` | enum | required | Whether to accept or deny the proposal |
+| `role` | array | optional | Required when action is ACCEPT |
+| `view` | string | optional | Optional view, e.g. "published" |
+| `sendNotification` | boolean | optional | Email the requester about the resolution |
+
+## `drive_comment_create`
+
+Class: create
+
+Create a comment on a Drive file. Works on Docs, Sheets, Slides, PDFs, and any Drive file. The optional anchor is a JSON string describing the document region (see Drive "Manage comments" guide).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `content` | string | required | Plain text comment content |
+| `anchor` | string | optional | Region anchor (JSON string). Optional. |
+| `quotedFileContent` | object | optional | Optional reference to quoted file content |
+
+## `drive_comment_delete`
+
+Class: delete
+
+Delete a comment from a Drive file
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Comment ID |
+
+## `drive_comment_get`
+
+Class: read
+
+Get a single comment by ID
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Comment ID |
+| `includeDeleted` | boolean | optional |  |
+
+## `drive_comment_list`
+
+Class: read
+
+List comments on a Drive file with pagination
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `includeDeleted` | boolean | optional | Include deleted comments (default: false) |
+| `pageSize` | number | optional | Max comments per page (default: 20) |
+| `pageToken` | string | optional | Token from a previous page |
+| `startModifiedTime` | string | optional | Only return comments modified after this RFC 3339 timestamp |
+
+## `drive_comment_update`
+
+Class: update
+
+Edit the content of an existing comment (PATCH semantics)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Comment ID |
+| `content` | string | required | New plain text content |
+
+## `drive_copy`
+
+Class: create
+
+Duplicate a file in Google Drive (does not work on folders)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID to copy |
+| `newName` | string | optional | Name for the copy (default: "Copy of <original>") |
+| `parentFolderId` | string | optional | Where to put the copy, not parentId. Default: same folder |
+
+## `drive_create_folder`
+
+Class: create
+
+Create a new folder in Google Drive
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `name` | string | required | Folder name |
+| `parentFolderId` | string | optional | Parent folder ID, not parentId. Defaults to My Drive root |
+
+## `drive_delete`
+
+Class: delete
+
+Permanently delete a file or folder from Google Drive. Irreversible. Use drive_trash for recoverable deletion.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+
+## `drive_download`
+
+Class: read
+
+Download a binary file from Drive to local disk. For Google Workspace formats (Docs, Sheets, Slides), use drive_export instead.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `savePath` | string | required | Absolute DIRECTORY path to save into (created if missing, on the machine running the server); the file name comes from `filename` |
+| `filename` | string | optional | Filename to save as (defaults to the file name in Drive) |
+
+## `drive_empty_trash`
+
+Class: delete
+
+Permanently delete every file currently in the account's trash. Irreversible.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+
+## `drive_export`
+
+Class: read
+
+Export a Google Workspace document (Doc, Sheet, Slide) to a standard format and save to disk. Supported: PDF, DOCX, XLSX, PPTX, TXT, CSV, Markdown (text/markdown for Docs).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `mimeType` | string | required | Target export MIME type (e.g. "application/pdf", "text/markdown", "application/vnd.openxmlformats-officedocument.wordprocessingml.document") |
+| `savePath` | string | required | Absolute DIRECTORY path to save into (created if missing, on the machine running the server); the file name comes from `filename` |
+| `filename` | string | optional | Filename to save as (defaults to the Drive name plus the extension implied by mimeType) |
+
+## `drive_get_about`
+
+Class: read
+
+Get Drive storage quota, user display name, and email for an account
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+
+## `drive_list`
+
+Class: read
+
+List files in a Google Drive folder or root
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `folderId` | string | optional | Folder ID to list, omit for root. Named folderId here, not parentFolderId |
+| `maxResults` | number | optional | Max results to return (default: 50) |
+| `pageToken` | string | optional | Continuation token from a previous call's nextPageToken |
+
+## `drive_list_permissions`
+
+Class: read
+
+List all people and groups who have access to a Drive file or folder
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+
+## `drive_move`
+
+Class: update
+
+Move a file between folders by replacing its parents. To move to multiple parents, list all of them.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `newParentFolderId` | string | required | Destination folder ID, named newParentFolderId here, not parentFolderId |
+
+## `drive_permission_update`
+
+Class: update
+
+Change the role and/or expirationTime of an existing permission without removing it. Use "removeExpiration=true" to clear an existing expirationTime.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `permissionId` | string | required | Permission ID from drive_list_permissions |
+| `role` | enum | optional | New role |
+| `expirationTime` | string | optional | New RFC 3339 expiration timestamp. Only valid for role "reader" or "commenter". |
+| `removeExpiration` | boolean | optional | Clear the existing expirationTime |
+| `transferOwnership` | boolean | optional | Promote to owner. Requires role="owner". |
+
+## `drive_read`
+
+Class: read
+
+Read the content of a Google Drive file: Workspace docs and textual types (text/*, JSON/XML/SVG and similar) inline; other binaries return error:binary (returns up to maxChars characters per call; non-Google-native files over 2MB return too_large)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `maxChars` | number | optional | Max characters of content to return (default: 100000) |
+| `offset` | number | optional | Character offset to continue a truncated read (Google Docs/Sheets/Slides exports page fine; plain files >2MB are rejected, not paged) |
+
+## `drive_remove_permission`
+
+Class: delete
+
+Revoke access to a Drive file for a specific permission
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `permissionId` | string | required | Permission ID from drive_list_permissions |
+
+## `drive_reply_create`
+
+Class: create
+
+Reply to a comment. Optionally close or reopen the thread by setting action to "resolve" or "reopen".
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Parent comment ID |
+| `content` | string | required | Reply content (required even when only changing action) |
+| `action` | enum | optional | Optional action to apply to the thread on this reply |
+
+## `drive_reply_delete`
+
+Class: delete
+
+Delete a reply from a comment thread
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Parent comment ID |
+| `replyId` | string | required | Reply ID |
+
+## `drive_reply_list`
+
+Class: read
+
+List replies on a comment with pagination
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Parent comment ID |
+| `includeDeleted` | boolean | optional |  |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+
+## `drive_reply_update`
+
+Class: update
+
+Edit the content of an existing reply
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `commentId` | string | required | Parent comment ID |
+| `replyId` | string | required | Reply ID |
+| `content` | string | required | New plain text content |
+
+## `drive_revision_delete`
+
+Class: delete
+
+Delete a specific revision of a file
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `revisionId` | string | required | Revision ID |
+
+## `drive_revision_list`
+
+Class: read
+
+List version history of a Drive file
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `fileId` | string | required | Google Drive file ID |
+| `pageSize` | number | optional |  |
+| `pageToken` | string | optional |  |
+
+## `drive_revision_update`
+
+Class: update
+
+Pin a revision (keepForever=true) against the 200-version cap, or change its published state for Docs.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `revisionId` | string | required | Revision ID |
+| `keepForever` | boolean | optional | Pin this revision indefinitely |
+| `published` | boolean | optional | Toggle published state (Docs only) |
+| `publishAuto` | boolean | optional | Auto-publish subsequent revisions |
+| `publishedOutsideDomain` | boolean | optional | Allow publish outside domain |
+
+## `drive_search`
+
+Class: read
+
+Search files in a Google Drive account. A plain keyword is treated as a full-text search; pass Drive query syntax for a structured search.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `query` | string | required | A plain keyword (full-text search) or Drive query syntax, e.g. "name contains 'MoU'" |
+| `maxResults` | number | optional | Max results to return (default: 10, max: 100) |
+| `driveId` | string | optional | Optional shared drive ID |
+| `pageToken` | string | optional | Continuation token from a previous call's nextPageToken |
+| `orderBy` | string | optional | Sort key(s) for files.list, e.g. "modifiedTime desc" or "folder,name". Default: Drive's relevance ranking for the query, an arbitrary stable order otherwise. |
+
+## `drive_share`
+
+Class: create
+
+Share a file or folder with a user, group, domain, or anyone with the link
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `type` | enum | required | Permission type |
+| `role` | enum | required | Permission role |
+| `emailAddress` | string | optional | Required when type is "user" or "group" |
+| `domain` | string | optional | Required when type is "domain" |
+| `sendNotification` | boolean | optional | Send notification email (default: true) |
+| `emailMessage` | string | optional | Custom message in notification email |
+| `transferOwnership` | boolean | optional | Transfer ownership to the recipient. Requires role="owner". Recipient must accept ownership. |
+| `expirationTime` | string | optional | RFC 3339 timestamp when access expires. Only valid for role="reader" or "commenter". |
+
+## `drive_shared_drive_get`
+
+Class: read
+
+Get metadata for a specific shared drive
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `driveId` | string | required | Shared drive ID |
+
+## `drive_shared_drives_list`
+
+Class: read
+
+List shared drives the account 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 |  |
+| `q` | string | optional | Optional filter expression |
+
+## `drive_transfer`
+
+Class: create
+
+Copy or move a file from one configured account to another (server-side share+copy, with a download+upload fallback). The copy is owned by the target account with a clean name (no "Copy of"); the temporary share on the source is revoked afterwards. Comments, revision history, and permissions do not transfer. move=true trashes the source after a successful copy and requires deletes to be allowed by write-control.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `fromAccount` | string | required | Source account alias |
+| `toAccount` | string | required | Target account alias |
+| `fileId` | string | required | File ID in the source account (folders are not supported) |
+| `parentFolderId` | string | optional | Target folder ID, not parentId. Default: target My Drive root |
+| `newName` | string | optional | Rename the copy (default: keep the source name) |
+| `move` | boolean | optional | Trash the source after a successful copy (delete-gated) |
+
+## `drive_trash`
+
+Class: delete
+
+Move a file to Google Drive trash. Recoverable from Drive UI or via drive_untrash.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+
+## `drive_untrash`
+
+Class: update
+
+Restore a trashed file from Google Drive trash back to its previous location.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+
+## `drive_update`
+
+Class: update
+
+Rename, move, or replace content of a Drive file. Any combination in one call. For untrash, use drive_untrash.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `fileId` | string | required | Google Drive file ID |
+| `newName` | string | optional | New filename |
+| `newParentFolderId` | string | optional | Move to this folder, named newParentFolderId here, not parentFolderId |
+| `localPath` | string | optional | Replace file content with this local file (path on the machine running the server) |
+| `mimeType` | string | optional | MIME type of the replacement file (required if localPath is provided) |
+| `convertTo` | enum | optional | When replacing content via localPath, convert the new content into this native Google Workspace type on import: "document" \| "spreadsheet" \| "presentation" \| "drawing" (full application/vnd.google-apps.* ids also accepted). |
+
+## `drive_upload`
+
+Class: create
+
+Upload a file to Google Drive, from inline base64 content or (when this server exposes the host filesystem) a local path. Pass `convertTo` to import it as a native, editable Google Doc/Sheet/Slides/Drawing instead of storing the raw bytes.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `filename` | string | required | Name as it appears in Drive |
+| `contentBase64` | string | optional | Base64-encoded file content. Exactly one of contentBase64 or localPath is required. Decoded size is capped at 10 MB. |
+| `localPath` | string | optional | Absolute path of the SOURCE file on disk to upload (on the machine running the server; this is not savePath). Exactly one of contentBase64 or localPath is required. |
+| `mimeType` | string | optional | Source MIME type of the content (inferred from filename if omitted). With `convertTo`, this is the format Drive imports from. |
+| `convertTo` | enum | optional | Convert the upload into this native Google Workspace type on import: "document" \| "spreadsheet" \| "presentation" \| "drawing" (full application/vnd.google-apps.* ids also accepted). E.g. upload .md/.html/.docx/.txt with convertTo=document to get a real Google Doc. Source must be an importable format. Omit to store the file as-is. |
+| `parentFolderId` | string | optional | Parent folder ID, not parentId. Defaults to My Drive root |

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

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

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

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

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

@@ -0,0 +1,92 @@
+# forms
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+7 curated tools, plus 3 generated tools (Google Discovery parameter names; see `forms_discover`).
+
+## `forms_batch_update`
+
+Class: update
+
+Generic forms.batchUpdate pass-through: add/edit/delete questions, update form info and settings. See https://developers.google.com/workspace/forms/api/reference/rest/v1/forms/request
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `formId` | string | required | Form ID |
+| `requests` | array | required | Array of Request objects, each with one request-type key like {createItem: {...}} |
+| `includeFormInResponse` | boolean | optional | Return the updated form in the response |
+| `writeControl` | object | optional | Optional optimistic concurrency control |
+
+## `forms_create`
+
+Class: create
+
+Create a new Google Form with a title (add questions with forms_batch_update)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `title` | string | required | Form title shown to responders |
+| `documentTitle` | string | optional | Drive file name (default: the title) |
+
+## `forms_get`
+
+Class: read
+
+Get a Google Form (definition: questions, sections, settings). Requires forms.body scope.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `formId` | string | required | Form ID |
+
+## `forms_response_get`
+
+Class: read
+
+Get a single form response by ID
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `formId` | string | required | Form ID |
+| `responseId` | string | required | Response ID |
+
+## `forms_responses_list`
+
+Class: read
+
+List form responses. Requires forms.responses.readonly scope.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `formId` | string | required | Form ID |
+| `pageSize` | number | optional | Default: 100; max 1000. Responses can be large. |
+| `pageToken` | string | optional |  |
+| `filter` | string | optional | Filter expression (e.g. "timestamp > 2026-01-01T00:00:00Z") |
+
+## `forms_set_publish_settings`
+
+Class: update
+
+Publish/unpublish a form and toggle whether it accepts responses (legacy forms without publish state are not supported)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `formId` | string | required | Form ID |
+| `isPublished` | boolean | required | Form is published and reachable by responders |
+| `isAcceptingResponses` | boolean | optional | Form accepts responses (requires published; default: follows isPublished) |
+
+## `forms_watches_list`
+
+Class: read
+
+List Pub/Sub watches on a form (notifications for new responses or schema changes)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `formId` | string | required | Form ID |