skills.rest
omriariav
omriariavCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-gmail

Manage Gmail inbox operations via command-line interface with JSON output.

7|2|Updated Jan 22, 2026
Search Tags:#automation#communication#cli#email#gmail#gws
One-click install
npx skills add https://github.com/omriariav/workspace-cli --skill gws-gmail
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/omriariav/workspace-cli/tree/main/skills/gmail
Command: npx skills add https://github.com/omriariav/workspace-cli --skill gws-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to manage their Gmail inbox, send emails, and organize messages directly from the command line, streamlining communication workflows.

Core Features & Use Cases

  • Email Management: List, read, archive, trash, and delete emails and threads.
  • Sending & Replying: Compose and send new emails or reply to existing ones.
  • Label Management: Create, update, delete, and apply labels to messages.
  • Drafts & Attachments: Manage draft emails and download attachments.
  • Use Case: A user needs to quickly find all unread emails from their manager and reply to the most recent one with a brief confirmation.

Quick Start

Use the gws-gmail skill to list the 5 most recent unread emails in your inbox.

Frequently Asked Questions about gws-gmail

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

FAQPage Schema
How do I manage Gmail from the command line?▼

You can manage Gmail from the command line by using the gws CLI tool to list, read, send, archive, and trash emails. It requires OAuth2 authentication for Google Workspace access.

Can I send emails and manage attachments via a terminal interface?▼

Yes, you can send emails and manage attachments via a terminal interface. The Skill supports composing new emails, replying to threads, and downloading attachments directly from the command line.

Does this Gmail CLI tool support structured output for automation scripts?▼

Yes, the Gmail CLI tool supports structured JSON output for scripting and automation. This allows you to programmatically parse email data, list unread messages, and manage labels within automated workflows.

What do I need to set up before using a CLI to read Gmail messages?▼

Before using the CLI to read Gmail messages, you need the gws CLI tool installed and OAuth2 authentication configured for Google Workspace access. This setup enables secure terminal-based email management.

How do I organize inbox messages and labels without a graphical interface?▼

You can organize inbox messages and labels without a graphical interface by using CLI commands to create, update, delete, and apply labels to messages. This allows you to archive or trash emails directly from your terminal.

Related Skills

Explore More Software Engineering Skills→
Oruga420Oruga420

gws-installer

Install and configure the Google Workspace CLI for terminal access.

Community
Advanced
JingyueCongJingyueCong

gmail-automation

Automate Gmail sending, replying, searching, labeling, and draft management.

Community
Advanced
ckorhonenckorhonen
12

google

Manage Gmail, Calendar, Drive, Sheets, Tasks, and Contacts via gog CLI.

Community
Intermediate
ashiqcodeleafashiqcodeleaf

himalaya

Manage emails via IMAP and SMTP protocols from the command line using Himalaya CLI.

Community
Intermediate