Skip to content
cccskills
FreePublished on GitHub

gws-gmail-send

Gmail helper for sending email via the gws CLI. Handles RFC 2822 formatting and base64 encoding automatically. Supports plain text, HTML, CC, and BCC.

The English summary is being prepared. Showing the original description.

Works withGmail
See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Gmail Send (gws-gmail-send)

PREREQUISITE: Read the gws-shared skill for auth, global flags, and security rules.

Send emails quickly using the gws gmail +send helper.

Usage

gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>

Flags

FlagRequiredDescription
--to✓Recipient email address(es), comma-separated
--subject✓Email subject line
--body✓Email body (plain text, or HTML when --html is set)
--cc—CC email address(es), comma-separated
--bcc—BCC email address(es), comma-separated
--html—Treat --body as HTML content
--dry-run—Show the request that would be sent, without executing

Examples

# Simple plain-text email
gws gmail +send \
  --to alice@example.com \
  --subject 'Hello from gws' \
  --body 'Hi Alice! This was sent by the gws CLI.'

# HTML email
gws gmail +send \
  --to alice@example.com \
  --subject 'Your report is ready' \
  --body '<h1>Report Ready</h1><p>Click <a href="https://example.com">here</a> to view.</p>' \
  --html

# With CC and BCC
gws gmail +send \
  --to alice@example.com \
  --subject 'Project Update' \
  --body 'See the attached notes.' \
  --cc bob@example.com \
  --bcc manager@example.com

# Preview without sending
gws gmail +send \
  --to alice@example.com \
  --subject 'Test' \
  --body 'Hello' \
  --dry-run

# Send to multiple recipients
gws gmail +send \
  --to 'alice@example.com,bob@example.com,carol@example.com' \
  --subject 'Team announcement' \
  --body 'The sprint review is tomorrow at 2pm.'

Using the Raw API (for attachments)

The +send helper does not support file attachments. Use the raw messages.send API with a multipart MIME message for attachments:

# Base64-encode an RFC 2822 message with attachment
# (compose the MIME message first, then base64-encode it)
gws gmail users messages send \
  --params '{"userId": "me"}' \
  --json '{"raw": "<base64url-encoded-mime-message>"}'

[!CAUTION] This is a write command. Always confirm with the user before sending an email. Use --dry-run to preview the request first.

Tips

  • Handles RFC 2822 formatting and base64url encoding automatically
  • For threading (replies), use gws gmail +reply instead (see gws-gmail skill)
  • For bulk email, loop over recipients and add delays to avoid rate limits
  • Always include a meaningful subject — blank subjects are marked as spam

See Also

  • gws-gmail — Full Gmail API reference (threads, labels, filters, drafts)
  • gws-shared — Authentication and global flags

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

Control a headless browser to navigate URLs, click elements, fill forms, extract content from JavaScript-rendered pages, take screenshots, and automate end-to-end web workflows.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

Review code for quality, simplicity, and maintainability. Identifies unnecessary abstractions, duplicated logic, oversized functions, missing error handling, and naming issues — then fixes them automatically before presenting the result.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

WooCommerce store operations through NV oOS Pro — product research, catalog cross-referencing, inventory lookups, and Shopify or Flowhub comparisons where integrations are configured.

The English summary is being prepared. Showing the original description.

nvdigitalsolutions/mcp-ai-wpoos7Updated Oct 23, 2026

See all skills by nvdigitalsolutions

Report a problem with this skill