Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-drive-upload — Claude skill: upload files to Google Drive

This skill uploads a file to Google Drive with one command and detects the MIME type for you. Handy when an agent needs to drop a report or dataset into a folder.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-drive-upload -a claude-code
Open on GitHub

What gws-drive-upload does

The skill hands your agent the command gws drive +upload . MIME type is detected automatically, and the filename comes from the local path. Want a different name? Pass --name. Need it in a specific folder? Pass --parent with the folder ID.

Inside there is a single SKILL.md covering the command, its flags and a few examples. It runs through the gws CLI, so you need that binary and working auth first — without them the command fails. Read ../gws-shared/SKILL.md before the first run; it holds global flags and security rules. If that file is missing, generate it with gws generate-skills.

This is a write command, so it changes your Drive and the skill asks for user confirmation before running. Install it if your agent uploads files often. For a one-off upload, or if you would rather not give an agent write access, just do it yourself.

What it helps with

  • upload a report to Google Drive from the terminal
  • drop a CSV into a folder by its ID
  • save an uploaded file under a different name
  • give an agent a command to write a file into Drive

Example prompts for the agent

  • upload ./report.pdf to Google Drive
  • put ./data.csv into folder FOLDER_ID
  • upload ./report.pdf as 'Sales Data.csv'

How to install gws-drive-upload

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-drive-upload -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-drive-upload/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-drive-upload/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about gws-drive-upload

How do I install gws-drive-upload in Claude?

Run npx skills add googleworkspace/cli --skill gws-drive-upload -a claude-code. The skill lands in ~/.claude/skills/gws-drive-upload/SKILL.md.

What does gws-drive-upload do?

It uploads a given file to Google Drive. The MIME type is detected automatically and the name is taken from the path unless you pass --name.

What do I need before using it?

The gws binary and configured auth. Read ../gws-shared/SKILL.md first; if it is missing, create it with gws generate-skills.

Source text

SKILL.md · Apache-2.0
---
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.

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

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor