Skip to content
Skillpedia
PT
PDF, Word & slides32k · #6272

gws-gmail

Lets your agent send, read, and manage emails. Facilitates automated email communication.

What it does

This agent helps you manage your Gmail emails. You can send, read, reply to, and organize your messages.

When to use it

  • ✓When you need to send an email quickly.
  • ✓To see a summary of unread emails.
  • ✓To reply to or forward important messages.

Example of what to ask your AI

“Send an email to john.doe@email.com with the subject 'Meeting' and say the meeting is postponed to tomorrow.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/googleworkspace/cli/blob/main/skills/gws-gmail/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/googleworkspace/cli/blob/main/skills/gws-gmail/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
View on GitHub ↗Raw file
How it works

It connects to your Gmail account to perform the actions you request. You tell it what you want to do, like send or read an email, and it executes.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add googleworkspace/cli --skill gws-gmail

Or download just the file:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-gmail/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

gmail (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws gmail <resource> <method> [flags]

Helper Commands

Command Description
+send Send an email
+triage Show unread inbox summary (sender, subject, date)
+reply Reply to a message (handles threading automatically)
+reply-all Reply-all to a message (handles threading automatically)
+forward Forward a message to new recipients
+read Read a message and extract its body or headers
+watch Watch for new emails and stream them as NDJSON

API Resources

users

  • getProfile — Gets the current user's Gmail profile.
  • stop — Stop receiving push notifications for the given user mailbox.
  • watch — Set up or update a push notification watch on the given user mailbox.
  • drafts — Operations on the 'drafts' resource
  • history — Operations on the 'history' resource
  • labels — Operations on the 'labels' resource
  • messages — Operations on the 'messages' resource
  • settings — Operations on the 'settings' resource
  • threads — Operations on the 'threads' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws gmail --help

# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>

Use gws schema output to build your --params and --json flags.

FAQ

How does the agent know which email to read or reply to?

You can specify the exact email by sender, subject, or date, or the agent can focus on unread emails.

Do I need to worry about my account security?

The agent follows security rules and only accesses what's necessary to perform the requested task, after your authorization.

Can I organize my emails with it?

Yes, you can use commands to read emails, see summaries, and even manage drafts or label them.

Details

Original description by the author

Gmail: Send, read, and manage email.

repo: googleworkspace/cli

Popularity

GitHub stars
32k
Ranking position
#6272
License
Apache-2.0
Updated
10/6/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Analysis & spreadsheets32k

gws-admin-reports

Helps your agent get activity reports from Google Workspace. It collects audit and usage data.

googleworkspace/cli

Email & messaging32k

gws-calendar-agenda

Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.

googleworkspace/cli

Email & messaging32k

gws-calendar-insert

Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.

googleworkspace/cli

Email & messaging32k

gws-calendar

Allows your agent to manage calendars and events. It's useful for organizing your life and work.

googleworkspace/cli

Similar skills

PDF, Word & slides280k

google-workspace-ops

Operates with Google Workspace documents (Drive, Docs, Sheets, Slides) as a unified workflow. It makes it easy to find, summarize, and edit your files without leaving the tool.

affaan-m/ECC

PDF, Word & slides77k

Dynamics 365 Automation

Helps your agent manage customer information in Dynamics 365. It can handle contacts, sales, and cases, making work more organized.

ComposioHQ/awesome-claude-skills

PDF, Word & slides77k

Excel Automation

Helps your agent work with spreadsheets in Excel and Google Sheets. It can create, edit, and format files.

ComposioHQ/awesome-claude-skills