gws-gmail

Send, read, and manage emails through the Gmail API using the gws CLI.

30.3k|1.8k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-googleworkspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
Command: npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-googleworkspace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a command-line interface for interacting with the Gmail API, enabling users to send, read, and manage their emails efficiently.

Core Features & Use Cases

  • Send Emails: Compose and send new emails.
  • Read & Manage: View inbox summaries, triage unread messages, and manage drafts.
  • Automated Responses: Reply to or forward existing messages.
  • Real-time Monitoring: Watch for and stream new emails as they arrive.

Quick Start

Use the gws-gmail skill to send an email to '[email protected]' with the subject 'Meeting Reminder' and body 'Please confirm your availability for tomorrow's meeting.'.

Frequently Asked Questions about gws-gmail

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

FAQPage Schema
How do I programmatically send and manage emails through the Gmail API?

You can programmatically send, read, and manage emails through the Gmail API using this Skill's command-line interface. It enables you to compose new messages, triage unread inbox items, and manage drafts efficiently.

Can I automate email replies and forwarding using a command-line tool?

Yes, you can automate email replies and forwarding using this command-line tool. It interfaces with the Gmail API to handle automated responses and forward existing messages without requiring manual email client interaction.

How do I monitor my Gmail inbox for new incoming messages in real-time?

To monitor your Gmail inbox for new incoming messages in real-time, you can use this Skill's real-time email monitoring feature. It watches for and streams new emails as they arrive via the Gmail API.

Do I need Google Workspace credentials to manage my Gmail inbox programmatically?

Yes, you need Google Workspace credentials to manage your Gmail inbox programmatically. This Skill requires authentication with valid Google Workspace credentials and utilizes the 'gws' CLI tool to execute API commands.

What is the best way to triage unread messages and view inbox summaries programmatically?

The best way to triage unread messages and view inbox summaries programmatically is through this Skill's Gmail API integration. It allows you to read inbox overviews, manage unread items, and organize drafts directly.