MCPInstall
googleworkspace/cli avatar

gws-drive

Google Drive: Manage files, folders, and shared drives.

Installs
77.7K
Last 24h
+158
Trending rank
#1440
Security
Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/googleworkspace/cli --skill gws-drive
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads gws-drive automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files, each dated to when it ran.

Gen Agent Trust Hub PassSAFE ·This skill provides a comprehensive interface for managing Google Drive files, folders, and permissions using the googleworkspace vendor's CLI tool. While the functionality aligns with its stated purpose, the ability to ingest untrusted data from file contents and comments introduces a potential risk of indirect prompt injection.· Audited
Socket PassNo alerts· Audited
Snyk WarnMEDIUM ·Risk: MEDIUM · 1 issue· Audited
Runlayer PassNONE ·1 file scanned · No issues· Audited
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed· Audited

SKILL.md

The instructions your agent reads when the skill is triggered.

drive (v3)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws drive <resource> <method> [flags]

Helper Commands

CommandDescription
+uploadUpload a file with automatic metadata

API Resources

about

  • get — Gets information about the user, the user's Drive, and system capabilities. For more information, see Return user info. Required: The fields parameter must be set. To return the exact fields you need, see Return specific fields.

accessproposals

approvals

  • get — Gets an Approval by ID.
  • list — Lists the Approvals on a file.

apps

changes

channels

comments

drives

  • create — Creates a shared drive. For more information, see Manage shared drives.
  • get — Gets a shared drive's metadata by ID. For more information, see Manage shared drives.
  • hide — Hides a shared drive from the default view. For more information, see Manage shared drives.
  • list — Lists the user's shared drives. This method accepts the q parameter, which is a search query combining one or more search terms. For more information, see the Search for shared drives guide.
  • unhide — Restores a shared drive to the default view. For more information, see Manage shared drives.
  • update — Updates the metadata for a shared drive. For more information, see Manage shared drives.

files

  • copy — Creates a copy of a file and applies any requested updates with patch semantics. For more information, see Create and manage files.
  • create — Creates a file. For more information, see Create and manage files. This method supports an /upload URI and accepts uploaded media with the following characteristics: - Maximum file size: 5,120 GB - Accepted Media MIME types: */* (Specify a valid MIME type, rather than the literal */* value. The literal */* is only used to indicate that any valid MIME type can be uploaded.
  • download — Downloads the content of a file. For more information, see Download and export files. Operations are valid for 24 hours from the time of creation.
  • export — Exports a Google Workspace document to the requested MIME type and returns exported byte content. For more information, see Download and export files. Note that the exported content is limited to 10 MB.
  • generateIds — Generates a set of file IDs which can be provided in create or copy requests. For more information, see Create and manage files.
  • get — Gets a file's metadata or content by ID. For more information, see Search for files and folders. If you provide the URL parameter alt=media, then the response includes the file contents in the response body. Downloading content with alt=media only works if the file is stored in Drive.
  • list — Lists the user's files. For more information, see Search for files and folders. This method accepts the q parameter, which is a search query combining one or more search terms. This method returns all files by default, including trashed files. If you don't want trashed files to appear in the list, use the trashed=false query parameter to remove trashed files from the results.
  • listLabels — Lists the labels on a file. For more information, see List labels on a file.
  • modifyLabels — Modifies the set of labels applied to a file. For more information, see Set a label field on a file. Returns a list of the labels that were added or modified.
  • update — Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as modifiedDate. This method supports patch semantics. This method supports an /upload URI and accepts uploaded media with the following characteristics: - Maximum file size: 5,120 GB - Accepted Media MIME types: */* (Specify a valid MIME type, rather than the literal */* value.
  • watch — Subscribes to changes to a file. For more information, see Notifications for resource changes.

operations

  • get — Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

permissions

  • create — Creates a permission for a file or shared drive. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.
  • delete — Deletes a permission. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.
  • get — Gets a permission by ID. For more information, see Share files, folders, and drives.
  • list — Lists a file's or shared drive's permissions. For more information, see Share files, folders, and drives.
  • update — Updates a permission with patch semantics. For more information, see Share files, folders, and drives. Warning: Concurrent permissions operations on the same file aren't supported; only the last update is applied.

replies

revisions

  • delete — Permanently deletes a file version. You can only delete revisions for files with binary content in Google Drive, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted. For more information, see Manage file revisions.
  • get — Gets a revision's metadata or content by ID. For more information, see Manage file revisions.
  • list — Lists a file's revisions. For more information, see Manage file revisions. Important: The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision.
  • update — Updates a revision with patch semantics. For more information, see Manage file revisions.

teamdrives

  • create — Deprecated: Use drives.create instead.
  • get — Deprecated: Use drives.get instead.
  • list — Deprecated: Use drives.list instead.
  • update — Deprecated: Use drives.update instead.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws drive --help

# Inspect a method's required params, types, and defaults
gws schema drive.<resource>.<method>

Use gws schema output to build your --params and --json flags.

FAQ

What does the gws-drive skill do?

Google Drive: Manage files, folders, and shared drives.

How do I install gws-drive?

Run npx skills add https://github.com/googleworkspace/cli --skill gws-drive in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/gws-drive/ (personal) or .claude/skills/gws-drive/ (project).

Which AI agents can use gws-drive?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is gws-drive safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review; Runlayer passed; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains gws-drive?

It is published by googleworkspace/cli in googleworkspace/cli. It has 77,749 recorded installs.

More from googleworkspace/cli

View all →
googleworkspace/cli avatar

gws-gmail

googleworkspace/cli

Gmail: Send, read, and manage email.

googleworkspace/cli avatar

gws-gmail-send

googleworkspace/cli

Gmail: Send an email.

googleworkspace/cli avatar

gws-shared

googleworkspace/cli

gws CLI: Shared patterns for authentication, global flags, and output formatting.

69.1K installs
googleworkspace/cli avatar

gws-calendar

googleworkspace/cli

Google Calendar: Manage calendars and events.

googleworkspace/cli avatar

gws-sheets

googleworkspace/cli

Google Sheets: Read and write spreadsheets.

61.9K installs
googleworkspace/cli avatar

gws-docs

googleworkspace/cli

Read and write Google Docs.

Docs & Writing61.3K installs

Popular other skills

View category →
heygen-com avatar

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.6M installs
mattpocock avatar

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1.1M installs
mattpocock avatar

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

861.4K installs
mattpocock avatar

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

589.7K installs
mattpocock avatar

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

541.1K installs
mattpocock avatar

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

507.6K installs