gmcli

Search, read, send, and manage Gmail emails via command line.

Updated Mar 14, 2026

Search Tags:#automation #productivity #communication #cli #email #gmail

Ready to run

npx skills add https://github.com/pramudityad/pi-config --skill gmcli-pramudityad

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gmcli
Source: https://github.com/pramudityad/pi-config/tree/main/skills/pi-skills/gmcli
Command: npx skills add https://github.com/pramudityad/pi-config --skill gmcli-pramudityad

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines email management by providing a command-line interface to interact with Gmail, reducing the need to open a web browser for common tasks.

Core Features & Use Cases

Email Search & Retrieval: Quickly find specific emails or threads using Gmail's powerful search operators.
Sending & Drafting: Compose and send new emails or manage drafts directly from the terminal.
Label Management: View and organize emails by applying or removing labels.
Use Case: You need to find all emails from your project manager in the last week regarding the Q3 roadmap. Use this Skill to search your inbox and display the relevant thread.

Quick Start

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

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 command line without opening a browser?▼

You can manage Gmail from the command line by using a CLI tool that interacts with the Gmail API to search emails, read threads, send messages, and handle labels. This requires setting up OAuth 2.0 credentials for secure mailbox access.

Can I search and retrieve specific email threads using Gmail search operators in a terminal?▼

Yes, searching and retrieving specific email threads in a terminal supports standard Gmail search operators. You can query your inbox programmatically to find messages from specific senders or within certain date ranges.

What do I need to set up to send emails and manage drafts programmatically?▼

To send emails and manage drafts programmatically, you need to enable the Gmail API and configure OAuth 2.0 credentials. This secure access allows your command-line scripts to compose and dispatch messages.

Is it possible to apply or remove labels on emails via an automation script?▼

Yes, applying or removing labels on emails can be handled via an automation script. The CLI provides label management features to organize your inbox programmatically without manual web browser interaction.

Does command-line Gmail interaction support handling attachments?▼

Yes, command-line Gmail interaction supports handling attachments. You can process attachments programmatically alongside searching emails, reading threads, and managing drafts through the API.

What are the limitations of scripting Gmail operations compared to the web interface?▼

Scripting Gmail operations focuses on programmatic automation and requires OAuth 2.0 setup, unlike the web interface. It is designed for automating common tasks like searching and sending, necessitating API enablement for secure access.