google-gmail
google-gmail wraps the Gmail API through the gws command-line tool, letting you compose, read, search, and organize messages without leaving the terminal. It outputs structured JSON for easy piping to jq and other utilities, and includes helpers for common tasks like sending, replying, and triaging your inbox.
google-gmail lets you send, read, search, and manage Gmail messages directly from your terminal using the gws CLI.
AI-generated summary based on this skill's SKILL.md
Install
Open-Curiosity/gini-agent/google-gmail · repository language: TypeScript
git clone https://github.com/Open-Curiosity/gini-agent
cp -r gini-agent/skills/google/google-gmail ~/.claude/skills/google-gmailFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I send email from terminal using google-gmail?
google-gmail wraps the Gmail API to let you send messages directly from the terminal. Use the gws command-line tool to compose and dispatch emails without opening a browser. The skill supports attaching files and outputs structured JSON, making it easy to integrate sending into bash scripts and automation workflows.
Can I read emails command line with google-gmail?
Yes. google-gmail lets you read, search, and manage Gmail messages entirely from the command line via the gws tool. You can retrieve message bodies, headers, and metadata in structured JSON format, then pipe the output to jq or other utilities for further processing and analysis.
What email operations can I automate with google-gmail?
google-gmail supports composing, replying, forwarding, labeling, and organizing messages programmatically. You can draft emails in the terminal, triage your inbox by searching and filtering, watch for new mail, and chain Gmail operations into shell scripts and terminal pipelines for end-to-end email automation.
Does google-gmail provide JSON output for integration?
Yes. google-gmail outputs structured JSON for all operations, enabling seamless integration with jq, shell scripts, and other command-line tools. This makes it straightforward to parse email data, extract fields, and build complex automation workflows that combine Gmail with other utilities.
How do I draft and reply to emails in the terminal?
google-gmail lets you draft, reply, and forward messages directly from the terminal using the gws command-line interface. Compose new emails, respond to existing messages, and forward conversations without leaving your shell—all with structured JSON output for easy scripting and integration.
What is the license for google-gmail?
google-gmail is released under the MIT license, allowing free use, modification, and distribution in both open-source and commercial projects with minimal restrictions.
SKILL.md
rendered from the published skill — quoted content, verbatim
Google Gmail
Use gws gmail to read, search, send, reply, forward, draft, label, and triage Gmail directly from the terminal. The CLI wraps the Gmail v1 API and produces structured JSON, so it composes cleanly with jq and other shell tooling.
Parsing gws output
gws writes its JSON to stdout and a Using keyring backend: keyring preamble (plus any warnings) to stderr. terminal_exec already shows the two streams as separate blocks, so on its own the preamble is harmless — but the moment you pipe gws into a JSON parser you must strip stderr first, or the preamble lands on the JSON and the parse throws:
```bash gws ... 2>/dev/null | jq ...
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/google/google-gmail/SKILL.md