gmcli

Manage Gmail emails, threads, drafts, labels, and attachments via CLI.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/winsorllc/upgraded-carnival --skill gmcli-winsorllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmcli
Source: https://github.com/winsorllc/upgraded-carnival/tree/main/.pi/skills/gmcli
Command: npx skills add https://github.com/winsorllc/upgraded-carnival --skill gmcli-winsorllc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a command-line interface to interact with Gmail, streamlining email management tasks without needing to open a web browser.

Core Features & Use Cases

  • Search Emails: Find emails using Gmail's powerful query syntax.
  • Read Threads: View entire email conversations.
  • Send Messages: Compose and send new emails.
  • Manage Drafts: Access and edit saved drafts.
  • Handle Labels & Attachments: Organize emails and manage file attachments.
  • Use Case: Quickly search for an email from a specific sender about a project update, read the relevant thread, and reply directly from your terminal.

Quick Start

Use the gmcli skill to search for emails from '[email protected]' with the subject 'Order Confirmation'.

Frequently Asked Questions about gmcli

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

FAQPage Schema
How do I manage Gmail from the terminal without opening a browser?

You can manage Gmail from the terminal using a command-line interface that interacts directly with your account. This allows you to search emails, read threads, send messages, and manage drafts without needing a web browser.

Can I search emails and read threads using a command-line interface?

Yes, you can search emails using Gmail's native query syntax and read entire conversation threads via the command-line interface. This enables quick retrieval and viewing of specific email discussions directly within your terminal environment.

How does Gmail CLI authentication work for secure email access?

Gmail CLI authentication works securely by integrating with Google's OAuth 2.0 protocol. This ensures your credentials are protected and access is authorized directly through Google's secure authentication framework.

What email operations are supported by a Gmail command-line tool?

Supported email operations include searching messages, reading threads, sending new emails, and managing drafts. You can also organize your inbox by handling labels and managing file attachments.

What is the best way to send messages and manage drafts via a CLI?

The best way to send messages and manage drafts via a CLI is using a dedicated command-line tool that supports direct composition and editing. This streamlines sending new emails and accessing saved drafts without browser overhead.

Does CLI email management support handling labels and attachments?

Yes, command-line email management supports handling labels and managing file attachments. You can organize your inbox by applying labels and process file attachments directly through terminal commands.