gws-gmail-send

Send Gmail emails from the command line with attachments and HTML bodies.

2|1|Updated Jan 31, 2014
One-click install
npx skills add https://github.com/mattforni/homebase --skill gws-gmail-send-mattforni
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-send
Source: https://github.com/mattforni/homebase/tree/main/.claude/skills/gws-gmail-send
Command: npx skills add https://github.com/mattforni/homebase --skill gws-gmail-send-mattforni

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables sending Gmail messages directly from the command line, removing the need to open a mail client for routine communications and notifications.

Core Features & Use Cases

  • Send emails via Gmail from the CLI with required --to, --subject, and --body.
  • Optional features include --from to use a send-as alias, --attach for attachments, and --cc/--bcc for recipients; it also supports --html for HTML bodies and --draft to save drafts.
  • Typical use cases include automated status updates, alerts, and team notifications wired into scripts or cron jobs.

Quick Start

Use gws gmail +send with --to, --subject, and --body to send your first email.

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 an email from the command line using Gmail?▼

You can send Gmail emails from the command line by providing the --to, --subject, and --body arguments. This enables automation-friendly email dispatch directly within CLI workflows without opening a mail client.

Can I send HTML emails and attachments from a CLI workflow?▼

Yes, sending HTML emails and attachments from a CLI workflow is supported. You use the --html flag to send HTML bodies and the --attach flag to include file attachments in your Gmail messages.

What is the best way to automate Gmail notifications in cron jobs?▼

Automating Gmail notifications in cron jobs is best done by calling the CLI email command with --to, --subject, and --body. This allows scripts to dispatch automated status updates and alerts without manual intervention.

Does this Gmail CLI tool support CC, BCC, and custom From aliases?▼

Yes, the Gmail CLI tool supports CC, BCC, and custom From aliases. You can use --cc for carbon copies, --bcc for blind copies, and --from to send from a configured send-as alias.

Can I save a Gmail message as a draft from the command line instead of sending it?▼

Yes, you can save a Gmail message as a draft from the command line. By using the --draft flag instead of sending immediately, the message is saved to your drafts folder for later review.