Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-gmail-send — Claude Code skill: send Gmail email

A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add googleworkspace/cli --skill gws-gmail-send -a claude-code
Open on GitHub

What gws-gmail-send does

The skill hands the agent one command for outgoing mail: gws gmail +send. Three flags are required — --to, --subject and --body. The rest you add as needed.

SKILL.md holds a flag table, worked examples and a pointer to ../gws-shared/SKILL.md for auth, global flags and security rules. RFC 5322 formatting, MIME encoding and base64 are the command's problem, not yours. Attachments go through -a/--attach, the flag repeats, and the total size cap is 25MB. There is --cc and --bcc, --from for a send-as alias, --html for fragment markup without an ` wrapper, --draft to save instead of send, and --dry-run` to see the request first.

You need the gws binary and the shared skill file; if that file is missing, gws generate-skills writes it. This is a write command, so the agent is expected to confirm with you before it fires. Worth installing if your mail already runs through gws. For one message, the web UI is less setup.

What it helps with

  • send a short email from the terminal without opening a browser
  • park a reply as a Gmail draft with --draft
  • attach two files and let the command deal with MIME and base64
  • preview the outgoing request with --dry-run before anything leaves
  • copy teammates in with --cc and --bcc in the same call

Example prompts for the agent

  • Send an email to [email protected], subject Hello, body Hi Alice!
  • Save that as a Gmail draft, do not send it yet.
  • Attach report.pdf and data.csv and put [email protected] on cc.

How to install gws-gmail-send

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-gmail-send -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-gmail-send/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-gmail-send/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs gws-docs-write official googleworkspace Appends plain text to the end of a Google Docs document through gws. Use it when an agent needs to write a result into a specific document. Claude Code CX Codex Cursor +1 50,100installs

Similar

planning-with-files OthmanAdi Keeps task plans and progress in local Markdown files. Useful for agent tasks and research requiring five or more tool calls. Claude Code CX Codex Cursor +1 46,900installs diagnosing-superpowers Jesse Vincent Investigates a failed Superpowers session through its transcripts and builds an evidence-based report. Use it when work repeats, plans are ignored, or a skill fails to fire. Claude Code CX Codex 19,996installs cold-email coreyhaines31 A skill that drafts cold B2B emails and follow-ups, sets up sending on secondary domains, and keeps email and LinkedIn cadences in step. Claude Code CX Codex Cursor +1 127,200installs site-architecture coreyhaines31 Plans a site's page hierarchy, navigation, URL patterns and internal links. Useful before you build, or when visitors can't find their way around. Claude Code CX Codex Cursor +1 122,300installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs

Questions about gws-gmail-send

How do I install gws-gmail-send in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-gmail-send -a claude-code. The skill lands at ~/.claude/skills/gws-gmail-send/SKILL.md.

What does gws-gmail-send do?

It wraps gws gmail +send, which builds and sends a message through Gmail. Drafts, attachments and send-as aliases are covered too.

What do I need before using it?

The gws binary plus the shared ../gws-shared/SKILL.md file that carries the auth setup. If that file is absent, gws generate-skills creates it.

Source text

SKILL.md · Apache-2.0 
---
name: gws-gmail-send
description: "Gmail: Send an email."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail +send --help"
---

# gmail +send

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

Send an email

## Usage

```bash
gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--to` | ✓ | — | Recipient email address(es), comma-separated |
| `--subject` | ✓ | — | Email subject |
| `--body` | ✓ | — | Email body (plain text, or HTML with --html) |
| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
| `--attach` | — | — | Attach a file (can be specified multiple times) |
| `--cc` | — | — | CC email address(es), comma-separated |
| `--bcc` | — | — | BCC email address(es), comma-separated |
| `--html` | — | — | Treat --body as HTML content (default is plain text) |
| `--dry-run` | — | — | Show the request that would be sent without executing it |
| `--draft` | — | — | Save as draft instead of sending |

## Examples

```bash
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --cc [email protected]
gws gmail +send --to [email protected] --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --from [email protected]
gws gmail +send --to [email protected] --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to [email protected] --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --draft
```

## Tips

- Handles RFC 5322 formatting, MIME encoding, and base64 automatically.
- Use --from to send from a configured send-as alias instead of your primary address.
- Use -a/--attach to add file attachments. Can be specified multiple times. Total size limit: 25MB.
- With --html, use fragment tags (<p>, <b>, <a>, <br>, etc.) — no <html>/<body> wrapper needed.
- Use --draft to save the message as a draft instead of sending it immediately.

> [!CAUTION]
> This is a **write** command — confirm with the user before executing.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor