skills.rest
cellarwood
cellarwoodOFFICIAL
Explore all skills by this author →
GitHub

gws-gmail-send

Send Gmail messages with attachments and CC/BCC via command-line interface.

Updated Apr 6, 2026
Search Tags:#email#gmail#attachments#drafts#send#gws
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-gmail-send-cellarwood
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-send
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-gmail-send
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-gmail-send-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a simple, scriptable way to compose and send emails from a Google Workspace/Gmail account without using the web UI, reducing manual copy-paste and enabling automation for notifications, reports, and outreach.

Core Features & Use Cases

  • Compose and send messages: Specify recipients, subject, and body from the CLI.
  • Attachments and formatting: Add multiple attachments, send plain text or HTML, and rely on automatic MIME and base64 encoding.
  • Aliases, drafts, and dry runs: Use send-as aliases, save messages as drafts, or preview the request with a dry-run before sending.
  • Use Case: Automate transactional notifications from backend scripts, send marketing test emails, or quickly dispatch one-off messages during workflow runs.

Quick Start

Run gws gmail +send with --to, --subject, and --body to deliver an email or add --draft to save it without sending.

Frequently Asked Questions about gws-gmail-send

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send Gmail messages from a command-line script?▼

To send Gmail messages from a command-line script, use the gws CLI to specify recipients, subject, and body. This enables automated email notifications and outreach without the web UI.

Can I attach files to emails sent via the command line?▼

Yes, you can attach files to emails sent via the command line. The CLI supports multiple attachments with automatic MIME and base64 encoding, accommodating file sizes up to 25MB.

Do I need Google Workspace credentials configured to send Gmail this way?▼

Yes, you need an installed gws CLI with Google Workspace credentials configured. This authenticated setup is required to compose, attach, and deliver emails from your account.

Is it possible to save an email as a draft instead of sending it immediately?▼

Yes, it is possible to save an email as a draft instead of sending it immediately. Add the --draft flag to your command to save the composed message without delivering it.

What is the best way to preview a Gmail send request before delivery?▼

The best way to preview a Gmail send request before delivery is to use the dry-run mode. This flag allows you to verify recipients, body, and attachments without actually sending the message.

Can I use send-as aliases and BCC recipients when sending Gmail from the CLI?▼

Yes, you can use send-as aliases and BCC recipients when sending Gmail from the CLI. The tool exposes flags for managing CC and BCC, using aliases, and sending HTML or plain-text bodies.

Related Skills

Explore More Content & Communication Skills→
googleworkspacegoogleworkspace
30.3k

gws-gmail

Send, read, and manage emails through the Gmail API using the gws CLI.

Official
Intermediate
sliamh11sliamh11
50

add-gmail

Integrate Gmail with Deus for read, send, search, and draft actions.

Community
Advanced
Tommy-ywTommy-yw
539

google-workspace

Integrate Gmail, Calendar, Drive, and Contacts with Hermes via Google Workspace APIs.

Community
Advanced
MOODMNKY-LLCMOODMNKY-LLC

himalaya

Manage IMAP/SMTP email messages directly from the shell.

Community
Intermediate