skills.rest
oresttokovenko
oresttokovenkoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-gmail

Send, read, and manage Gmail messages through the gws command-line interface.

Updated Nov 9, 2023
Search Tags:#cli#email#gmail#google workspace#send email#gws#inbox triage
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-oresttokovenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-gmail
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing email from a terminal or AI agent workflow requires direct access to the Gmail API without building custom integrations. This Skill exposes Gmail operations—sending, reading, replying, forwarding, and watching mailboxes—through the gws CLI. ## Core Features & Use Cases - Email Operations: Send, reply, reply-all, forward, and read messages with automatic threading via helper commands like +send, +reply, and +read. - Inbox Triage & Monitoring: Summarize unread mail with +triage and stream new emails as NDJSON with +watch. - Full API Access: Call any Gmail API resource (messages, threads, labels, drafts, history, settings) and inspect parameters with gws schema. - Use Case: Ask your agent to triage your unread inbox each morning, then reply to a specific thread and set up a watch to stream incoming client emails into a processing pipeline. ## Quick Start Use the gws gmail skill to show a summary of my unread inbox messages.

Frequently Asked Questions about gws-gmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email from the command line with Gmail?▼

Use the gws gmail +send helper command, which sends an email through the Gmail API. Run gws gmail --help to see all available resources and methods before constructing your command.

How can I read and reply to Gmail threads programmatically?▼

Use the +read helper to extract a message body or headers, then +reply or +reply-all to respond with automatic threading handled for you. The +forward helper forwards messages to new recipients.

Can I watch a Gmail inbox for new emails in real time?▼

Yes, the +watch helper streams new emails as NDJSON, and the users.watch API method sets up push notifications on a mailbox. The users.stop method ends the watch.

What Gmail API resources are available through gws?▼

The users resource exposes drafts, history, labels, messages, settings, and threads, plus getProfile, watch, and stop methods. Use gws schema gmail.<resource>.<method> to inspect required parameters and types.

Why does gws gmail fail with missing shared configuration?▼

The skill requires the gws-shared skill for authentication, global flags, and security rules. If it is missing, run gws generate-skills to create it before using any gmail commands.

Related Skills

Explore More Personal & Entrepreneur Skills→
pgoellpgoell

gmail

Search, read, send, and manage Gmail messages, drafts, labels, and filters via the gws CLI.

Community
Intermediate
shogo-labsshogo-labs
12

email-monitor

Monitor Gmail for configured senders and publish extracted email alerts.

Official
Intermediate
vikingokftvikingokft

persona-exec-assistant

Automates executive scheduling, inbox management, and communications using the gws utility suite.

Official
Advanced
lengoctuong2005lengoctuong2005
5

google-workspace

Access Google Workspace services via gws CLI or Python.

Community
Intermediate