gws-gmail

Automates sending, reading, searching, and organizing Gmail messages via CLI.

1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-gmail-cdrguru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/cdrguru/portable-agent-kit/tree/main/.agent/skills/gws-gmail
Command: npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-gmail-cdrguru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail management can be slow and error-prone when juggling sending, reading, searching, and organizing messages; this skill streamlines those tasks via a CLI interface.

Core Features & Use Cases

  • Send emails to contacts and distribution lists
  • Read threads and summarize conversations
  • Search messages and apply labels for organization
  • Manage threads and replies with contextual awareness

Quick Start

Use a natural language prompt like 'send an email to Jane about tomorrow's meeting' and let gws Gmail execute it.

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 and searching Gmail messages?

You can automate Gmail operations like sending, reading, and searching messages by using natural language prompts that execute CLI commands via the Gmail API. This streamlines personal or team inbox workflows without manual interface interaction.

Can I organize Gmail threads and apply labels using a command line interface?

Yes, you can organize Gmail conversations by applying labels to searched message threads. The skill manages threads and replies with contextual awareness, enabling efficient inbox organization directly through the command line interface.

What do I need to set up before using this Gmail automation skill?

You need the gws runtime installed and authentication setup completed. The skill enforces security and scope controls via a shared auth layer to safely access Gmail API resources through the CLI.

Does this tool work for managing a shared team inbox in Gmail?

Yes, this skill applies to both personal and team inbox workflows. It supports composing, replying to emails, searching threads, and organizing conversations, making it suitable for collaborative Gmail management scenarios.

How does natural language processing handle email composition in Gmail?

Natural language prompts like 'send an email to Jane about tomorrow's meeting' are interpreted to execute the underlying Gmail CLI commands. This allows the system to compose and send emails contextually without manual command structuring.