Gws Drive Upload
googleworkspace/cliOfficial
A straightforward wrapper around the gws CLI that handles Google Drive uploads with automatic MIME type detection and metadata extraction. You'd reach for this when you need to programmatically upload files to specific Drive folders without manually setting file properties. It covers the common scenarios like preserving original filenames, renaming on upload, and placing files in designated parent folders. The automatic metadata detection saves you from having to specify content types for PDFs, images, or spreadsheets. Clean and focused on the upload task without trying to be a full Drive management suite.
- installs
- 49.4K
- GitHub stars
- 31.9K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-drive-upload --agent claude-codeInstalls into .claude/skills of the current project.
Files
drive +upload
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Upload a file with automatic metadata
Usage
gws drive +upload <file>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
<file> | ✓ | — | Path to file to upload |
--parent | — | — | Parent folder ID |
--name | — | — | Target filename (defaults to source filename) |
Examples
gws drive +upload ./report.pdf
gws drive +upload ./report.pdf --parent FOLDER_ID
gws drive +upload ./data.csv --name 'Sales Data.csv'
Tips
- MIME type is detected automatically.
- Filename is inferred from the local path unless --name is given.
[!CAUTION] This is a write command — confirm with the user before executing.
See Also
- gws-shared — Global flags and auth
- gws-drive — All manage files, folders, and shared drives commands
Sponsors
Details
- Repository
- github.com/googleworkspace/cli
- Categories
- CLI & Terminal, Office & Documents
