gws-gmail-send

Sends Gmail messages with attachments, CC/BCC, and HTML formatting via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-send-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-send
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-gmail-send
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-send-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gws.

What problem does it solve? Composing and sending Gmail messages from the command line normally requires handling RFC 5322 formatting, MIME encoding, and base64 attachments manually. This Skill wraps the gws gmail +send command so an AI agent can send emails with recipients, subjects, bodies, attachments, and aliases in one step. ## Core Features & Use Cases - Send emails with full addressing: Specify recipients with --to, --cc, --bcc, and send-as aliases via --from. - Attachments and HTML bodies: Attach multiple files (up to 25MB total) with --attach and send HTML content with --html. - Safe execution options: Preview requests with --dry-run or save messages with --draft instead of sending immediately. - Use Case: After generating a weekly report PDF, ask the agent to email it to your team with a subject line and a short HTML summary, saving it as a draft first for your review. ## Quick Start Send an email to [email protected] with the subject "Hello" and body "Hi Alice!" using the gws gmail send command.

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 with Gmail?

Use the gws gmail +send command with --to, --subject, and --body flags to send an email through your authenticated Gmail account. The command handles RFC 5322 formatting and MIME encoding automatically.

How to send an email with attachments using gws gmail?

Add the --attach (or -a) flag for each file you want to include, and it can be specified multiple times in one command. The total size of all attachments is limited to 25MB.

Can I send HTML email with gws gmail send?

Yes, pass the --html flag to treat the --body content as HTML instead of plain text. Use fragment tags like <p>, <b>, <a>, and <br> without <html> or <body> wrappers.

Can I save an email as a draft instead of sending it?

Yes, add the --draft flag to save the composed message as a Gmail draft rather than sending it immediately. You can also use --dry-run to preview the request without executing anything.

How do I send email from a different address or alias in Gmail?

Use the --from flag with a configured send-as alias address, such as --from [email protected]. If omitted, the message is sent from your account's default address.