Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-gmail — Claude skill: Gmail from the terminal

This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add googleworkspace/cli --skill gws-gmail -a claude-code
Open on GitHub

What gws-gmail does

The skill wraps the Gmail API in commands shaped like gws gmail [flags]. Helper commands cover the common jobs: +send, +triage for an unread summary, +reply and +reply-all with threading handled for you, +forward, +read to pull a body or headers, and +watch to stream new mail as NDJSON. Underneath sit the API resources users, drafts, history, labels, messages, settings and threads.

Before calling a method, inspect it with gws schema gmail.. — that output tells you the required params and types for your --params and --json flags. Auth, global flags and security rules live in ../gws-shared/SKILL.md; if that file is missing, run gws generate-skills. The gws binary has to be installed, otherwise nothing runs.

Worth installing if your mail tasks already live in a terminal and you want the agent reading and sending without a browser tab. If Gmail is not your main inbox, or you would rather not hand an agent your correspondence, skip it.

What it helps with

  • send an email without leaving the terminal
  • pull an unread summary with sender, subject and date
  • reply inside a thread while keeping it threaded
  • forward a message to new recipients
  • stream incoming mail as NDJSON

Example prompts for the agent

  • send an email to [email protected] with subject "Deploy is done"
  • show me today's unread summary
  • reply to the last message from the client and keep the thread

How to install gws-gmail

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-gmail -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-gmail/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-gmail/

From the same set95

The whole set →
gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs gws-docs-write official googleworkspace Appends plain text to the end of a Google Docs document through gws. Use it when an agent needs to write a result into a specific document. Claude Code CX Codex Cursor +1 50,100installs

Similar

idea-refine addyosmani Turns raw concepts into sharp, actionable plans through structured divergence and stress-testing. Creates a concise MVP one-pager. Claude Code CX Codex Cursor +1 58,600installs summarize openclaw Runs a CLI tool to summarize or transcribe web articles, YouTube videos, podcasts, and local PDF documents directly within your AI assistant. Claude Code CX Codex Cursor +1 26,900installs using-agent-skills addyosmani A meta-skill that tells the agent which skill from the agent-skills collection fits the task in front of it, and which behaviour rules apply all the time. Claude Code CX Codex Cursor +1 58,500installs shipping-and-launch addyosmani Walks your agent through a production launch: pre-launch checklist, monitoring, staged rollout and a rollback plan. Useful when a feature reaches real users. Claude Code CX Codex Cursor +1 57,800installs interview-me addyosmani Conducts a one-question-at-a-time interview to extract actual project intent before any code or specs. Useful when a task is underspecified. Claude Code CX Codex Cursor +1 56,700installs planning-with-files OthmanAdi Keeps task plans and progress in local Markdown files. Useful for agent tasks and research requiring five or more tool calls. Claude Code CX Codex Cursor +1 46,900installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs

Questions about gws-gmail

How do I install gws-gmail in Claude?

Run npx skills add googleworkspace/cli --skill gws-gmail -a claude-code. The skill lands at ~/.claude/skills/gws-gmail/SKILL.md.

What does gws-gmail do?

It gives your agent Gmail commands for sending, reading and triaging mail through the gws CLI, including threaded replies and a stream of new messages.

What does the skill need to run?

The gws binary plus ../gws-shared/SKILL.md for auth settings. If that file is absent, generate it with gws generate-skills.

Source text

SKILL.md · Apache-2.0 
---
name: gws-gmail
description: "Gmail: Send, read, and manage email."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail --help"
---

# gmail (v1)

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

```bash
gws gmail <resource> <method> [flags]
```

## Helper Commands

| Command | Description |
|---------|-------------|
| [`+send`](../gws-gmail-send/SKILL.md) | Send an email |
| [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |
| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |
| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |
| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |
| [`+read`](../gws-gmail-read/SKILL.md) | Read a message and extract its body or headers |
| [`+watch`](../gws-gmail-watch/SKILL.md) | 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:

```bash
# 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.

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor