gmcli

Original：🇺🇸 English

Translated

Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.

1installs

Added on2026-02-17

NPX Install

npx skill4agent add badlogic/pi-skills gmcli

Command-line interface for Gmail operations.

bash

npm install -g @mariozechner/gmcli

Create a new project (or select existing)
Enable the Gmail API
Set app name in OAuth branding
Add test users (all Gmail addresses you want to use)
Create OAuth client:
- Click "Create Client"
- Application type: "Desktop app"
- Download the JSON file

First check if already configured:

bash

gmcli accounts list

If no accounts, guide the user through setup:

Run:

gmcli accounts credentials ~/path/to/credentials.json

Run

gmcli --help

for full command reference.

Common operations:

gmcli <email> send --to <emails> --subject <s> --body <b>

- Send email