Agent Skills
› badlogic/pi-skills
› gmcli
gmcli
GitHubGmail命令行工具,支持搜索邮件、读取线程、发送邮件及管理草稿和标签。提供安装配置指南及常用操作示例。
触发场景
用户需要查询或管理Gmail邮件
用户需要通过脚本自动化处理Gmail任务
安装
npx skills add badlogic/pi-skills --skill gmcli -g -y
SKILL.md
Frontmatter
{
"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
版本历史
- 90bb51c 当前 2026-07-25 09:42


