google-gmail

Send, reply, forward, search, and label emails via the Gmail API.

1.7k|523|Updated May 5, 2026
One-click install
npx skills add https://github.com/Open-Curiosity/gini-agent --skill google-gmail-open-curiosity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-gmail
Source: https://github.com/Open-Curiosity/gini-agent/tree/main/skills/google/google-gmail
Command: npx skills add https://github.com/Open-Curiosity/gini-agent --skill google-gmail-open-curiosity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gws, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill empowers you to manage your Gmail account through the terminal, eliminating the need for a web interface and providing advanced actions and convenience helpers.

Core Features & Use Cases

  • Email Operations: Send, read, search, label, draft, reply, and forward emails.
  • API Integration: Wraps Gmail v1 API to work with tools like jq for further processing.
  • Account Selection: Target specific Gmail accounts using the configuration directory prefix.
  • Use Case: Need to send an email on behalf of a client without switching between interfaces? Use the +send helper with the client's config directory.

Quick Start

Send a new email to [email protected] with a subject and body.

gws gmail +send --to [email protected] --subject 'Meeting Reminder' --body 'Hi Alice, our meeting is at 3pm today.'

Frequently Asked Questions about google-gmail

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

FAQPage Schema
How do I send and manage Gmail emails from the command line?

You can manage Gmail emails from the command line by wrapping the Gmail v1 API to execute actions like sending, reading, searching, and labeling. This enables terminal-based email management without requiring a web interface.

Can I use command line tools to parse Gmail API responses?

Yes, Gmail API responses can be parsed using JSON parsing tools like jq. The API integration wraps Gmail v1 outputs to work seamlessly with command line scripting tools for further data manipulation and automation.

Do I need a Google Workspace account to manage Gmail via the terminal?

Yes, terminal Gmail management requires a Google Workspace account configured with specific Gmail API scopes. You also need the gws CLI installed and properly authenticated to execute email actions.

How do I send an email on behalf of a specific Gmail account using the terminal?

You can target a specific Gmail account by using the configuration directory prefix with your send command. This allows executing email actions on behalf of different clients without switching between web interfaces.

What is the best way to automate email management without a web interface?

Automating email management without a web interface is best achieved by wrapping the Gmail v1 API in a terminal environment. This approach allows scripting of email operations like sending, searching, and labeling directly from the command line.