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
Decision gist · record as of 2026-07-18
google-gmail lets you send, read, search, and manage Gmail messages directly from your terminal using the gws CLI. 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.
Use it when
- Yes.
- google-gmail supports composing, replying, forwarding, labeling, and organizing messages programmatically.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
Open-Curiosity/gini-agent/google-gmail · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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)
File tree — 1 file
skills/google/google-gmail/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Send, read, search, and manage Gmail messages from the terminal”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Interact with Gmail to manage your inbox, search messages, handle attachments, and compose replies or new emails. The skill uses the Gmail REST API with OAuth authentication, supporting read-only access by default plus optional write permissions for labeling, archiving, and sending. Use curl and jq for most operations, or the Google Workspace CLI for composing and sending mail.
Gws is a command-line interface for Google Workspace that streamlines email triage, calendar management, file uploads, spreadsheet operations, and task creation. It supports helper commands for common workflows like standup reports and meeting prep, plus raw API access for advanced use cases. Built for both interactive queries and scripted automation.
A single command-line interface that connects to every Google Workspace API, from Drive and Gmail to Calendar, Sheets, Docs, Slides, Chat, and Admin tools. The CLI dynamically discovers available endpoints at runtime, so new Google APIs are supported automatically without updates. Built for both human operators and AI agents with JSON-structured output.
Google Calendar integrates with gws to let you browse your agenda, schedule new events with attendees, query availability windows, and handle RSVPs. Works on macOS and Linux with Google Workspace OAuth credentials and the gws CLI tool.
Send a reply-all message to all original recipients in a Gmail conversation with automatic thread handling. Customize the recipient list by adding or removing addresses, attach files, compose in HTML, and optionally save as a draft before sending.
This skill signs a Google account into its own gws config directory and registers it with a tag, enabling the multi-account model where one OAuth client authorizes many accounts. It runs the OAuth login flow in your default browser, confirms the session, and registers the account locally. Typically invoked by google-workspace-setup rather than directly.
More skills google-workspace (MIT) · Google Workspace (Apache-2.0) · Gmail (unlicensed) · google-drive (MIT) · google-docs (MIT) · gmail (MIT) · composio-gmail (MIT) · gws-gmail-reply (Apache-2.0)