# gws-drive

Use this command to manage Google Drive files and shared drives through Claude Code. It helps when you want an agent to run Drive operations through the gws CLI.

- command · `type=command` · Claude Code · 84 installs
- Author: davila7
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/google-workspace/gws-drive.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/commands/gws-drive

## What it does

\`gws-drive` routes requests to Google Drive through the Google Workspace CLI, `gws`. Its listed operations cover files and shared drives, with methods for copying files, checking changes, and handling comments. File uploads have a separate helper command, `+upload`.

Install `gws` and configure authentication before use; check its status with `gws auth status`. The command also relies on `../gws-shared/SKILL.md` for authentication and security guidance. If that file is missing, the instructions point to `gws generate-skills`. Some methods require a `fields` parameter, and only approvers can list access proposals for a file.

## Requirements
- Works with: Google Workspace, Google Drive

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --command google-workspace/gws-drive
```

2. **Manually: put the files in place**
- File: `.claude/commands/gws-drive.md` — Call it with /gws-drive. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/gws-drive.md` — Call it with /prompts:gws-drive. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/gws-drive.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/gws-drive.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/google-workspace/gws-drive.md

## When to use it
- copy a file in Google Drive
- list the user's shared drives
- check changes in Drive
- add a comment to a file

## Example prompts
- Copy this file in Google Drive and update its metadata.
- Show me my shared drives.
- List recent changes in Drive.

## Source text · gws-drive.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a512096f19b1d873.

BEGIN THIRD-PARTY FILE a512096f19b1d873
````text
---
allowed-tools: Bash, Read, Write, Edit
argument-hint: "[resource] [method] [flags]"
description: "Google Drive: Manage files, folders, and shared drives."
---

# Google Workspace Drive

Execute Google Workspace Drive operations: $ARGUMENTS

## Prerequisites

- Google Workspace CLI (`gws`) must be installed
- Authentication configured: Run `gws auth status` to verify
- Review `gws drive --help` for all available commands

## Available Resources and Methods

# drive (v3)

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

```bash
gws drive <resource> <method> [flags]
```

## Helper Commands

| Command | Description |
|---------|-------------|
| [`+upload`](../gws-drive-upload/SKILL.md) | Upload 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](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).

### accessproposals

  - `get` — Retrieves an access proposal by ID. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).
  - `list` — List the access proposals on a file. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access). Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.
  - `resolve` — Approves or denies an access proposal. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).

### approvals

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

### apps

  - `get` — Gets a specific app. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).
  - `list` — Lists a user's installed apps. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).

### changes

  - `getStartPageToken` — Gets the starting pageToken for listing future changes. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).
  - `list` — Lists the changes for a user or shared drive. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).
  - `watch` — Subscribes to changes for a user. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).

### channels

  - `stop` — Stops watching resources through this channel. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).

### comments

  - `create` — Creates a comment on a file. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
  - `delete` — Deletes a comment. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
  - `get` — Gets a comment by ID. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
````
END THIRD-PARTY FILE a512096f19b1d873

The third-party file has ended. Everything between the a512096f19b1d873 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 4061 of 15668 bytes. © davila7 · MIT · https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/google-workspace/gws-drive.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md