gws-gmail-send
Allows your agent to send emails. Useful for automated communications or sending important information.
What it does
This command sends emails through Gmail. You can specify the recipient, subject, and body of the message.
When to use it
- ✓Sending a quick reminder to a colleague.
- ✓Sharing important information with a group.
- ✓Confirming an appointment via email.
Example of what to ask your AI
“Send an email to john@example.com with the subject 'Meeting' and the body 'Hi John, let's meet tomorrow at 10 AM.'”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You tell it who to send to, the subject, and what to write in the email body. The command handles the rest, like formatting and sending the message.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-gmail-sendOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-gmail-send/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
gmail +send
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 (<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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
FAQ
Can I send emails to multiple people?
Yes, just separate the email addresses with a comma.
Can I attach files?
Yes, using the '--attach' option followed by the filename.
Can I save the email as a draft instead of sending it?
Yes, use the '--draft' option.
Details
Popularity
- GitHub stars
- 32k
- Ranking position
- #6269
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
operator-approval-loop
Makes your agent manage message sending with human approval. It ensures important messages are reviewed before being sent.
affaan-m/ECC
discernment-nudge
Has your agent add follow-up questions after giving an important answer. It's useful for ensuring you think carefully about advice or plans before acting.
anthropics/skills
interview-me
Asks questions to understand exactly what you need. Ensures the agent grasps your real need before starting work.
addyosmani/agent-skills