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

gws-gmail

Manage Gmail messages and mailboxes via the gws command-line interface.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable programmatic access to Gmail so teams and automation pipelines can send, read, and manage email without manual use of the web UI.

Core Features & Use Cases

  • Send messages and create drafts through the gws CLI for transactional or campaign emails.
  • Read, thread, reply, reply-all, forward, label, and search messages for support workflows and inbox triage.
  • Watch mailboxes and stream new messages for real-time processing and notification pipelines.
  • Use Case: Automate support inbox triage to surface unread messages, reply with templates, and label processed conversations.

Quick Start

Send a Gmail message to [email protected] with subject Project Update and body Please find the latest deliverables attached.

Frequently Asked Questions about gws-gmail

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

FAQPage Schema
How do I automate sending Gmail messages from a command-line interface?▼

You can automate sending Gmail messages by using the gws CLI to programmatically send transactional emails or create drafts. This enables pipeline-driven email automation without manual web UI interaction.

Can I read, label, and reply to Gmail threads for support inbox triage via CLI?▼

Yes, the gws CLI supports reading, threading, replying, replying-all, forwarding, and labeling Gmail messages. This allows automated support workflows to surface unread messages and label processed conversations.

What is the best way to watch a Gmail mailbox for new messages in real-time automation?▼

The best way to stream new Gmail messages for real-time pipelines is using the gws CLI's mailbox watch subscriptions. This enables notification pipelines to process incoming messages automatically.

Does Gmail automation via CLI work with both individual accounts and Google Workspace?▼

Yes, Gmail CLI automation applies to both individual Gmail accounts and Google Workspace environments. It requires gws CLI access configured with OAuth-based credentials.

How do I search and forward specific Gmail conversations programmatically?▼

You can search and forward specific Gmail conversations programmatically through gws CLI commands. The CLI supports message searching, threading, and forwarding to automate integration scenarios.

Do I need OAuth credentials to manage Gmail mailboxes through a command-line interface?▼

Yes, OAuth-based credentials are required to authenticate and manage Gmail mailboxes through the gws CLI. This ensures secure programmatic access for sending, reading, and labeling messages.

Related Skills

Explore More Content & Communication Skills→
alanmunalanmun

add-gws

Integrate Google Workspace CLI with OAuth and MCP server registration.

Community
Intermediate
73ai73ai
4

recipe-forward-labeled-emails

Forward Gmail messages with a specific label to a designated recipient.

Official
Intermediate
cellarwoodcellarwood

gws-gmail-watch

Stream new Gmail messages as NDJSON via Google Cloud Pub/Sub.

Official
Intermediate
sixtycat2000-ctrlsixtycat2000-ctrl
3

imap-smtp-email

Manage email communication via IMAP and SMTP protocols.

Community
Intermediate