Gws Drive
With Gws Drive, Claude controls your Google Drive through the gws CLI: you have it search, upload, copy and export files and manage shared drives.
What is Gws Drive?
Gws Drive is a skill for Claude that connects the Google Workspace command line tool gws with version 3 of the Drive API. It tells Claude which resources and methods exist, so the agent can work with files, folders and shared drives in your Google Drive. The skill comes from the googleworkspace/cli repository and is at version 0.22.5.
The skill organizes the Drive API by resources such as files, drives, comments, changes, approvals and accessproposals. Through them Claude calls methods like list, get, copy, export or update. For uploads there is the helper command '+upload', which fills in metadata automatically. You get an overview of all options with 'gws drive --help'.
Gws Drive suits teams that use Google Workspace and want to handle file work from the terminal or through an agent. You need the gws program installed on your machine. Authentication, global flags and security rules live in a shared skill called gws-shared, which you can create with 'gws generate-skills' if it is missing.
Who it is for
For teams and individuals who work in Google Workspace and want to handle files, comments and shared drives in Google Drive through an agent or the command line.
Use cases
- You want to find every file for a project in Drive and see their metadata in one place without clicking through folders.
- You set up a shared drive for a new client project and have Claude copy your templates into it.
- You export a Google document to a different file format so you can pass it to partners outside Google Workspace.
What Gws Drive does
Search and list files
With files list and the q parameter, Claude combines search terms. Trashed files are included by default, and trashed=false removes them from the results.
Upload with '+upload'
The helper command '+upload' uploads a file to Drive and adds its metadata automatically, so you do not have to specify each field yourself.
Copy, export, download
Using copy, download and export, Claude creates copies, downloads content or converts Google documents to another format. Exports are limited to 10 MB.
Manage shared drives
The drives resource lets Claude create, list and update shared drives, and hide them from or restore them to the default view.
Comments and access requests
Claude can create, read, update and delete comments on files. It can also list pending access proposals and approve or deny them if you are an approver.
Track changes
With changes list and watch, Claude retrieves changes in your Drive or a shared drive, or subscribes to notifications about them.
Say this to activate the skill
"List my Google Drive files for the website project.""Upload this report to my Drive with +upload.""Create a new shared drive for the sales team.""Export the meeting notes Google document as a PDF." Install
npx skills add googleworkspace/cli --skill gws-drive
The command installs the original version from the author's repository (Vercel skills CLI, needs Node.js), add -g for all projects. We do not host a copy: updates come straight from the author. Need help with setup? How to install skills →
Figures with source and date
- GitHub stars
- ≈ 32,400
- Installs
- 77,944
- On skills.sh since
- 4 Mar 2026
- Last change in the repository
- 30 Oct 2026
- Licence
- Apache-2.0
As of 19 Nov 2026. Sources: GitHub, skills.sh. The figures change daily; we show the state of our last lookup.
Checked automatically
- Automated check on 2026-11-19 (revision cd3697e): 1 files in the skill folder read by pattern search. It found no hidden characters, no instructions to override rules, no download-and-run and no access to credentials.
Independent checks on skills.sh, as of 19 Nov 2026
| Gen Agent Trust Hub | Pass |
|---|---|
| Socket | Pass |
| Snyk | Warn |
Good to know
- Gws Drive requires the gws program and relies on the gws-shared skill for authentication and security rules, which must be present.
- The skill can change or delete files, comments and shared drives. Review what you ask Claude to do before running it against production folders.
- File listings include trashed files by default. Add trashed=false if you do not want deleted files to appear.
- One auditor on skills.sh reports a warning (Snyk). Read its notes before bringing the skill into projects with sensitive data.
- The check is an automated pattern search, not a security guarantee, and reads the skill folder only. The command always installs the author's current version; later versions have not been reviewed by us.
Frequently asked questions about Gws Drive
What is Gws Drive?
Gws Drive is a skill for Claude that makes the Google Drive API usable through the gws command line tool. With it, Claude can manage files, folders, comments and shared drives in Google Drive.
How do I install Gws Drive?
You install Gws Drive with 'npx skills add googleworkspace/cli --skill gws-drive'. You also need the gws program. If the shared skill gws-shared with authentication and rules is missing, create it with 'gws generate-skills'.
Is Gws Drive free?
Gws Drive is licensed under Apache-2.0, so you can use it freely. You need a Google account with Drive access. The skill does not state any costs on the Google side.
Who is Gws Drive for?
Gws Drive is worth it if your team uses Google Workspace and you want to hand recurring file work such as searching, uploading, copying or exporting to Claude instead of doing it in the web interface.
What data does Gws Drive send?
Gws Drive sends requests through the gws CLI to the Google Drive API. Files, metadata and comments move between your machine and your Google account. Authentication and security rules are handled by the shared skill gws-shared.
Share this skill
About this skill
Gws Drive comes from googleworkspace and is an open-source project maintained by its author and community.
Author: googleworkspace / github.com. Source: github.com/googleworkspace/cli/tree/main/skills/gws-drive. Licence: Apache-2.0.
Curated by Collective Brain, an AI and automation digital agency from Hamburg, together with WhiteFox Automations. More vetted skills in the skills catalog.
Working in Germany, Austria or Switzerland? We help teams roll out Claude, in English or German.
Want this skill tailored to your team?
Gws Drive is a strong starting point. A skill gets really powerful once it knows your workflows, templates and tone of voice. We build custom skills for teams, from analysis to rollout, and connect them to our work in AI consulting.
Request a custom skill →