gws-drive-upload
Allows your agent to upload files to Google Drive with automatic metadata. It's useful for organizing and finding your files.
What it does
This command sends a file from your computer to Google Drive. It also automatically adds information about the file, like its type and name.
When to use it
- ✓When you want to save an important document to Google Drive.
- ✓When you need to share a file with others.
- ✓When you want to organize your files into specific folders on Drive.
Example of what to ask your AI
“Upload the file 'my_report.docx' to my Google Drive.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You tell it which file to send and where to put it. The program handles sending and adding the details.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-drive-uploadOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-drive-upload/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
FAQ
How does it know the file type?
It looks at the end of the file name (like .pdf or .docx) to guess the type.
Can I choose a different name for the file on Drive?
Yes, you can specify a new name using the '--name' option.
Can I put the file in a specific folder?
Yes, you can indicate the folder using the '--parent' option and its ID.
Details
Original description by the author
Google Drive: Upload a file with automatic metadata.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6259
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
clickhouse-io
Helps your agent optimize queries and schemas in ClickHouse databases. It applies best practices for high-performance analytical workloads. Use when analytical queries are too slow.
affaan-m/ECC
scientific-db-pubmed-database
Helps your agent search for scientific articles in the biomedical field. It's useful for research needing specific medical information.
affaan-m/ECC
scientific-db-uspto-database
Allows the agent to look up official US patent and trademark data. It's useful for intellectual property research.
affaan-m/ECC