google-drive

Use the google-api-python-client library with MediaFileUpload for uploads and MediaIoBaseDownload for downloads. This Skill wraps those calls in a CLI script supporting commands like upload, download, list, and search with a folder ID parameter.

Call the files().export_media method with the target MIME type such as application/pdf. Google Docs support pdf, docx, txt, and html exports, while Sheets support pdf, xlsx, and csv, and Slides support pdf and pptx.

You need OAuth 2.0 credentials created in Google Cloud Console with the Drive API enabled, configured as a Desktop app. Store the client ID, client secret, and project ID in a .env file, then run the login flow to authorize access.

Create a permission resource on the file with type user and a role of reader, commenter, or writer, specifying the recipient's email address. You can also disable the notification email and list existing permissions on any file.

Authentication fails when the .env file lacks GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, or GOOGLE_PROJECT_ID, or when required packages are not installed. Run the auth check script first; exit code 2 indicates missing credentials or dependencies.

By default, delete moves the file to trash by setting the trashed flag, so it can be recovered. Permanent deletion requires explicitly passing the permanent flag, which calls files().delete and cannot be undone.