@aaronsb/google-workspace-mcp 2.6.1 → 2.7.0

package/build/factory/manifest/drive.yaml

@@ -0,0 +1,314 @@
+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 (set name to rename the copy; parentFolderId to place it in a folder)"
+    resource: files.copy
+    params:
+      fileId:
+        type: string
+        description: "File ID to copy"
+        required: true
+      name:
+        type: string
+        description: "Name for the copy (without it, Drive names it 'Copy of <original>')"
+      parentFolderId:
+        type: string
+        description: "Folder ID to place the copy in (defaults to the source's folder)"
+    defaults:
+      supportsAllDrives: true
+
+  update:
+    type: action
+    description: "rename a file (set name) and/or move it between folders (addParents / removeParents — to move, set both)"
+    resource: files.update
+    params:
+      fileId:
+        type: string
+        description: "File ID to update"
+        required: true
+      name:
+        type: string
+        description: "New file name (rename)"
+      addParents:
+        type: string
+        description: "Comma-separated folder ID(s) to add as parents (move into a folder)"
+      removeParents:
+        type: string
+        description: "Comma-separated folder ID(s) to remove as parents (move out of a folder)"
+    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, group, domain, or anyone"
+    resource: permissions.create
+    params:
+      fileId:
+        type: string
+        description: "File ID to share"
+        required: true
+      shareEmail:
+        type: string
+        description: "Email address (required when type is 'user' or 'group'). Omit for 'domain' (use 'domain' param) or 'anyone'."
+      role:
+        type: string
+        description: "Permission level"
+        enum: [reader, commenter, writer, organizer]
+        default: reader
+      type:
+        type: string
+        description: "Permission type (default: 'user'). Use 'group' for Google Groups, 'domain' to share with an entire G Suite domain, 'anyone' for public links."
+        enum: [user, group, domain, anyone]
+        default: user
+      domain:
+        type: string
+        description: "Domain name (required when type is 'domain')."
+    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

package/build/factory/manifest/gmail.yaml

@@ -0,0 +1,272 @@
+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. Pass bodyFormat: 'html' when the plain-text part is a stub (marketing email, invitations, booking confirmations) and the dates/codes you need only exist in the HTML — returned HTML is sanitized and wrapped in a Spotlighting block (ADR-305)."
+    resource: users.messages.get
+    params:
+      messageId:
+        type: string
+        description: "Email message ID"
+        required: true
+        maps_to: id
+      bodyFormat:
+        type: string
+        description: "How to render the message body. 'plain' (default) returns text/plain or a crude HTML-strip fallback. 'html' returns the text/html part sanitized — useful when the plain-text part is empty/stub."
+        enum: [plain, html]
+        default: plain
+        client_only: true
+    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"