@apteva/integrations 0.3.47 → 0.3.59

package/src/apps/google-drive.json

@@ -2,7 +2,7 @@
   "slug": "google-drive",
   "name": "Google Drive",
   "description": "MCP server for Google Drive file storage and management operations",
-  "logo": "https://ssl.gstatic.com/docs/doclist/images/drive_2022q3_32dp.png",
+  "logo": "https://upload.wikimedia.org/wikipedia/commons/1/12/Google_Drive_icon_%282020%29.svg",
   "categories": [
     "google-drive",
     "file-storage",
@@ -58,7 +58,7 @@
   "tools": [
     {
       "name": "list_files",
-      "description": "List files in Google Drive with optional folder filter and sorting",
+      "description": "List files in Google Drive with optional folder filter and sorting. Call with no parameters to list recent files, or use 'q' to filter.",
       "method": "GET",
       "path": "/drive/v3/files",
       "input_schema": {
@@ -66,18 +66,15 @@
         "properties": {
           "q": {
             "type": "string",
-            "description": "Search query using Drive query syntax. Examples: \"'FOLDER_ID' in parents\" to list folder contents, \"mimeType='application/vnd.google-apps.spreadsheet'\" to find sheets, \"name contains 'report'\" to search by name, \"modifiedTime > '2025-01-01'\" for recent files"
+            "description": "Search query using Drive query syntax. Examples: \"'FOLDER_ID' in parents\" to list folder contents, \"mimeType='application/vnd.google-apps.spreadsheet'\" to find sheets, \"name contains 'report'\" to search by name, \"modifiedTime > '2025-01-01'\" for recent files, \"trashed=true\" to list trashed files"
           },
           "pageSize": {
             "type": "integer",
-            "description": "Maximum number of files to return (1-1000)",
-            "default": 100,
-            "maximum": 1000
+            "description": "Maximum number of files to return (1-1000). Default 100."
           },
           "orderBy": {
             "type": "string",
-            "description": "Sort order. Options: createdTime, folder, modifiedByMeTime, modifiedTime, name, quotaBytesUsed, recency, sharedWithMeTime, starred, viewedByMeTime. Append ' desc' for descending.",
-            "default": "modifiedTime desc"
+            "description": "Sort order. Options: createdTime, folder, modifiedByMeTime, modifiedTime, name, quotaBytesUsed, recency, sharedWithMeTime, starred, viewedByMeTime. Append ' desc' for descending."
           },
           "pageToken": {
             "type": "string",
@@ -85,20 +82,35 @@
           },
           "fields": {
             "type": "string",
-            "description": "Fields to include in response",
-            "default": "nextPageToken,files(id,name,mimeType,size,modifiedTime,parents,webViewLink,createdTime)"
+            "description": "Fields to include. Example: 'nextPageToken,files(id,name,mimeType,size,modifiedTime,webViewLink)'. Omit for default fields."
           },
           "spaces": {
             "type": "string",
-            "description": "Spaces to search: drive, appDataFolder",
-            "default": "drive"
+            "description": "Spaces to search: 'drive' (default) or 'appDataFolder'"
+          },
+          "corpora": {
+            "type": "string",
+            "description": "Source of files. 'user' (default), 'domain', 'drive' (specific shared drive — requires driveId), or 'allDrives' (requires includeItemsFromAllDrives=true and supportsAllDrives=true).",
+            "enum": ["user", "domain", "drive", "allDrives"]
+          },
+          "driveId": {
+            "type": "string",
+            "description": "ID of the shared drive to search (only when corpora='drive')"
+          },
+          "includeItemsFromAllDrives": {
+            "type": "boolean",
+            "description": "Include files from shared drives. Must set corpora='allDrives' and supportsAllDrives=true when using this."
+          },
+          "supportsAllDrives": {
+            "type": "boolean",
+            "description": "Whether the request supports shared drives. Required when accessing shared drive files."
           }
         }
       }
     },
     {
       "name": "get_file",
-      "description": "Get metadata for a specific file by ID",
+      "description": "Get metadata for a specific file by ID. Returns file name, MIME type, size, sharing links (webViewLink for browser, webContentLink for direct download), owners, and permissions.",
       "method": "GET",
       "path": "/drive/v3/files/{fileId}",
       "input_schema": {
@@ -110,13 +122,34 @@
           },
           "fields": {
             "type": "string",
-            "description": "Fields to return",
-            "default": "id,name,mimeType,size,modifiedTime,parents,webViewLink,createdTime,owners,permissions,description"
+            "description": "Fields to return. Example: 'id,name,mimeType,size,modifiedTime,webViewLink,webContentLink,owners,description'. Omit for default fields."
           },
           "supportsAllDrives": {
             "type": "boolean",
-            "description": "Support shared drives",
-            "default": true
+            "description": "Set to true to access files in shared drives"
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
+    {
+      "name": "download_file",
+      "description": "Download the binary content of a non-Google Workspace file (images, audio, video, PDFs, etc.). For Google Workspace files (Docs, Sheets, Slides), use export_file instead.",
+      "method": "GET",
+      "path": "/drive/v3/files/{fileId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file to download"
+          },
+          "alt": {
+            "type": "string",
+            "description": "Must be 'media' to download file content",
+            "default": "media"
           }
         },
         "required": [
@@ -126,7 +159,7 @@
     },
     {
       "name": "search_files",
-      "description": "Search for files in Google Drive by name, content, type, or other criteria",
+      "description": "Search for files in Google Drive by name, content, type, or other criteria. Returns file IDs, names, links, and metadata.",
       "method": "GET",
       "path": "/drive/v3/files",
       "input_schema": {
@@ -134,23 +167,19 @@
         "properties": {
           "q": {
             "type": "string",
-            "description": "Drive search query. Examples: \"name contains 'budget'\", \"fullText contains 'quarterly'\", \"mimeType='application/vnd.google-apps.spreadsheet'\", \"modifiedTime > '2025-01-01T00:00:00'\", \"'me' in owners\". Combine with 'and'/'or'."
+            "description": "Drive search query. Examples: \"name contains 'budget'\", \"fullText contains 'quarterly'\", \"mimeType='application/vnd.google-apps.spreadsheet'\", \"mimeType contains 'audio/'\", \"mimeType contains 'video/'\", \"mimeType='application/pdf'\", \"modifiedTime > '2025-01-01T00:00:00'\", \"'me' in owners\", \"sharedWithMe=true\", \"starred=true\". Combine with 'and'/'or'."
           },
           "pageSize": {
             "type": "integer",
-            "description": "Max results (1-1000)",
-            "default": 50,
-            "maximum": 1000
+            "description": "Max results (1-1000). Default 50."
           },
           "orderBy": {
             "type": "string",
-            "description": "Sort order",
-            "default": "modifiedTime desc"
+            "description": "Sort order. Example: 'modifiedTime desc', 'name'"
           },
           "fields": {
             "type": "string",
-            "description": "Fields to return",
-            "default": "files(id,name,mimeType,size,modifiedTime,webViewLink,parents)"
+            "description": "Fields to return. Example: 'files(id,name,mimeType,size,modifiedTime,webViewLink,webContentLink)'. Omit for default fields."
           }
         },
         "required": [
@@ -188,6 +217,48 @@
         ]
       }
     },
+    {
+      "name": "update_file",
+      "description": "Update a file's metadata (name, description, starred, etc.) and optionally its content",
+      "method": "PATCH",
+      "path": "/drive/v3/files/{fileId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file to update"
+          },
+          "name": {
+            "type": "string",
+            "description": "New name for the file"
+          },
+          "description": {
+            "type": "string",
+            "description": "New description for the file"
+          },
+          "starred": {
+            "type": "boolean",
+            "description": "Whether to star the file"
+          },
+          "trashed": {
+            "type": "boolean",
+            "description": "Whether to move the file to trash (true) or restore it (false)"
+          },
+          "addParents": {
+            "type": "string",
+            "description": "Comma-separated parent folder IDs to add"
+          },
+          "removeParents": {
+            "type": "string",
+            "description": "Comma-separated parent folder IDs to remove"
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
     {
       "name": "share_file",
       "description": "Share a file or folder by creating a permission. Use type='anyone' for public link sharing.",
@@ -237,9 +308,131 @@
         ]
       }
     },
+    {
+      "name": "list_permissions",
+      "description": "List all permissions (who has access) for a file or folder",
+      "method": "GET",
+      "path": "/drive/v3/files/{fileId}/permissions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file or folder"
+          },
+          "fields": {
+            "type": "string",
+            "description": "Fields to return",
+            "default": "permissions(id,type,role,emailAddress,displayName,domain,expirationTime,deleted)"
+          },
+          "supportsAllDrives": {
+            "type": "boolean",
+            "description": "Support shared drives",
+            "default": true
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
+    {
+      "name": "update_permission",
+      "description": "Update an existing permission on a file (e.g. change role from reader to writer)",
+      "method": "PATCH",
+      "path": "/drive/v3/files/{fileId}/permissions/{permissionId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file or folder"
+          },
+          "permissionId": {
+            "type": "string",
+            "description": "ID of the permission to update"
+          },
+          "role": {
+            "type": "string",
+            "description": "New role",
+            "enum": [
+              "reader",
+              "writer",
+              "commenter",
+              "owner"
+            ]
+          },
+          "expirationTime": {
+            "type": "string",
+            "description": "Optional expiration time in RFC 3339 format"
+          }
+        },
+        "required": [
+          "fileId",
+          "permissionId",
+          "role"
+        ]
+      }
+    },
+    {
+      "name": "delete_permission",
+      "description": "Remove a specific permission from a file (revoke someone's access)",
+      "method": "DELETE",
+      "path": "/drive/v3/files/{fileId}/permissions/{permissionId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file or folder"
+          },
+          "permissionId": {
+            "type": "string",
+            "description": "ID of the permission to delete"
+          }
+        },
+        "required": [
+          "fileId",
+          "permissionId"
+        ]
+      }
+    },
+    {
+      "name": "trash_file",
+      "description": "Move a file or folder to the trash (can be restored later, unlike delete_file which is permanent)",
+      "method": "PATCH",
+      "path": "/drive/v3/files/{fileId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file or folder to trash"
+          },
+          "trashed": {
+            "type": "boolean",
+            "description": "Set to true to trash, false to restore from trash",
+            "default": true
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
+    {
+      "name": "empty_trash",
+      "description": "Permanently delete all files in the user's trash",
+      "method": "DELETE",
+      "path": "/drive/v3/files/trash",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "delete_file",
-      "description": "Permanently delete a file or folder from Google Drive (skips trash)",
+      "description": "Permanently delete a file or folder from Google Drive (skips trash, cannot be undone). Use trash_file for recoverable deletion.",
       "method": "DELETE",
       "path": "/drive/v3/files/{fileId}",
       "input_schema": {
@@ -247,7 +440,7 @@
         "properties": {
           "fileId": {
             "type": "string",
-            "description": "ID of the file or folder to delete"
+            "description": "ID of the file or folder to permanently delete"
           }
         },
         "required": [
@@ -357,6 +550,118 @@
         ]
       }
     },
+    {
+      "name": "create_comment",
+      "description": "Add a comment to a file in Google Drive",
+      "method": "POST",
+      "path": "/drive/v3/files/{fileId}/comments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file to comment on"
+          },
+          "content": {
+            "type": "string",
+            "description": "The text content of the comment"
+          },
+          "anchor": {
+            "type": "string",
+            "description": "Optional anchor region for the comment (JSON string)"
+          }
+        },
+        "required": [
+          "fileId",
+          "content"
+        ]
+      }
+    },
+    {
+      "name": "list_comments",
+      "description": "List all comments on a file",
+      "method": "GET",
+      "path": "/drive/v3/files/{fileId}/comments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file"
+          },
+          "pageSize": {
+            "type": "integer",
+            "description": "Max comments to return (1-100)",
+            "default": 20,
+            "maximum": 100
+          },
+          "includeDeleted": {
+            "type": "boolean",
+            "description": "Include deleted comments",
+            "default": false
+          },
+          "fields": {
+            "type": "string",
+            "description": "Fields to return",
+            "default": "comments(id,content,author,createdTime,modifiedTime,resolved,replies)"
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
+    {
+      "name": "list_revisions",
+      "description": "List the revision history of a file (version history)",
+      "method": "GET",
+      "path": "/drive/v3/files/{fileId}/revisions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string",
+            "description": "ID of the file"
+          },
+          "pageSize": {
+            "type": "integer",
+            "description": "Max revisions to return (1-1000)",
+            "default": 100,
+            "maximum": 1000
+          },
+          "fields": {
+            "type": "string",
+            "description": "Fields to return",
+            "default": "revisions(id,modifiedTime,lastModifyingUser,size,mimeType,keepForever)"
+          }
+        },
+        "required": [
+          "fileId"
+        ]
+      }
+    },
+    {
+      "name": "generate_file_ids",
+      "description": "Pre-allocate file IDs for uploads. Useful when you need the file ID before creating the file.",
+      "method": "GET",
+      "path": "/drive/v3/files/generateIds",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "integer",
+            "description": "Number of IDs to generate (1-1000)",
+            "default": 1,
+            "maximum": 1000
+          },
+          "space": {
+            "type": "string",
+            "description": "The space for the IDs",
+            "default": "drive"
+          }
+        }
+      }
+    },
     {
       "name": "get_about",
       "description": "Get information about the user's Google Drive (storage quota, user info)",

package/src/apps/google-sheets.json

@@ -2,7 +2,7 @@
   "slug": "google-sheets",
   "name": "Google Sheets",
   "description": "Google Sheets API v4 \u2014 read, write, append, clear, and batch-mutate spreadsheets. Includes the generic spreadsheets:batchUpdate endpoint which exposes every formatting / sheet-management / find-replace operation Google supports.",
-  "logo": "https://www.google.com/s2/favicons?domain=sheets.google.com&sz=128",
+  "logo": "https://upload.wikimedia.org/wikipedia/commons/3/30/Google_Sheets_logo_%282014-2020%29.svg",
   "categories": [
     "spreadsheets",
     "google",