gws-gmail

Send, read, and manage Gmail emails via the Gmail API.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/fishyer/skills --skill gws-gmail-fishyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/fishyer/skills/tree/main/skills/gws-gmail
Command: npx skills add https://github.com/fishyer/skills --skill gws-gmail-fishyer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gws, and includes scripts (resource) components.

What problem does it solve?

This Skill simplifies email management by providing a set of commands to send, read, and manage emails directly through the Gmail API.

Core Features & Use Cases

  • Email Sending: Send emails with customizable subjects and bodies.
  • Email Reading: Retrieve and display email summaries, read messages, and extract headers.
  • Email Management: Triage emails, reply, forward, and watch for new emails.
  • Use Case: Quickly send a reminder email to a team member or check the unread summary of your inbox.

Quick Start

Use the gws gmail +send command to send an email to '[email protected]' with the subject 'Meeting Reminder' and the body 'Don't forget our meeting at 10 AM tomorrow.'

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 accounts via command line?

You can manage Gmail accounts via command line by using this Skill to send, read, and manage emails directly through the Gmail API. It offers commands for email operations like forwarding and watching for new emails.

Can I send an email using the Gmail API through command line scripts?

Yes, you can send an email using the Gmail API through command line scripts. The Skill provides a dedicated command to send customizable emails with specified subjects and bodies to your desired recipients.

Does this Gmail API Skill require authentication?

Yes, this Gmail API Skill requires authentication. You must authenticate your Gmail account with the API to enable reading summaries, triaging messages, replying, and watching for new emails.

What is the best way to read unread Gmail summaries via API?

The best way to read unread Gmail summaries via API is using this Skill's email reading commands. It retrieves and displays email summaries, extracts headers, and helps you triage incoming messages efficiently.

Do I need the gws environment to run Gmail command line operations?

Yes, you need the gws environment to run Gmail command line operations. The Skill explicitly requires gws as a dependency to execute its scripts for sending, reading, and managing your emails.