google-gmail

Perform Gmail operations from the terminal with structured JSON output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually opening Gmail by letting you read, search, draft, send, reply, forward, and label from the terminal with structured JSON output.

Core Features & Use Cases

  • Inbox triage and searching: Pull unread and labeled messages or run Gmail search operators to find what you need fast.
  • Threaded sending and responses: Reply, reply-all, forward, and draft using helpers that preserve threading headers.
  • Labeling and watching new mail: Apply labels, manage drafts, and stream new messages as NDJSON for downstream workflows.

Quick Start

Ask Gini to draft and send a reply to a specific message in your inbox, for example: read the latest unread email from [email protected] and reply confirming you will follow up tomorrow.

Frequently Asked Questions about google-gmail

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

FAQPage Schema
How do I read and send Gmail from the terminal?

You can read and send Gmail from the terminal by using this Skill to search, draft, send, and reply to messages with structured JSON output. It handles MIME and base64 formatting through curated gws helpers.

Can I automate Gmail inbox triage with structured JSON?

Yes, automating Gmail inbox triage with structured JSON is supported. You can pull unread messages, apply labels, and stream new mail as NDJSON to feed downstream automation workflows.

Do I need the gws CLI to manage Gmail drafts and labels?

Yes, you need the gws CLI authenticated with Gmail scopes like gmail.readonly, gmail.send, and gmail.modify to manage drafts and labels. Optional Pub/Sub scopes are required for watching new messages.

How do I send threaded replies and forwards using terminal automation?

To send threaded replies and forwards using terminal automation, this Skill uses gws gmail helpers that preserve threading headers. This ensures your responses remain correctly linked within existing email conversations.

What is the best way to search Gmail and stream new messages for automation?

The best way to search Gmail and stream new messages for automation is running Gmail search operators and using the watch feature. This outputs new messages as NDJSON, enabling seamless consumption by downstream workflows.

Does this Skill handle MIME and base64 formatting for Gmail messages?

Yes, this Skill handles MIME and base64 formatting for Gmail messages. It uses curated gws gmail helpers to manage encoding, ensuring terminal-based sending and reading operations function correctly.