@aaronsb/google-workspace-mcp 2.6.1 → 2.7.0

package/build/factory/manifest.yaml

@@ -1,1383 +0,0 @@
-# Service manifest — declarative registry for the tool factory (ADR-300).
-# Each entry produces one MCP tool via the generator.
-# gws 0.13.3 — 7 services, 63 operations
-#
-# Note: People (contacts) are supported by gws but excluded here
-# because gws auth login doesn't offer contacts.readonly scope.
-# See https://github.com/googleworkspace/cli/issues/556
-# Meet scopes resolved — use `gws auth login -s ...,meet` to authorize.
-
-services:
-  gmail:
-    tool_name: manage_email
-    description: "Search, read, send, forward, or manage emails in a Google Workspace account. Supports Gmail search syntax."
-    requires_email: true
-    gws_service: gmail
-    operations:
-
-      # --- Core message operations ---
-
-      search:
-        type: list
-        description: "find emails by query"
-        resource: users.messages.list
-        params:
-          query:
-            type: string
-            description: 'Gmail search query (e.g. "from:alice subject:meeting has:attachment")'
-            maps_to: q
-          maxResults:
-            type: number
-            description: "Max results (default: 10, max: 50)"
-            default: 10
-            max: 50
-        defaults:
-          userId: me
-        hydration:
-          resource: users.messages.get
-          format: metadata
-          headers: [From, Subject, Date]
-
-      read:
-        type: detail
-        description: "get full email by ID"
-        resource: users.messages.get
-        params:
-          messageId:
-            type: string
-            description: "Email message ID"
-            required: true
-            maps_to: id
-        defaults:
-          userId: me
-
-      send:
-        type: action
-        description: "compose and send a new email (creates draft when attachments present, 35MB attachment limit via upload endpoint)"
-        helper: "+send"
-        params:
-          to:
-            type: string
-            description: "Recipient email(s), comma-separated"
-            required: true
-          subject:
-            type: string
-            description: "Email subject line"
-            required: true
-          body:
-            type: string
-            description: "Email body text"
-            required: true
-          cc:
-            type: string
-            description: "CC email(s), comma-separated"
-          bcc:
-            type: string
-            description: "BCC email(s), comma-separated"
-          attachments:
-            type: string
-            description: "Workspace filenames to attach, comma-separated (files must exist in workspace via manage_workspace). Creates draft when present."
-          html:
-            type: boolean
-            description: "Treat body as HTML content (default: plain text)"
-          draft:
-            type: boolean
-            description: "Save as draft instead of sending (default: false, forced true when attachments present)"
-        cli_args:
-          to: "--to"
-          subject: "--subject"
-          body: "--body"
-          cc: "--cc"
-          bcc: "--bcc"
-
-      reply:
-        type: action
-        description: "reply to a message (thread-aware)"
-        helper: "+reply"
-        params:
-          messageId:
-            type: string
-            description: "Message ID to reply to"
-            required: true
-          body:
-            type: string
-            description: "Reply body text"
-            required: true
-        cli_args:
-          messageId: "--message-id"
-          body: "--body"
-
-      replyAll:
-        type: action
-        description: "reply-all to a message (thread-aware, includes all recipients)"
-        helper: "+reply-all"
-        params:
-          messageId:
-            type: string
-            description: "Message ID to reply to"
-            required: true
-          body:
-            type: string
-            description: "Reply body text"
-            required: true
-          cc:
-            type: string
-            description: "Additional CC email(s), comma-separated"
-        cli_args:
-          messageId: "--message-id"
-          body: "--body"
-          cc: "--cc"
-
-      forward:
-        type: action
-        description: "forward a message to new recipients (includes original attachments by default)"
-        helper: "+forward"
-        params:
-          messageId:
-            type: string
-            description: "Message ID to forward"
-            required: true
-          to:
-            type: string
-            description: "Recipient email(s), comma-separated"
-            required: true
-          body:
-            type: string
-            description: "Optional note to prepend above forwarded message"
-        cli_args:
-          messageId: "--message-id"
-          to: "--to"
-          body: "--body"
-
-      # --- Inbox management ---
-
-      triage:
-        type: list
-        description: "unread inbox summary (sender, subject, date)"
-        helper: "+triage"
-
-      trash:
-        type: action
-        description: "move a message to trash"
-        resource: users.messages.trash
-        params:
-          messageId:
-            type: string
-            description: "Message ID to trash"
-            required: true
-            maps_to: id
-        defaults:
-          userId: me
-
-      untrash:
-        type: action
-        description: "restore a message from trash"
-        resource: users.messages.untrash
-        params:
-          messageId:
-            type: string
-            description: "Message ID to restore"
-            required: true
-            maps_to: id
-        defaults:
-          userId: me
-
-      getAttachment:
-        type: detail
-        description: "download an email attachment to workspace directory (use read first to see attachment list)"
-        resource: users.messages.attachments.get
-        params:
-          messageId:
-            type: string
-            description: "Message ID containing the attachment"
-            required: true
-          filename:
-            type: string
-            description: "Filename to save as (from the read response, e.g. 'invoice_template.md')"
-            required: true
-        defaults:
-          userId: me
-
-      viewAttachment:
-        type: detail
-        description: "view an image attachment inline without saving to workspace (png, jpg, gif, webp). Use for quick preview — use getAttachment to save."
-        resource: users.messages.attachments.get
-        params:
-          messageId:
-            type: string
-            description: "Message ID containing the attachment"
-            required: true
-          filename:
-            type: string
-            description: "Image filename from the read response"
-            required: true
-        defaults:
-          userId: me
-
-      modify:
-        type: action
-        description: "add or remove labels on a message (e.g. archive, mark read/unread)"
-        resource: users.messages.modify
-        params:
-          messageId:
-            type: string
-            description: "Message ID to modify"
-            required: true
-            maps_to: id
-          addLabelIds:
-            type: string
-            description: "Comma-separated label IDs to add (e.g. STARRED, IMPORTANT, Label_123)"
-          removeLabelIds:
-            type: string
-            description: "Comma-separated label IDs to remove (e.g. UNREAD, INBOX to archive)"
-        defaults:
-          userId: me
-
-      # --- Labels ---
-
-      labels:
-        type: list
-        description: "list all labels in the mailbox"
-        resource: users.labels.list
-        defaults:
-          userId: me
-
-      # --- Threads ---
-
-      threads:
-        type: list
-        description: "list email threads by query"
-        resource: users.threads.list
-        params:
-          query:
-            type: string
-            description: "Gmail search query to filter threads"
-            maps_to: q
-          maxResults:
-            type: number
-            description: "Max threads to return (default: 10, max: 50)"
-            default: 10
-            max: 50
-        defaults:
-          userId: me
-
-      getThread:
-        type: detail
-        description: "get all messages in a thread"
-        resource: users.threads.get
-        params:
-          threadId:
-            type: string
-            description: "Thread ID to retrieve"
-            required: true
-            maps_to: id
-        defaults:
-          userId: me
-          format: metadata
-          metadataHeaders: "From,Subject,Date,To"
-
-  calendar:
-    tool_name: manage_calendar
-    description: "List events, view agenda, check availability, or manage calendar events."
-    requires_email: true
-    gws_service: calendar
-    operations:
-
-      # --- Event viewing ---
-
-      list:
-        type: list
-        description: "upcoming events — defaults to primary calendar, use calendarId to target a specific calendar (use 'calendars' operation to discover IDs)"
-        resource: events.list
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID to query (default: 'primary'). Use 'calendars' operation to list available IDs."
-          timeMin:
-            type: string
-            description: "Start of range (ISO 8601) — defaults to today"
-          timeMax:
-            type: string
-            description: "End of range (ISO 8601)"
-          maxResults:
-            type: number
-            description: "Max events (default: 10, max: 50)"
-            default: 10
-            max: 50
-          query:
-            type: string
-            description: "Free-text search terms to filter events"
-            maps_to: q
-        defaults:
-          calendarId: primary
-          singleEvents: true
-          orderBy: startTime
-
-      agenda:
-        type: list
-        description: "today's schedule at a glance (all calendars). Returns calendarId per event for follow-up get calls."
-        helper: "+agenda"
-        params:
-          calendarId:
-            type: string
-            description: "Filter to a specific calendar name or ID"
-          days:
-            type: number
-            description: "Number of days ahead to show (default: today only)"
-          tomorrow:
-            type: boolean
-            description: "Show tomorrow's events instead of today"
-          week:
-            type: boolean
-            description: "Show this week's events"
-
-      get:
-        type: detail
-        description: "full event details by ID. For shared calendar events, calendarId is required (use agenda or list to discover it)."
-        resource: events.get
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID (default: 'primary'). Required for events on shared calendars."
-          eventId:
-            type: string
-            description: "Event ID"
-            required: true
-        defaults:
-          calendarId: primary
-
-      # --- Event management ---
-
-      create:
-        type: action
-        description: "create a new calendar event"
-        helper: "+insert"
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID (default: 'primary')"
-          summary:
-            type: string
-            description: "Event title"
-            required: true
-          start:
-            type: string
-            description: "Start time (ISO 8601)"
-            required: true
-          end:
-            type: string
-            description: "End time (ISO 8601)"
-            required: true
-          description:
-            type: string
-            description: "Event description or notes"
-          location:
-            type: string
-            description: "Event location"
-          attendees:
-            type: string
-            description: "Comma-separated attendee emails"
-          meet:
-            type: boolean
-            description: "Add a Google Meet video conference link to the event"
-        cli_args:
-          calendarId: "--calendar"
-          summary: "--summary"
-          start: "--start"
-          end: "--end"
-          description: "--description"
-          location: "--location"
-          attendees: "--attendees"
-
-      quickAdd:
-        type: action
-        description: "create event from natural language (e.g. 'Lunch with Alice tomorrow at noon')"
-        resource: events.quickAdd
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID (default: 'primary')"
-          text:
-            type: string
-            description: "Natural language event description"
-            required: true
-        defaults:
-          calendarId: primary
-
-      update:
-        type: action
-        description: "update an existing event (patch semantics — only changed fields needed)"
-        resource: events.patch
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID (default: 'primary')"
-          eventId:
-            type: string
-            description: "Event ID to update"
-            required: true
-          summary:
-            type: string
-            description: "Updated event title"
-          start:
-            type: string
-            description: "Updated start time (ISO 8601)"
-          end:
-            type: string
-            description: "Updated end time (ISO 8601)"
-          description:
-            type: string
-            description: "Updated description"
-          location:
-            type: string
-            description: "Updated location"
-        defaults:
-          calendarId: primary
-
-      delete:
-        type: action
-        description: "delete an event"
-        resource: events.delete
-        params:
-          calendarId:
-            type: string
-            description: "Calendar ID (default: 'primary')"
-          eventId:
-            type: string
-            description: "Event ID to delete"
-            required: true
-        defaults:
-          calendarId: primary
-
-      # --- Calendar management ---
-
-      calendars:
-        type: list
-        description: "list all calendars the user has access to"
-        resource: calendarList.list
-
-      freebusy:
-        type: detail
-        description: "check availability (free/busy) for a time range. Automatically includes own calendar; add attendees to check others."
-        resource: freebusy.query
-        params:
-          timeMin:
-            type: string
-            description: "Start of range (ISO 8601)"
-            required: true
-          timeMax:
-            type: string
-            description: "End of range (ISO 8601)"
-            required: true
-          attendees:
-            type: string
-            description: "Comma-separated email addresses to check availability for"
-          calendarId:
-            type: string
-            description: "Comma-separated calendar IDs to check (in addition to own calendar)"
-
-  drive:
-    tool_name: manage_drive
-    description: "Search, upload, download, share, comment on, or manage files in Google Drive."
-    requires_email: true
-    gws_service: drive
-    operations:
-
-      # --- File discovery ---
-
-      search:
-        type: list
-        description: "find files by query"
-        resource: files.list
-        params:
-          query:
-            type: string
-            description: "Drive search query (e.g. \"name contains 'budget'\" or \"mimeType='application/pdf'\")"
-            maps_to: q
-          maxResults:
-            type: number
-            description: "Max results (default: 10, max: 50)"
-            default: 10
-            max: 50
-            maps_to: pageSize
-        defaults:
-          fields: "files(id, name, mimeType, modifiedTime, size, webViewLink)"
-          supportsAllDrives: true
-          includeItemsFromAllDrives: true
-
-      get:
-        type: detail
-        description: "get file metadata"
-        resource: files.get
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-        defaults:
-          fields: "id, name, mimeType, modifiedTime, size, webViewLink, owners, shared, parents"
-          supportsAllDrives: true
-
-      # --- File operations ---
-
-      upload:
-        type: action
-        description: "upload a local file to Drive"
-        helper: "+upload"
-        params:
-          filePath:
-            type: string
-            description: "Local file path to upload"
-            required: true
-          name:
-            type: string
-            description: "File name in Drive (defaults to local name)"
-          parentFolderId:
-            type: string
-            description: "Destination folder ID"
-        cli_args:
-          name: "--name"
-          parentFolderId: "--parent"
-
-      viewImage:
-        type: detail
-        description: "view an image file inline without saving to workspace (png, jpg, gif, webp). Use for quick preview — use download to save."
-        resource: files.get
-        params:
-          fileId:
-            type: string
-            description: "File ID of the image to view"
-            required: true
-        defaults:
-          supportsAllDrives: true
-
-      download:
-        type: detail
-        description: "download file content to local path"
-        resource: files.get
-        params:
-          fileId:
-            type: string
-            description: "File ID to download"
-            required: true
-          outputPath:
-            type: string
-            description: "Local path to save the file"
-        defaults:
-          alt: media
-          supportsAllDrives: true
-
-      copy:
-        type: action
-        description: "create a copy of a file"
-        resource: files.copy
-        params:
-          fileId:
-            type: string
-            description: "File ID to copy"
-            required: true
-          name:
-            type: string
-            description: "Name for the copy"
-        defaults:
-          supportsAllDrives: true
-
-      delete:
-        type: action
-        description: "permanently delete a file (cannot be undone)"
-        resource: files.delete
-        params:
-          fileId:
-            type: string
-            description: "File ID to delete"
-            required: true
-        defaults:
-          supportsAllDrives: true
-
-      export:
-        type: action
-        description: "export a Google Workspace document (Docs, Sheets, Slides) to a file format"
-        resource: files.export
-        params:
-          fileId:
-            type: string
-            description: "File ID to export"
-            required: true
-          mimeType:
-            type: string
-            description: "Target format (e.g. application/pdf, text/csv, text/plain, application/vnd.openxmlformats-officedocument.wordprocessingml.document)"
-            required: true
-          outputPath:
-            type: string
-            description: "Local path to save exported file"
-        defaults:
-          supportsAllDrives: true
-
-      # --- Sharing ---
-
-      listPermissions:
-        type: list
-        description: "list sharing permissions on a file"
-        resource: permissions.list
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-        defaults:
-          supportsAllDrives: true
-
-      share:
-        type: action
-        description: "share a file with a user or group"
-        resource: permissions.create
-        params:
-          fileId:
-            type: string
-            description: "File ID to share"
-            required: true
-          shareEmail:
-            type: string
-            description: "Email address to share with"
-            required: true
-          role:
-            type: string
-            description: "Permission level"
-            enum: [reader, commenter, writer, organizer]
-            default: reader
-        defaults:
-          supportsAllDrives: true
-
-      unshare:
-        type: action
-        description: "remove sharing permission from a file"
-        resource: permissions.delete
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          permissionId:
-            type: string
-            description: "Permission ID to remove (from listPermissions)"
-            required: true
-        defaults:
-          supportsAllDrives: true
-
-      # --- Comments ---
-
-      listComments:
-        type: list
-        description: "list comments on a file"
-        resource: comments.list
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          includeDeleted:
-            type: boolean
-            description: "Include deleted comments (default: false)"
-        defaults:
-          fields: "comments(id, content, htmlContent, author(displayName, emailAddress), createdTime, modifiedTime, resolved, quotedFileContent, replies(id, content, htmlContent, author(displayName), createdTime)), nextPageToken"
-          supportsAllDrives: true
-
-      getComment:
-        type: detail
-        description: "get a specific comment by ID"
-        resource: comments.get
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          commentId:
-            type: string
-            description: "Comment ID"
-            required: true
-        defaults:
-          fields: "id, content, htmlContent, author(displayName, emailAddress), createdTime, modifiedTime, resolved, quotedFileContent, replies(id, content, htmlContent, author(displayName), createdTime)"
-          supportsAllDrives: true
-
-      addComment:
-        type: action
-        description: "add a comment to a file (optionally anchored to quoted text)"
-        resource: comments.create
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          content:
-            type: string
-            description: "Comment text"
-            required: true
-          quotedText:
-            type: string
-            description: "Text to anchor the comment to (optional — if provided, comment is anchored to first occurrence)"
-        defaults:
-          fields: "id, content, htmlContent, author(displayName), createdTime, quotedFileContent"
-          supportsAllDrives: true
-
-      resolveComment:
-        type: action
-        description: "resolve or reopen a comment"
-        resource: comments.update
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          commentId:
-            type: string
-            description: "Comment ID"
-            required: true
-          resolved:
-            type: boolean
-            description: "true to resolve, false to reopen"
-            required: true
-        defaults:
-          fields: "id, content, resolved"
-          supportsAllDrives: true
-
-      replyToComment:
-        type: action
-        description: "reply to an existing comment"
-        resource: replies.create
-        params:
-          fileId:
-            type: string
-            description: "File ID"
-            required: true
-          commentId:
-            type: string
-            description: "Comment ID to reply to"
-            required: true
-          content:
-            type: string
-            description: "Reply text"
-            required: true
-        defaults:
-          fields: "id, content, htmlContent, author(displayName), createdTime"
-          supportsAllDrives: true
-
-  # ========================================================================
-  # Sheets
-  # ========================================================================
-
-  sheets:
-    tool_name: manage_sheets
-    description: "Read, write, and manage Google Sheets spreadsheets."
-    requires_email: true
-    gws_service: sheets
-    operations:
-
-      get:
-        type: detail
-        description: "get spreadsheet metadata and sheet names"
-        resource: spreadsheets.get
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-
-      create:
-        type: action
-        description: "create a new empty spreadsheet"
-        resource: spreadsheets.create
-
-      read:
-        type: detail
-        description: "read cell values from a range"
-        helper: "+read"
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          range:
-            type: string
-            description: "Range to read (e.g. 'Sheet1!A1:D10' or just 'Sheet1')"
-            required: true
-        cli_args:
-          spreadsheetId: "--spreadsheet"
-          range: "--range"
-
-      append:
-        type: action
-        description: "append rows to a spreadsheet (rows land after the last row of existing data in the target range)"
-        resource: spreadsheets.values.append
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          range:
-            type: string
-            description: "Target range; defaults to 'Sheet1'. Use 'MyTab' or 'MyTab!A:Z' to append to a specific tab."
-          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\"]]')"
-          valueInputOption:
-            type: string
-            description: "How input is interpreted: USER_ENTERED (default, parses formulas/types) or RAW"
-            enum: [USER_ENTERED, RAW]
-            default: USER_ENTERED
-
-      getValues:
-        type: detail
-        description: "get values from a specific range (raw API)"
-        resource: spreadsheets.values.get
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          range:
-            type: string
-            description: "A1 notation range (e.g. 'Sheet1!A1:B10')"
-            required: true
-
-      updateValues:
-        type: action
-        description: "write values to a specific range"
-        resource: spreadsheets.values.update
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          range:
-            type: string
-            description: "A1 notation range to write to"
-            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."
-          valueInputOption:
-            type: string
-            description: "How input is interpreted: USER_ENTERED (default, parses formulas/types) or RAW"
-            enum: [USER_ENTERED, RAW]
-            default: USER_ENTERED
-
-      clearValues:
-        type: action
-        description: "clear cell values from a range (structure preserved)"
-        resource: spreadsheets.values.clear
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          range:
-            type: string
-            description: "A1 notation range to clear"
-            required: true
-
-      addSheet:
-        type: action
-        description: "add a new tab (sheet) to the spreadsheet"
-        resource: spreadsheets.batchUpdate
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          title:
-            type: string
-            description: "Name of the new sheet tab"
-            required: true
-          index:
-            type: number
-            description: "Position among tabs (0-based). Appended at the end if omitted."
-          rowCount:
-            type: number
-            description: "Initial row count (default 1000)"
-          columnCount:
-            type: number
-            description: "Initial column count (default 26)"
-
-      renameSheet:
-        type: action
-        description: "rename a tab (sheet) within a spreadsheet"
-        resource: spreadsheets.batchUpdate
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          sheetId:
-            type: number
-            description: "Sheet ID of the tab to rename (from manage_sheets get)"
-            required: true
-          title:
-            type: string
-            description: "New title for the tab"
-            required: true
-
-      deleteSheet:
-        type: action
-        description: "delete a tab (sheet) from the spreadsheet — irreversible"
-        resource: spreadsheets.batchUpdate
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          sheetId:
-            type: number
-            description: "Sheet ID of the tab to delete"
-            required: true
-
-      duplicateSheet:
-        type: action
-        description: "duplicate a tab within the same spreadsheet"
-        resource: spreadsheets.batchUpdate
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          sheetId:
-            type: number
-            description: "Source sheet ID (the tab to copy)"
-            required: true
-          title:
-            type: string
-            description: "Name for the duplicated sheet (defaults to 'Copy of <source>')"
-          index:
-            type: number
-            description: "Position to insert the duplicate (0-based)"
-
-      renameSpreadsheet:
-        type: action
-        description: "rename the spreadsheet (the document title, not a tab)"
-        resource: spreadsheets.batchUpdate
-        params:
-          spreadsheetId:
-            type: string
-            description: "Spreadsheet ID"
-            required: true
-          title:
-            type: string
-            description: "New spreadsheet title"
-            required: true
-
-      copySheetTo:
-        type: action
-        description: "copy a tab from this spreadsheet into another spreadsheet"
-        resource: spreadsheets.sheets.copyTo
-        params:
-          spreadsheetId:
-            type: string
-            description: "Source spreadsheet ID"
-            required: true
-          sheetId:
-            type: number
-            description: "Source sheet ID (the tab to copy)"
-            required: true
-          destinationSpreadsheetId:
-            type: string
-            description: "Destination spreadsheet ID"
-            required: true
-
-  # ========================================================================
-  # Docs
-  # ========================================================================
-
-  docs:
-    tool_name: manage_docs
-    description: "Read, write, insert, and find-replace text in Google Docs documents."
-    requires_email: true
-    gws_service: docs
-    operations:
-
-      get:
-        type: detail
-        description: "get document content and metadata"
-        resource: documents.get
-        params:
-          documentId:
-            type: string
-            description: "Document ID"
-            required: true
-
-      create:
-        type: action
-        description: "create a new blank document"
-        resource: documents.create
-
-      write:
-        type: action
-        description: "append text to the end of a document"
-        helper: "+write"
-        params:
-          documentId:
-            type: string
-            description: "Document ID"
-            required: true
-          text:
-            type: string
-            description: "Text to append (plain text)"
-            required: true
-        cli_args:
-          documentId: "--document"
-          text: "--text"
-
-      insertText:
-        type: action
-        description: "insert text at a specific position in a document"
-        resource: documents.batchUpdate
-        params:
-          documentId:
-            type: string
-            description: "Document ID"
-            required: true
-          text:
-            type: string
-            description: "Text to insert"
-            required: true
-          index:
-            type: number
-            description: "Character index to insert at (1 = start of document body)"
-            required: true
-
-      replaceText:
-        type: action
-        description: "find and replace text in a document"
-        resource: documents.batchUpdate
-        params:
-          documentId:
-            type: string
-            description: "Document ID"
-            required: true
-          findText:
-            type: string
-            description: "Text to find"
-            required: true
-          replaceWith:
-            type: string
-            description: "Replacement text"
-            required: true
-          matchCase:
-            type: boolean
-            description: "Case-sensitive match (default: true)"
-            default: true
-
-  # ========================================================================
-  # Tasks
-  # ========================================================================
-
-  tasks:
-    tool_name: manage_tasks
-    description: "Manage task lists and tasks in Google Tasks."
-    requires_email: true
-    gws_service: tasks
-    operations:
-
-      # --- Task lists ---
-
-      listTaskLists:
-        type: list
-        description: "list all task lists"
-        resource: tasklists.list
-
-      getTaskList:
-        type: detail
-        description: "get a task list by ID"
-        resource: tasklists.get
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-
-      createTaskList:
-        type: action
-        description: "create a new task list"
-        resource: tasklists.insert
-
-      deleteTaskList:
-        type: action
-        description: "delete a task list and all its tasks"
-        resource: tasklists.delete
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID to delete"
-            required: true
-            maps_to: tasklist
-
-      # --- Tasks ---
-
-      list:
-        type: list
-        description: "list tasks in a task list"
-        resource: tasks.list
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID (use listTaskLists to find)"
-            required: true
-            maps_to: tasklist
-          showCompleted:
-            type: boolean
-            description: "Include completed tasks (default: true)"
-          maxResults:
-            type: number
-            description: "Max tasks to return (default: 20, max: 100)"
-            default: 20
-            max: 100
-
-      get:
-        type: detail
-        description: "get a specific task"
-        resource: tasks.get
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-          taskId:
-            type: string
-            description: "Task ID"
-            required: true
-            maps_to: task
-
-      create:
-        type: action
-        description: "create a new task"
-        resource: tasks.insert
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-
-      update:
-        type: action
-        description: "update a task (patch semantics)"
-        resource: tasks.patch
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-          taskId:
-            type: string
-            description: "Task ID"
-            required: true
-            maps_to: task
-
-      complete:
-        type: action
-        description: "mark a task as completed"
-        resource: tasks.patch
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-          taskId:
-            type: string
-            description: "Task ID"
-            required: true
-            maps_to: task
-        defaults:
-          status: completed
-
-      delete:
-        type: action
-        description: "delete a task"
-        resource: tasks.delete
-        params:
-          taskListId:
-            type: string
-            description: "Task list ID"
-            required: true
-            maps_to: tasklist
-          taskId:
-            type: string
-            description: "Task ID to delete"
-            required: true
-            maps_to: task
-
-  # ========================================================================
-  # Meet
-  # ========================================================================
-
-  meet:
-    tool_name: manage_meet
-    description: "Browse past Google Meet conferences, participants, transcripts, recordings, and AI-generated smart notes. Requires Workspace Business Standard+ for transcripts/recordings."
-    requires_email: true
-    gws_service: meet
-    operations:
-
-      # --- Conference records ---
-
-      listConferences:
-        type: list
-        description: "list recent meeting conferences (default: descending by start time)"
-        resource: conferenceRecords.list
-        params:
-          filter:
-            type: string
-            description: "EBNF filter (e.g. 'space.meeting_code = \"abc-mnop-xyz\"' or 'start_time>=\"2026-01-01T00:00:00Z\"')"
-          maxResults:
-            type: number
-            description: "Max conferences to return (default: 25, max: 100)"
-            default: 25
-            max: 100
-            maps_to: pageSize
-
-      getConference:
-        type: detail
-        description: "get details of a specific conference"
-        resource: conferenceRecords.get
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID (from listConferences)"
-            required: true
-            maps_to: name
-
-      # --- Participants ---
-
-      listParticipants:
-        type: list
-        description: "list who attended a conference"
-        resource: conferenceRecords.participants.list
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID"
-            required: true
-            maps_to: parent
-          filter:
-            type: string
-            description: "Filter (e.g. 'latest_end_time IS NULL' for active participants)"
-          maxResults:
-            type: number
-            description: "Max participants (default: 100, max: 250)"
-            default: 100
-            max: 250
-            maps_to: pageSize
-
-      # --- Transcripts ---
-
-      listTranscripts:
-        type: list
-        description: "list transcripts for a conference (requires Workspace Business Standard+)"
-        resource: conferenceRecords.transcripts.list
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID"
-            required: true
-            maps_to: parent
-
-      getTranscript:
-        type: detail
-        description: "get transcript metadata including Google Docs destination"
-        resource: conferenceRecords.transcripts.get
-        params:
-          transcriptName:
-            type: string
-            description: "Transcript resource name (from listTranscripts)"
-            required: true
-            maps_to: name
-
-      listTranscriptEntries:
-        type: list
-        description: "get structured transcript text — who said what, with timestamps"
-        resource: conferenceRecords.transcripts.entries.list
-        params:
-          transcriptName:
-            type: string
-            description: "Transcript resource name (e.g. conferenceRecords/.../transcripts/...)"
-            required: true
-            maps_to: parent
-          maxResults:
-            type: number
-            description: "Max entries per page (default: 10, max: 100)"
-            default: 100
-            max: 100
-            maps_to: pageSize
-
-      # --- Recordings ---
-
-      listRecordings:
-        type: list
-        description: "list recordings for a conference (saved as MP4 in Drive)"
-        resource: conferenceRecords.recordings.list
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID"
-            required: true
-            maps_to: parent
-
-      getRecording:
-        type: detail
-        description: "get recording metadata including Drive file ID and playback link"
-        resource: conferenceRecords.recordings.get
-        params:
-          recordingName:
-            type: string
-            description: "Recording resource name (from listRecordings)"
-            required: true
-            maps_to: name
-
-      # --- Composite operations ---
-
-      getFullTranscript:
-        type: detail
-        description: "get the full who-said-what transcript for a conference (chains transcripts + entries + participant names automatically). Use pageToken to continue reading."
-        resource: conferenceRecords.transcripts.list
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID (from listConferences)"
-            required: true
-          pageToken:
-            type: string
-            description: "Page token from a previous getFullTranscript call to continue reading"
-
-      # --- Smart Notes (Gemini) ---
-
-      listSmartNotes:
-        type: list
-        description: "list Gemini-generated smart notes for a conference"
-        resource: conferenceRecords.smartNotes.list
-        params:
-          conferenceId:
-            type: string
-            description: "Conference record ID"
-            required: true
-            maps_to: parent
-
-      getSmartNote:
-        type: detail
-        description: "get smart note metadata including Google Docs destination"
-        resource: conferenceRecords.smartNotes.get
-        params:
-          smartNoteName:
-            type: string
-            description: "Smart note resource name (from listSmartNotes)"
-            required: true
-            maps_to: name
-
-  # People (contacts) excluded pending gws auth scope support for contacts.readonly.
-  # See https://github.com/googleworkspace/cli/issues/556