@aaronsb/google-workspace-mcp 4.0.1 → 4.2.1

package/build/factory/manifest/drive.yaml

@@ -51,10 +51,10 @@ operations:
         required: true
       name:
         type: string
-        description: "File name in Drive (defaults to local name)"
+        description: "File name in Drive. On `upload`, defaults to the local file's name. On `copy`, the name for the copy — without it Drive names it 'Copy of <original>'. On `update`, the new name (a rename)."
       parentFolderId:
         type: string
-        description: "Destination folder ID"
+        description: "Destination folder ID. On `copy`, defaults to the source file's folder."
 
   viewImage:
     type: detail
@@ -63,7 +63,7 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID of the image to view"
+        description: "File ID"
         required: true
     defaults:
       supportsAllDrives: true
@@ -75,7 +75,7 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to download"
+        description: "File ID"
         required: true
       outputPath:
         type: string
@@ -91,14 +91,14 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to copy"
+        description: "File ID"
         required: true
       name:
         type: string
-        description: "Name for the copy (without it, Drive names it 'Copy of <original>')"
+        description: "File name in Drive. On `upload`, defaults to the local file's name. On `copy`, the name for the copy — without it Drive names it 'Copy of <original>'. On `update`, the new name (a rename)."
       parentFolderId:
         type: string
-        description: "Folder ID to place the copy in (defaults to the source's folder)"
+        description: "Destination folder ID. On `copy`, defaults to the source file's folder."
     defaults:
       supportsAllDrives: true
 
@@ -109,11 +109,11 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to update"
+        description: "File ID"
         required: true
       name:
         type: string
-        description: "New file name (rename)"
+        description: "File name in Drive. On `upload`, defaults to the local file's name. On `copy`, the name for the copy — without it Drive names it 'Copy of <original>'. On `update`, the new name (a rename)."
       addParents:
         type: string
         description: "Comma-separated folder ID(s) to add as parents (move into a folder)"
@@ -130,7 +130,7 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to delete"
+        description: "File ID"
         required: true
     defaults:
       supportsAllDrives: true
@@ -142,7 +142,7 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to export"
+        description: "File ID"
         required: true
       mimeType:
         type: string
@@ -150,7 +150,7 @@ operations:
         required: true
       outputPath:
         type: string
-        description: "Local path to save exported file"
+        description: "Local path to save the file"
     defaults:
       supportsAllDrives: true
 
@@ -175,7 +175,7 @@ operations:
     params:
       fileId:
         type: string
-        description: "File ID to share"
+        description: "File ID"
         required: true
       shareEmail:
         type: string
@@ -258,7 +258,7 @@ operations:
         required: true
       content:
         type: string
-        description: "Comment text"
+        description: "Comment text. On `replyToComment`, the reply text."
         required: true
       quotedText:
         type: string
@@ -299,11 +299,11 @@ operations:
         required: true
       commentId:
         type: string
-        description: "Comment ID to reply to"
+        description: "Comment ID"
         required: true
       content:
         type: string
-        description: "Reply text"
+        description: "Comment text. On `replyToComment`, the reply text."
         required: true
     defaults:
       fields: "id, content, htmlContent, author(displayName), createdTime"

package/build/factory/manifest/gmail.yaml

@@ -60,14 +60,14 @@ operations:
         required: true
       body:
         type: string
-        description: "Email body text"
+        description: "Email body text. On `forward`, an optional note prepended ABOVE the forwarded message."
         required: true
       from:
         type: string
         description: "Sender email or RFC 2822 mailbox for a verified Gmail Send As alias"
       cc:
         type: string
-        description: "CC email(s), comma-separated"
+        description: "CC email(s), comma-separated. On `replyAll` these are ADDITIONAL — they do not replace the recipients already on the thread."
       bcc:
         type: string
         description: "BCC email(s), comma-separated"
@@ -87,11 +87,11 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to reply to"
+        description: "Email message ID"
         required: true
       body:
         type: string
-        description: "Reply body text"
+        description: "Email body text. On `forward`, an optional note prepended ABOVE the forwarded message."
         required: true
       attachments:
         type: string
@@ -109,15 +109,15 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to reply to"
+        description: "Email message ID"
         required: true
       body:
         type: string
-        description: "Reply body text"
+        description: "Email body text. On `forward`, an optional note prepended ABOVE the forwarded message."
         required: true
       cc:
         type: string
-        description: "Additional CC email(s), comma-separated"
+        description: "CC email(s), comma-separated. On `replyAll` these are ADDITIONAL — they do not replace the recipients already on the thread."
       attachments:
         type: string
         description: "Workspace filenames to attach, comma-separated (files must exist in workspace via manage_workspace). Creates draft when present."
@@ -134,7 +134,7 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to forward"
+        description: "Email message ID"
         required: true
       to:
         type: string
