
Gws Drive Upload
- 39.1k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws-drive-upload is an agent skill that Google Drive: Upload a file with automatic metadata.
About
Google Drive: Upload a file with automatic metadata. --- name: gws-drive-upload description: "Google Drive: Upload a file with automatic metadata." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws drive +upload --help" --- # 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 ```bash 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 ```bash 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.
- MIME type is detected automatically.
- Filename is inferred from the local path unless --name is given.
- [gws-shared](../gws-shared/SKILL.md) - Global flags and auth
- [gws-drive](../gws-drive/SKILL.md) - All manage files, folders, and shared drives commands
- If missing, run `gws generate-skills` to create it.
Gws Drive Upload by the numbers
- 39,079 all-time installs (skills.sh)
- +1,365 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #9 of 2,209 Security skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-drive-upload capabilities & compatibility
- Capabilities
- mime type is detected automatically. · filename is inferred from the local path unless · [gws shared](../gws shared/skill.md) — global fl · [gws drive](../gws drive/skill.md) — all manage · if missing, run `gws generate skills` to create
- Use cases
- documentation
What gws-drive-upload says it does
If missing, run `gws generate-skills` to create it.
- 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](../gws-shared/SKILL.md) — Global flags and auth - [gws-drive](../gws-drive/SKILL.md) — All manage files, folders, and shared drives commands
npx skills add https://github.com/googleworkspace/cli --skill gws-drive-uploadAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 39.1k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
What problem does gws-drive-upload solve for developers using this skill?
Google Drive: Upload a file with automatic metadata.
Who is it for?
Developers who need gws-drive-upload patterns described in the cached skill documentation.
Skip if: Skip when docs are empty or the task is outside the skill's documented scope.
When should I use this skill?
Google Drive: Upload a file with automatic metadata.
What you get
Actionable workflows and conventions from SKILL.md for gws-drive-upload.
- uploaded drive files
- drive api upload responses
By the numbers
- Skill metadata version 0.22.5
- One required positional argument: local file path
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
Related skills
How it compares
Use gws-drive-upload instead of raw Drive API SDKs when your automation already runs through `gws` and you only need a single-file upload with folder targeting.
FAQ
What does gws-drive-upload do?
Google Drive: Upload a file with automatic metadata.
When should I use gws-drive-upload?
Google Drive: Upload a file with automatic metadata.
Is gws-drive-upload safe to install?
Review the Security Audits panel on this page before installing in production.