gws-gmail

Name: gws-gmail
Availability: InStock
Author: cellarwood

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

Updated Apr 6, 2026

Search Tags:#automation #cli #email #notifications #gmail #gws

Ready to run

npx skills add https://github.com/cellarwood/figurio --skill gws-gmail-cellarwood

💬 Prompt for ChatGPT / Claude Chat▼

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.