Jgmcli

Gmail CLI (Java)

Command-line interface for Gmail operations. Java port of gmcli.

Source: https://github.com/maxandersen/jgmcli

Installation

Option 1: Run directly with JBang (no install)

jbang jgmcli@maxandersen/skills --help

Option 2: Install as command

jbang app install jgmcli@maxandersen/skills
jgmcli --help

Setup

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 jgmcli

First check if already configured:

jgmcli accounts list

If 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: jgmcli accounts credentials ~/path/to/credentials.json
5. Run: jgmcli accounts add (use --manual for browserless OAuth)

Shared Credentials

Credentials in ~/.jgcli/ are shared across jgccli, jgmcli, and jgdcli. Set up once, use with all three.

For separate credentials, use named credentials:

jgmcli accounts credentials ~/work-creds.json --name work
jgmcli accounts add work@company.com --credentials work

Usage

Run jgmcli --help for full command reference.

Common operations:

• jgmcli search "" - Search emails using Gmail query syntax
• jgmcli thread - Read a thread with all messages
• jgmcli send --to --subject --body - Send email
• jgmcli labels list - List all labels
• jgmcli drafts list - List drafts

Gmail Query Syntax

in:inbox, in:sent, in:drafts, in:trash
is:unread, is:starred, is:important
from:sender@example.com, to:recipient@example.com
subject:keyword, has:attachment, filename:pdf
after:2024/01/01, before:2024/12/31
label:Work, label:UNREAD
Combine: "in:inbox is:unread from:boss@company.com"

Data Storage

• ~/.jgcli/credentials.json - OAuth client credentials (shared with jgccli, jgdcli)
• ~/.jgcli/accounts-gmail.json - Account tokens
• ~/.jgcli/attachments/ - Downloaded attachments

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: maxandersen
• Source: maxandersen/skills
• License: MIT

Install and usage instructions live in the source repository linked above.