@@ -142,7 +142,7 @@ operations:
         required: true
       body:
         type: string
-        description: "Optional note to prepend above forwarded message"
+        description: "Email body text. On `forward`, an optional note prepended ABOVE the forwarded message."
 
   # --- Inbox management ---
 
@@ -165,7 +165,7 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to trash"
+        description: "Email message ID"
         required: true
         maps_to: id
     defaults:
@@ -178,7 +178,7 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to restore"
+        description: "Email message ID"
         required: true
         maps_to: id
     defaults:
@@ -191,11 +191,11 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID containing the attachment"
+        description: "Email message ID"
         required: true
       filename:
         type: string
-        description: "Filename to save as (from the read response, e.g. 'invoice_template.md')"
+        description: "Attachment filename, exactly as it appears in the `read` response (e.g. 'invoice_template.md')"
         required: true
     defaults:
       userId: me
@@ -207,11 +207,11 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID containing the attachment"
+        description: "Email message ID"
         required: true
       filename:
         type: string
-        description: "Image filename from the read response"
+        description: "Attachment filename, exactly as it appears in the `read` response (e.g. 'invoice_template.md')"
         required: true
     defaults:
       userId: me
@@ -223,7 +223,7 @@ operations:
     params:
       messageId:
         type: string
-        description: "Message ID to modify"
+        description: "Email message ID"
         required: true
         maps_to: id
       addLabelIds:
@@ -253,11 +253,11 @@ operations:
     params:
       query:
         type: string
-        description: "Gmail search query to filter threads"
+        description: "Gmail search query (e.g. \"from:alice subject:meeting has:attachment\")"
         maps_to: q
       maxResults:
         type: number
-        description: "Max threads to return (default: 10, max: 50)"
+        description: "Max results (default: 10, max: 50)"
         default: 10
         max: 50
     defaults:

package/build/factory/manifest/meet.yaml

@@ -13,10 +13,10 @@ operations:
     params:
       filter:
         type: string
-        description: "EBNF filter (e.g. 'space.meeting_code = \"abc-mnop-xyz\"' or 'start_time>=\"2026-01-01T00:00:00Z\"')"
+        description: "EBNF filter. On `listConferences`, e.g. 'space.meeting_code = \"abc-mnop-xyz\"' or 'start_time>=\"2026-01-01T00:00:00Z\"'. On `listParticipants`, e.g. 'latest_end_time IS NULL' for active participants."
       maxResults:
         type: number
-        description: "Max conferences to return (default: 25, max: 100)"
+        description: "Max results per page, as default/ceiling. Differs by operation: `listConferences` 25/100, `listParticipants` 100/250, `listTranscriptEntries` 100/100. (Google's own default for transcript entries is 10; this tool raises it.)"
         default: 25
         max: 100
         maps_to: pageSize
@@ -28,7 +28,7 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID (from listConferences)"
+        description: "Conference record ID (from `listConferences`)"
         required: true
         maps_to: name
 
@@ -41,15 +41,15 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID"
+        description: "Conference record ID (from `listConferences`)"
         required: true
         maps_to: parent
       filter:
         type: string
-        description: "Filter (e.g. 'latest_end_time IS NULL' for active participants)"
+        description: "EBNF filter. On `listConferences`, e.g. 'space.meeting_code = \"abc-mnop-xyz\"' or 'start_time>=\"2026-01-01T00:00:00Z\"'. On `listParticipants`, e.g. 'latest_end_time IS NULL' for active participants."
       maxResults:
         type: number
-        description: "Max participants (default: 100, max: 250)"
+        description: "Max results per page, as default/ceiling. Differs by operation: `listConferences` 25/100, `listParticipants` 100/250, `listTranscriptEntries` 100/100. (Google's own default for transcript entries is 10; this tool raises it.)"
         default: 100
         max: 250
         maps_to: pageSize
@@ -63,7 +63,7 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID"
+        description: "Conference record ID (from `listConferences`)"
         required: true
         maps_to: parent
 
@@ -74,7 +74,7 @@ operations:
     params:
       transcriptName:
         type: string
-        description: "Transcript resource name (from listTranscripts)"
+        description: "Transcript resource name (from `listTranscripts`, e.g. conferenceRecords/.../transcripts/...)"
         required: true
         maps_to: name
 
@@ -85,12 +85,12 @@ operations:
     params:
       transcriptName:
         type: string
-        description: "Transcript resource name (e.g. conferenceRecords/.../transcripts/...)"
+        description: "Transcript resource name (from `listTranscripts`, e.g. conferenceRecords/.../transcripts/...)"
         required: true
         maps_to: parent
       maxResults:
         type: number
