badlogic/gmcli
gmcli/SKILL.md
Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.
$ install --global
skillsauthnpx skillsauth add badlogic/pi-skills gmcliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 4, 2026, 7:36 PM4.3s1 file scanned
SKILL.md
- name:
- gmcli
- description:
- Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.
Gmail CLI
Command-line interface for Gmail operations.
Installation
npm install -g @mariozechner/gmcli
Setup
Google Cloud Console (one-time)
- 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
Configure gmcli
First check if already configured:
gmcli accounts list
If no accounts, guide the user through setup:
- Ask if they have a Google Cloud project with Gmail API enabled
- If not, walk them through the Google Cloud Console steps above
- Have them download the OAuth credentials JSON
- Run:
gmcli accounts credentials ~/path/to/credentials.json - Run:
gmcli accounts add <email>(use--manualfor 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
badlogic/youtube-transcript
content-media
VerifiedTrustedCommunity
Fetch transcripts from YouTube videos for summarization and analysis.
1,927SKILL.mdUpdated Jun 7, 2026
badlogic/vscode
development
VerifiedTrustedCommunity
VS Code integration for viewing diffs and comparing files. Use when showing file differences to the user.
1,927SKILL.mdUpdated Jun 7, 2026
badlogic/transcribe
development
VerifiedTrustedCommunity
Local speech-to-text transcription on Apple Silicon macOS. Supports wav directly and other audio formats via ffmpeg.
1,927SKILL.mdUpdated Jun 7, 2026
badlogic/gdcli
tools
VerifiedTrustedCommunity
Google Drive CLI for listing, searching, uploading, downloading, and sharing files and folders.
1,927SKILL.mdUpdated Jun 7, 2026