gws-gmail

Automate Gmail mailbox operations for sending, reading, and organizing messages.

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-gmail-ma08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-gmail
Command: npx skills add https://github.com/ma08/botfiles --skill gws-gmail-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually managing Gmail inboxes, sending emails, and organizing message threads is time-consuming and inefficient without integrated tooling that connects directly to your mailbox.

Core Features & Use Cases

  • Inbox Triage: Quickly scan unread emails by sender, subject, and date to prioritize urgent messages without opening the Gmail web interface.
  • Message Retrieval: Read full email content or extract specific headers from individual messages directly from your agent workflow.
  • Full Gmail API Access: Execute all standard Gmail operations including sending, replying, forwarding emails, managing labels, drafts, threads, and push notification settings via the underlying gws CLI.
  • Use Case: For example, you can triage 50 unread work emails to flag urgent client requests, then read and respond to high-priority messages without switching contexts.

Quick Start

Use the gws-gmail skill to show me a summary of all my unread inbox emails sorted by date from newest to oldest.

Frequently Asked Questions about gws-gmail

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

FAQPage Schema
How do I automate Gmail inbox triage to scan unread emails by sender and subject?

You can automate Gmail inbox triage to quickly scan unread emails by sender, subject, and date, prioritizing urgent messages without opening the web interface. The skill retrieves and summarizes unread messages sorted by date directly within your workflow.

Can I send and reply to Gmail messages from an automated workflow without manual web interface interaction?

Yes, you can send, reply to, and forward Gmail messages from an automated workflow without manual web interface interaction. The skill executes standard email operations including message content retrieval, label management, and draft handling directly through the gws CLI.

Do I need the gws CLI tool to manage Gmail labels, drafts, and threads?

Yes, you need the gws CLI tool with valid Gmail API authentication to manage labels, drafts, and threads. The skill relies on the gws CLI to execute mailbox operations and access message, label, draft, and thread resources.

What is the best way to read full email content and extract specific headers from Gmail messages?

The best way to read full email content and extract specific headers from Gmail messages is by using the gws CLI tool to retrieve message content directly. The skill enables reading full email bodies or extracting specific headers from individual messages without opening the web interface.

Does Gmail automation support managing push notification settings and organizing message threads?

Yes, Gmail automation supports managing push notification settings and organizing message threads. The skill provides full Gmail API access to execute all standard operations including label management, thread organization, and push notification configuration via the gws CLI.