# Manage Gmail with Google Workspace CLI

Managing Gmail through API commands requires accurate resource names and parameters. This skill guides Claude and Codex through supported Gmail CLI workflows.

## Install

```bash
npx skillstore add googleworkspace/gws-gmail
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-gmail
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: regressed
- Tree hash: 43918880d489775b6257aef73f9daf7c92f0846c9db267e886658d3d8625ee18
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 81
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-gmail
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-gmail/manifest

## Capabilities

- Guides Gmail API calls through the gws command-line interface.
- Identifies resources for drafts, history, labels, messages, settings, and threads.
- Directs users to helper workflows for sending, reading, replying, forwarding, triaging, and watching email.
- Explains how to inspect method schemas before building parameters.
- Supports profile retrieval and push notification watch management.

## Use Cases

- Triage an inbox: Summarize unread messages by sender, subject, and date before choosing what needs attention.
- Automate support replies: Inspect message threads and prepare correctly threaded replies for customer conversations.
- Monitor mailbox activity: Configure Gmail watch operations and process new message notifications for an internal workflow.

## Prompt Templates

### Check my inbox

```
Show my unread Gmail messages with sender, subject, and date. Do not change any messages.
```

### Read a message

```
Find the latest message from [sender], then show its body and key headers without modifying it.
```

### Prepare a reply

```
Draft a concise reply to message [message ID]. Preserve threading and ask for confirmation before sending.
```

### Configure mailbox monitoring

```
Inspect the Gmail watch schema, propose required parameters for [topic], and configure monitoring only after approval.
```

## Limitations

- Requires the gws CLI and an authenticated Google Workspace account.
- Depends on the separate gws-shared skill for authentication and security guidance.
- Detailed helper workflows require their referenced sibling skills.
- Actual Gmail access remains limited by the authenticated account permissions.

## Best Practices

- Inspect the method schema before every unfamiliar Gmail API call.
- Confirm recipients, subject, and message content before sending or forwarding email.
- Use the narrowest account permissions that support the requested workflow.

## Anti Patterns

- Do not send, reply, or forward messages without explicit user approval.
- Do not guess resource parameters when schema inspection is available.
- Do not expose message bodies, headers, or account data beyond the requested scope.

## Security Audit

- Audited at: 2026-08-05T11:03:20.791\+00:00
- Summary: All 30 static findings are false positives caused by Markdown backticks, code fences, and fixed sibling-document links. No prompt injection or malicious intent was found.

## Stats

- Views: 85
- Downloads: 10
- Favorites: 0
- Popularity score: 0