# Send Gmail Messages from the Command Line

Preparing Gmail commands with recipients, content, copies, and attachments can be error-prone. This skill guides Claude and Codex through safe gws message sending.

## Install

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

## Metadata

- Status: approved
- Slug: googleworkspace-gws-gmail-send
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: 64cb35bb40ea133235420b49494794a47d8c3b5262d6cafb2c538724e36e575b
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-send/
- 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: 80
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-gmail-send
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-gmail-send/manifest

## Capabilities

- Sends Gmail messages to one or more comma-separated recipients.
- Supports plain-text and HTML message bodies.
- Adds CC and BCC recipients when requested.
- Attaches one or more files within Gmail size limits.
- Sends from a configured alias or the default account.
- Previews requests with dry-run or saves messages as drafts.

## Use Cases

- Send a client update: Prepare and send a clear status email with an optional report attachment.
- Draft an internal announcement: Create an HTML announcement as a Gmail draft for review before delivery.
- Deliver generated reports: Send scheduled report files to defined recipients with copies and a concise message.

## Prompt Templates

### Send a simple email

```
Send a Gmail message to [recipient] with subject [subject] and body [message]. Confirm the final details before sending.
```

### Create a reviewed draft

```
Create a Gmail draft to [recipients] about [topic]. Use subject [subject] and include these points: [points].
```

### Send a formatted attachment

```
Prepare an HTML Gmail message to [recipient] with [file] attached. Use [alias] as sender and show a dry run first.
```

### Coordinate a multi-recipient delivery

```
Prepare Gmail delivery to [to], copy [cc], and blind-copy [bcc]. Attach [files], validate the 25 MB limit, then request confirmation.
```

## Limitations

- Requires the gws CLI and an authenticated Google Workspace account.
- Attachments have a combined 25 MB size limit.
- Sender aliases must already be configured in Gmail.
- This skill does not read, search, or manage existing messages.

## Best Practices

- Use dry-run to review recipients, sender, subject, and request details.
- Confirm with the user immediately before sending any message.
- Prefer drafts when content, recipients, or attachments need human review.

## Anti Patterns

- Do not send messages without explicit user confirmation.
- Do not expose recipients through CC when BCC is appropriate.
- Do not attach sensitive files without verifying the path and intended audience.

## Security Audit

- Audited at: 2026-08-05T11:09:40.102\+00:00
- Summary: All 17 static findings are false positives caused by Markdown code fences, inline code, and fixed relative documentation links. The skill documents an intended gws Gmail send command and requires user confirmation before its external write action. No prompt injection or hidden exfiltration intent was found.

## Stats

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