-        description: "Max entries per page (default: 10, max: 100)"
+        description: "Max results per page, as default/ceiling. Differs by operation: `listConferences` 25/100, `listParticipants` 100/250, `listTranscriptEntries` 100/100. (Google's own default for transcript entries is 10; this tool raises it.)"
         default: 100
         max: 100
         maps_to: pageSize
@@ -104,7 +104,7 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID"
+        description: "Conference record ID (from `listConferences`)"
         required: true
         maps_to: parent
 
@@ -128,7 +128,7 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID (from listConferences)"
+        description: "Conference record ID (from `listConferences`)"
         required: true
       pageToken:
         type: string
@@ -143,7 +143,7 @@ operations:
     params:
       conferenceId:
         type: string
-        description: "Conference record ID"
+        description: "Conference record ID (from `listConferences`)"
         required: true
         maps_to: parent
 

package/build/factory/manifest/sheets.yaml

@@ -11,7 +11,7 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
 
   create:
@@ -21,7 +21,7 @@ operations:
     params:
       title:
         type: string
-        description: "Spreadsheet title (defaults to 'Untitled spreadsheet')"
+        description: "On `create`, the spreadsheet title (defaults to 'Untitled spreadsheet'); on `renameSpreadsheet`, its new title. On `addSheet`, the name of the new TAB; on `renameSheet`, that tab's new title; on `duplicateSheet`, the name for the copy (defaults to 'Copy of <source>')."
 
   read:
     type: detail
@@ -30,11 +30,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       range:
         type: string
-        description: "Range to read (e.g. 'Sheet1!A1:D10' or just 'Sheet1')"
+        description: "A1 notation range (e.g. 'Sheet1!A1:D10', or just 'Sheet1' for a whole tab). On `append`, the target tab — defaults to 'Sheet1'; use 'MyTab' or 'MyTab!A:Z' to append to a specific one."
         required: true
 
   append:
@@ -44,17 +44,17 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       range:
         type: string
-        description: "Target range; defaults to 'Sheet1'. Use 'MyTab' or 'MyTab!A:Z' to append to a specific tab."
+        description: "A1 notation range (e.g. 'Sheet1!A1:D10', or just 'Sheet1' for a whole tab). On `append`, the target tab — defaults to 'Sheet1'; use 'MyTab' or 'MyTab!A:Z' to append to a specific one."
       values:
         type: string
         description: "Comma-separated values for a single row (e.g. 'Alice,100,true')"
       jsonValues:
         type: string
-        description: "JSON 2D array of rows for bulk insert (e.g. '[[\"a\",\"b\"],[\"c\",\"d\"]]')"
+        description: "JSON 2D array of rows (e.g. '[[\"a\",\"b\"],[\"c\",\"d\"]]'). Use for bulk and multi-row writes."
       valueInputOption:
         type: string
         description: "How input is interpreted: USER_ENTERED (default, parses formulas/types) or RAW"
@@ -68,11 +68,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       range:
         type: string
-        description: "A1 notation range (e.g. 'Sheet1!A1:B10')"
+        description: "A1 notation range (e.g. 'Sheet1!A1:D10', or just 'Sheet1' for a whole tab). On `append`, the target tab — defaults to 'Sheet1'; use 'MyTab' or 'MyTab!A:Z' to append to a specific one."
         required: true
 
   updateValues:
@@ -82,18 +82,18 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       range:
         type: string
-        description: "A1 notation range to write to"
+        description: "A1 notation range (e.g. 'Sheet1!A1:D10', or just 'Sheet1' for a whole tab). On `append`, the target tab — defaults to 'Sheet1'; use 'MyTab' or 'MyTab!A:Z' to append to a specific one."
         required: true
       values:
         type: string
         description: "Comma-separated values for a single row (e.g. 'Alice,100,true')"
       jsonValues:
         type: string
-        description: "JSON 2D array of rows (e.g. '[[\"a\",\"b\"],[\"c\",\"d\"]]'). Use for multi-row writes."
+        description: "JSON 2D array of rows (e.g. '[[\"a\",\"b\"],[\"c\",\"d\"]]'). Use for bulk and multi-row writes."
       valueInputOption:
         type: string
         description: "How input is interpreted: USER_ENTERED (default, parses formulas/types) or RAW"
@@ -107,11 +107,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       range:
         type: string
-        description: "A1 notation range to clear"
+        description: "A1 notation range (e.g. 'Sheet1!A1:D10', or just 'Sheet1' for a whole tab). On `append`, the target tab — defaults to 'Sheet1'; use 'MyTab' or 'MyTab!A:Z' to append to a specific one."
         required: true
 
   addSheet:
@@ -121,11 +121,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       title:
         type: string
