# gws-gmail

> Claude/Codex skill by [@googleworkspace](https://omgskills.com/library/googleworkspace/index.md) · 30k stars · 75k installs · Updated 2026-08-01

Gmail: Send, read, and manage email.

Tags: agent-skills, ai-agent, automation, cli, discovery-api, gemini-cli-extension, google-admin, google-api, google-calendar, google-chat, google-docs, google-drive, google-sheets, google-workspace, oauth2, rust

## Install

```sh
git clone https://github.com/googleworkspace/cli /tmp/cli && ln -s /tmp/cli/skills/gws-gmail ~/.claude/skills/gws-gmail
```

## From README

gmail (v1) PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it. Helper Commands | Command | Description | |---------|-------------| | +send | Send an email | | +triage | Show unread inbox summary (sender, subject, date) | | +reply | Reply to a message (handles threading automatically) | | +reply-all | Reply-all to a message (handles threading automatically) | | +forward | Forward a message to new recipients | | +read | Read a message and extract its body or headers | | +watch | Watch for new emails and stream them as NDJSON | API Resources users getProfile — Gets the current user's Gmail profile. stop — Stop receiving push notifications for the given user mailbox. watch — Set up or update a push notification watch on the given user mailbox.

## Links

- HTML page: https://omgskills.com/skills/googleworkspace/cli/gws-gmail/
- GitHub: https://github.com/googleworkspace/cli
- Author: [@googleworkspace](https://omgskills.com/library/googleworkspace/index.md)

## More from this repo

- [gws-sheets](https://omgskills.com/skills/googleworkspace/cli/gws-sheets/index.md) — Google Sheets: Read and write spreadsheets.
   - [@googleworkspace](https://omgskills.com/library/googleworkspace/index.md) · 31k stars
- [gws-slides](https://omgskills.com/skills/googleworkspace/cli/gws-slides/index.md) — Google Slides: Read and write presentations.
   - [@googleworkspace](https://omgskills.com/library/googleworkspace/index.md) · 30k stars
- [gws-admin-reports](https://omgskills.com/skills/googleworkspace/cli/gws-admin-reports/index.md) — Google Workspace Admin SDK: Audit logs and usage reports.
   - [@googleworkspace](https://omgskills.com/library/googleworkspace/index.md) · 30k stars