gmail +send
SkillCommunicationgws-gmail-send is a skill that lets an AI agent send an email through Gmail. It handles the send action so the person using the agent does not have to open a mail client or copy text between windows. The skill is limited to sending; it does not read, search, or manage the inbox.
Use gmail +send in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add gmail +send and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the gmail +send skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Have a Gmail account that can send mail.
What your AI can do with it
- Send an email through Gmail
- Compose and send a message from the agent
- Use Gmail to deliver the email
Getting started
- Have a Gmail account that can send mail.
- Add the gws-gmail-send skill to your agent setup.
- Configure the Gmail credentials the skill needs.
- Ask the agent to send an email and confirm the recipient and body.
What this skill tells your AI
The instructions your AI receives, as published by googleworkspace/cli in skills/gws-gmail-send/SKILL.md and read by Ahel’s review.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Send an email
Usage
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
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com
gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com
gws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to alice@example.com --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 (, , , , etc.) — no / 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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Signals
- GitHub stars
- 31k
- Forks
- 2k
- Last commit
- Sep 2026
- Installs
- 73k installs
Ahel review
S4info
community integration, published by googleworkspace, not gmail
Automated review, not a security audit. Ruleset v1+k2.
Questions
- Does it read or search my inbox?
- No. The skill only sends email. It does not read, search, or manage the inbox.
- Can it send an email through Gmail?
- Yes. Sending an email through Gmail is the one action this skill performs.
- What do I need before using it?
- A Gmail account that can send mail, the skill added to your agent setup, and the Gmail credentials the skill needs.
- Can I schedule an email for later?
- The skill description covers sending an email. Scheduling is not mentioned, so it is not supported.
Advanced
- Item type
- skill
- Key
gws-gmail-send- Source
- github.com/googleworkspace/cli
github.com/googleworkspace/cli
More in Communication
Skill · anthropics
More in Communicationerror-handling
Skill · affaan-m
More in Communicationemails
Skill · coreyhaines31
More in Communicationwait-what
Skill · mattpocock
More in Communicationcold-email
Skill · coreyhaines31
More in Communicationazure-messaging
Skill · microsoft
More in Communication