-        description: "Name of the new sheet tab"
+        description: "On `create`, the spreadsheet title (defaults to 'Untitled spreadsheet'); on `renameSpreadsheet`, its new title. On `addSheet`, the name of the new TAB; on `renameSheet`, that tab's new title; on `duplicateSheet`, the name for the copy (defaults to 'Copy of <source>')."
         required: true
       index:
         type: number
@@ -144,15 +144,15 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       sheetId:
         type: number
-        description: "Sheet ID of the tab to rename (from manage_sheets get)"
+        description: "Sheet ID of the tab, from `manage_sheets get`. On `duplicateSheet` and `copySheetTo`, the SOURCE tab to copy."
         required: true
       title:
         type: string
-        description: "New title for the tab"
+        description: "On `create`, the spreadsheet title (defaults to 'Untitled spreadsheet'); on `renameSpreadsheet`, its new title. On `addSheet`, the name of the new TAB; on `renameSheet`, that tab's new title; on `duplicateSheet`, the name for the copy (defaults to 'Copy of <source>')."
         required: true
 
   deleteSheet:
@@ -162,11 +162,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       sheetId:
         type: number
-        description: "Sheet ID of the tab to delete"
+        description: "Sheet ID of the tab, from `manage_sheets get`. On `duplicateSheet` and `copySheetTo`, the SOURCE tab to copy."
         required: true
 
   duplicateSheet:
@@ -176,18 +176,18 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       sheetId:
         type: number
-        description: "Source sheet ID (the tab to copy)"
+        description: "Sheet ID of the tab, from `manage_sheets get`. On `duplicateSheet` and `copySheetTo`, the SOURCE tab to copy."
         required: true
       title:
         type: string
-        description: "Name for the duplicated sheet (defaults to 'Copy of <source>')"
+        description: "On `create`, the spreadsheet title (defaults to 'Untitled spreadsheet'); on `renameSpreadsheet`, its new title. On `addSheet`, the name of the new TAB; on `renameSheet`, that tab's new title; on `duplicateSheet`, the name for the copy (defaults to 'Copy of <source>')."
       index:
         type: number
-        description: "Position to insert the duplicate (0-based)"
+        description: "Position among tabs (0-based). Appended at the end if omitted."
 
   renameSpreadsheet:
     type: action
@@ -196,11 +196,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       title:
         type: string
-        description: "New spreadsheet title"
+        description: "On `create`, the spreadsheet title (defaults to 'Untitled spreadsheet'); on `renameSpreadsheet`, its new title. On `addSheet`, the name of the new TAB; on `renameSheet`, that tab's new title; on `duplicateSheet`, the name for the copy (defaults to 'Copy of <source>')."
         required: true
 
   copySheetTo:
@@ -210,11 +210,11 @@ operations:
     params:
       spreadsheetId:
         type: string
-        description: "Source spreadsheet ID"
+        description: "Spreadsheet ID. On `copySheetTo`, the SOURCE spreadsheet."
         required: true
       sheetId:
         type: number
-        description: "Source sheet ID (the tab to copy)"
+        description: "Sheet ID of the tab, from `manage_sheets get`. On `duplicateSheet` and `copySheetTo`, the SOURCE tab to copy."
         required: true
       destinationSpreadsheetId:
         type: string

package/build/factory/manifest/tasks.yaml

@@ -18,7 +18,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
 
@@ -32,7 +32,7 @@ operations:
     params:
       title:
         type: string
-        description: "Task list name"
+        description: "On `createTaskList`, the task list name. On `create` and `update`, the task title."
         required: true
 
   deleteTaskList:
@@ -42,7 +42,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID to delete"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
 
@@ -55,7 +55,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID (use listTaskLists to find)"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       showCompleted:
@@ -74,7 +74,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       taskId:
@@ -94,12 +94,12 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       title:
         type: string
-        description: "Task title"
+        description: "On `createTaskList`, the task list name. On `create` and `update`, the task title."
         required: true
       notes:
         type: string
@@ -118,7 +118,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       taskId:
@@ -128,13 +128,13 @@ operations:
         maps_to: task
       title:
         type: string
-        description: "New task title"
+        description: "On `createTaskList`, the task list name. On `create` and `update`, the task title."
       notes:
         type: string
-        description: "New task notes / details"
+        description: "Task notes / details"
       due:
         type: string
-        description: "New due date (RFC 3339)"
+        description: "Due date (RFC 3339, e.g. 2026-07-20T00:00:00.000Z — Google stores the date, not the time)"
       status:
         type: string
         description: "Task status"
@@ -147,7 +147,7 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       taskId:
@@ -165,11 +165,11 @@ operations:
     params:
       taskListId:
         type: string
-        description: "Task list ID"
+        description: "Task list ID (use `listTaskLists` to find)"
         required: true
         maps_to: tasklist
       taskId:
         type: string
-        description: "Task ID to delete"
+        description: "Task ID"
         required: true
         maps_to: task