Gmcli
- 118 installs
- 2.3k repo stars
- Updated June 6, 2026
- badlogic/pi-skills
gmcli is a Claude skill that wraps the gmcli command-line tool to search, read, send, and manage Gmail emails, drafts, labels, and attachments.
About
gmcli is a skill that drives the @mariozechner/gmcli command-line tool for Gmail. It lets the assistant search emails with Gmail query syntax, read threads, send messages, and manage drafts, labels, and attachments. It documents the one-time Google Cloud OAuth setup and per-account configuration, and a developer uses it to automate Gmail from the terminal.
- Gmail CLI for searching emails, reading threads, sending messages, and managing drafts
- Wraps the @mariozechner/gmcli npm package over the Gmail API via OAuth
- Guides one-time Google Cloud OAuth setup and per-account credential configuration
Gmcli by the numbers
- 118 all-time installs (skills.sh)
- Ranked #718 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
gmcli capabilities & compatibility
Free tool; requires a Google Cloud OAuth client and Gmail API access
- Capabilities
- Works with
- gmail
- Use cases
- Pricing
- Free
What gmcli says it does
Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.
Command-line interface for Gmail operations.
npx skills add https://github.com/badlogic/pi-skills --skill gmcliAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 118 |
|---|---|
| repo stars | ★ 2.3k |
| Last updated | June 6, 2026 |
| Repository | badlogic/pi-skills ↗ |
What it does
Search, read, send, and manage Gmail emails and drafts from the command line via the gmcli tool.
Who is it for?
Automating Gmail search, reading, and sending from the command line
Skip if: Email providers other than Gmail
When should I use this skill?
You need to search, read, send, or manage Gmail emails, drafts, or labels via CLI.
What you get
The assistant searches, reads, sends, and manages Gmail messages and drafts from the terminal.
By the numbers
- five-step Google Cloud OAuth setup
- supports search, thread, send, labels, drafts commands
Files
Gmail CLI
Command-line interface for Gmail operations.
Installation
npm install -g @mariozechner/gmcliSetup
Google Cloud Console (one-time)
1. Create a new project (or select existing) 2. Enable the Gmail API 3. Set app name in OAuth branding 4. Add test users (all Gmail addresses you want to use) 5. Create OAuth client:
- Click "Create Client"
- Application type: "Desktop app"
- Download the JSON file
Configure gmcli
First check if already configured:
gmcli accounts listIf no accounts, guide the user through setup: 1. Ask if they have a Google Cloud project with Gmail API enabled 2. If not, walk them through the Google Cloud Console steps above 3. Have them download the OAuth credentials JSON 4. Run: gmcli accounts credentials ~/path/to/credentials.json 5. Run: gmcli accounts add <email> (use --manual for browserless OAuth)
Usage
Run gmcli --help for full command reference.
Common operations:
gmcli <email> search "<query>"- Search emails using Gmail query syntaxgmcli <email> thread <threadId>- Read a thread with all messagesgmcli <email> send --to <emails> --subject <s> --body <b>- Send emailgmcli <email> labels list- List all labelsgmcli <email> drafts list- List drafts
Data Storage
~/.gmcli/credentials.json- OAuth client credentials~/.gmcli/accounts.json- Account tokens~/.gmcli/attachments/- Downloaded attachments
Related skills
Agent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.591k39.6k
Lark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.494kLark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.493kLark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.492kLark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.492k
Twitter AutomationAutomate X/Twitter posts, scheduling, and engagement via X API integration441k669