# google-workspace-cli

This skill lets an agent use the gws CLI for Google Workspace tasks, from handling Gmail and Drive to creating Calendar events. Use it to automate work across Workspace services.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 455 installs · ★ 291
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/google-workspace-cli/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/hoodini-google-workspace-cli

## What it does

The skill guides an agent to use `gws` for Google Workspace APIs. It can help manage Drive files, read and send Gmail, work with Calendar, Sheets, Docs and Slides, and access other Workspace services. The CLI builds its commands from Google's Discovery Service at runtime and returns structured JSON.

You need Node.js 18+, a Google Cloud project for OAuth, and a Google account with Workspace access. After installing the CLI, configure access with `gws auth setup` and `gws auth login`. Testing-mode OAuth apps have a limit of about 25 scopes, so the recommended preset of 85+ scopes will fail. Google does not officially support this project, and active development means commands may change before v1.0.

## Requirements
- Works with: Google Workspace, Gmail

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/google-workspace-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/google-workspace-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/google-workspace-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/google-workspace-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills google-workspace-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/google-workspace-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/google-workspace-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/google-workspace-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/google-workspace-cli/SKILL.md

## When to use it
- find files in Google Drive
- read or send Gmail messages
- create a Google Calendar event
- fetch data from Google Sheets
- write content to Google Docs

## Example prompts
- Find recent files in Google Drive and list their names.
- Read Gmail messages about the report and summarize them.
- Create a Google Calendar event from these details.

## Similar
- [pptx](https://affpapa.org/en/nevibecode/skills/pptx.md) — skill · 241433 installs
- [pdf](https://affpapa.org/en/nevibecode/skills/pdf.md) — skill · 216041 installs
- [docx](https://affpapa.org/en/nevibecode/skills/docx.md) — skill · 206304 installs
- [xlsx](https://affpapa.org/en/nevibecode/skills/xlsx.md) — skill · 187223 installs
- [brand-guidelines](https://affpapa.org/en/nevibecode/skills/brand-guidelines.md) — skill · 109043 installs
- [theme-factory](https://affpapa.org/en/nevibecode/skills/theme-factory.md) — skill · 94921 installs

## Other versions with the same name
- [google-workspace-cli · alirezarezvani](https://affpapa.org/en/nevibecode/skills/google-workspace-cli.md) — 636 installs

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 7 cards

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