gmail

Manage Gmail via the Google Workspace CLI to list, search, read, and draft messages.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/dbbaskette/herald --skill gmail-dbbaskette
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/dbbaskette/herald/tree/main/skills/gmail
Command: npx skills add https://github.com/dbbaskette/herald --skill gmail-dbbaskette

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables programmatic Gmail management via the Google Workspace CLI, allowing you to list unread emails, search messages, read threads, and prepare drafts without sending them automatically.

Core Features & Use Cases

  • List unread emails
  • Search messages
  • Read thread
  • Read message
  • Create draft (safely; never send automatically)
  • List labels

Quick Start

Ask me to list unread emails or draft a reply using the Gmail CLI, and confirm any draft content before sending.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I list unread Gmail messages and read thread summaries via the command line?

You can list unread Gmail messages and read thread summaries by interfacing with the Google Workspace CLI. This allows you to quickly check your inbox and retrieve specific message content programmatically without opening a web browser.

Can I create Gmail drafts safely without automatically sending the emails?

Yes, creating Gmail drafts is enforced as a safe operation that never sends emails automatically. The system prompts for explicit user confirmation before drafting any message content, ensuring you review everything prior to manual sending.

Do I need the gws CLI installed and authenticated to search Gmail messages?

Yes, the gws CLI must be installed and authenticated to search Gmail messages. This skill acts as an interface to the Google Workspace CLI, relying on its established authentication to securely query and retrieve your email data.

What is the best way to automate quick inbox checks and draft preparation for productivity workflows?

Automating quick inbox checks and draft preparation is best handled by using the Google Workspace CLI to list unread emails and prepare drafts. This enables fast inbox triage and safe draft creation within automated productivity workflows.

Can I list and filter Gmail labels using the command line?

Yes, you can list Gmail labels using the command line. By interfacing with the Google Workspace CLI, the skill retrieves your available labels, which helps you organize and filter inbox searches programmatically.

What are the limitations of managing Gmail through the Google Workspace CLI?

A key limitation of managing Gmail through the Google Workspace CLI is that it cannot send emails directly; it is restricted to listing, searching, reading, and drafting messages to ensure safe operation and prevent accidental sends.