Gws Drive Upload

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.

skills.sh installs: 50.6K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-drive-upload --agent claude-code

Installs into .claude/skills of the current project.

Files

drive +upload

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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.

Details

Repository: github.com/googleworkspace/cli
Categories: CLI & Terminal, Office & Documents