Skip to content
Get packs

Gmail Send Email

Lets an agent send, draft, or attach files to Gmail emails via the gws CLI

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent to send an email from your Google account using the gws command-line tool. Once installed, when you ask the agent to email someone, it can compose the message with recipients, subject, body, CC/BCC, attachments (up to 25MB total), and HTML formatting, or save it as a draft instead. The skill itself is only instructions; the actual sending happens through the gws tool, which must already be set up and authenticated with your Google account.

Great for

  • People who want an agent to send routine emails or drafts from their Gmail account
  • Developers automating email notifications through the gws CLI
  • Users who send from a send-as alias and want the agent to pick the right sender address

Skip it if

  • Anyone who has not set up gws and signed in to Google, since the skill cannot send without it
  • Sending sensitive or irreversible messages without review, because sent email cannot be recalled and the skill tells the agent to confirm before running
  • Bulk or unsolicited mass mailing, which this single-recipient-style command is not designed for and which may breach Gmail policies

Try asking

  • “Send an email to alice@example.com with the subject 'Hello' and a short greeting”
  • “Draft an email with the Q3 report attached as report.pdf but don't send it yet”
  • “Send an HTML-formatted update with bold text, CC my manager”
  • “Send an email from my alias address alias@example.com”
Step-by-step guide: how to use Gmail Send EmailInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-gmail-send.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-gmail-send.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-gmail-send.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to show a --dry-run preview or draft first, then confirm the recipients and content before it sends
  • Double-check recipient addresses, since sent email cannot be undone
  • Use --draft when you want to review the message in Gmail before it goes out

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.