drive +upload

SkillFiles & storage

gws-drive-upload is a skill that lets an AI agent upload a file to Google Drive with metadata filled in automatically. It handles the upload and the metadata in one step, so the person using the agent does not have to set fields by hand. The skill is for tasks where a file needs to be placed in Drive and described correctly.

Use drive +upload in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add drive +upload and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the drive +upload skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have a Google account with access to Google Drive.

drive +uploadStart free

What your AI can do with it

  • Upload a file to Google Drive
  • Fill in file metadata automatically during upload
  • Handle the upload and metadata in one step

Getting started

  1. Have a Google account with access to Google Drive.
  2. Add the gws-drive-upload skill to your agent setup.
  3. Configure the skill with the credentials it needs for Google Drive.
  4. Give the agent a file and ask it to upload the file to Drive.

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/gws-drive-upload/SKILL.md and read by Ahel’s review.

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

FlagRequiredDefaultDescription
<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

Signals

GitHub stars
31k
Forks
2k
Last commit
Sep 2026

Questions

What kind of tool is gws-drive-upload?
It is a skill for an AI agent. It uploads a file to Google Drive and fills in the file metadata automatically.
What does gws-drive-upload do?
It uploads a file to Google Drive with metadata filled in automatically, so the agent does not need separate steps for the upload and the metadata.
Does gws-drive-upload work with any file type?
The item does not state which file types are supported.
Can I choose which metadata fields get filled in?
The item does not state whether the metadata fields can be chosen.
What do I need before using gws-drive-upload?
You need a Google account with access to Google Drive, and the skill must be added and configured with the credentials it needs.
Advanced
Item type
skill
Key
gws-drive-upload
Source
github.com/googleworkspace/cli