Gws Gmail — Agent Skill by Google Workspace

From the author

Gmail: Send, read, and manage email.

— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-gmail skill provides a command-line interface to interact with Gmail services. It enables users to perform common email operations such as sending, reading, and triaging messages, as well as managing threads, drafts, and labels. The skill is designed to be used within the gws framework, requiring shared authentication and configuration.

What it does

Send new emails and reply to existing threads
Triage unread inbox messages by summarizing sender and subject
Forward messages to new recipients
Read message bodies and headers
Monitor for new emails using a watch mechanism
Manage Gmail resources including labels, drafts, and settings

When to use it

When you need to automate email tasks from a terminal or script
When integrating Gmail functionality into a larger workflow
When you need to monitor incoming mail programmatically
When managing Gmail settings or labels via command-line tools

Advantages

Enables programmatic access to Gmail features
Supports automated email triage and monitoring
Integrates with the broader gws ecosystem for unified authentication
Provides schema inspection to verify parameters and types

Usage examples

“gws gmail --help”: Displays the available resources and methods for interacting with the Gmail API.
“gws schema gmail.users.getProfile”: Returns the required parameters and data types for retrieving the current user's Gmail profile.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/googleworkspace/gws-gmail/download
Unzip it into the cross-client skills folder of your project:
```
mkdir -p .agents/skills && unzip gws-gmail.zip -d .agents/skills
```

Documentation by Google Workspace

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.

Files

ATTRIBUTION.mdAdded by AutoGineer880 B
LICENSELicence file added by AutoGineer11.1 KiB
SKILL.md2.0 KiB

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Build MCP App
AnthropicOfficial
Build interactive UI widgets for MCP servers to render forms, pickers, and dashboards directly within the chat interface.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
MCP Integration
AnthropicOfficial
Comprehensive guide for integrating Model Context Protocol (MCP) servers into Claude Code plugins.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
Social Publishing
Seth Hobson· Community
Programmatically schedule and publish content across 13 social media platforms using the SocialClaw API.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Hermes Tweet
Seth Hobson· Community
Integrates X/Twitter research and action capabilities into the Hermes Agent framework with strict approval-gated security.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Paypal Integration
Seth Hobson· Community
A guide to integrating PayPal payment processing, including checkout flows, subscriptions, and IPN webhook handling.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Social Publishing Publisher
Seth Hobson· Community
An agent-driven social media publishing specialist for multi-platform campaign management via the SocialClaw API.
Automation and integrationsClaude Code
MITGitHub stars of the source repository42.3k