Full command-line access to Gmail operations like searching, sending, and managing threads.
Install
mkdir -p .claude/skills/gmcli && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/5130" && unzip -o skill.zip -d .claude/skills/gmcli && rm skill.zipInstalls to .claude/skills/gmcli
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.Key capabilities
- →Search mailbox archives
- →Read email threads
- →Send messages
- →Manage drafts
- →Handle labels and attachments
How it works
The skill interfaces with the Gmail API to perform mailbox operations via CLI commands, using OAuth for authentication and local storage for credentials.
Inputs & outputs
When to use gmcli
- →Searching mailbox archives
- →Sending automated emails
- →Listing and managing email drafts
About this skill
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
When not to use it
- →High-volume bulk email marketing
- →Complex email parsing requirements
Prerequisites
Limitations
- →Requires initial OAuth setup
- →Limited by Gmail API quotas
How it compares
It enables command-line access to Gmail, allowing for integration into scripts and terminal-based workflows.
Compared to similar skills
gmcli side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| gmcli (this skill) | 1 | 8mo | Review | Intermediate |
| gmail-manager | 27 | 4mo | Review | Intermediate |
| mailchimp-automation | 2 | 4mo | No flags | Intermediate |
| action-creator | 2 | 9mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by badlogic
View all by badlogic →You might also like
gmail-manager
jeffvincent
Manage Gmail - send, read, search emails, manage labels and drafts. Use when user wants to interact with their Gmail account for email operations.
mailchimp-automation
sickn33
Automate Mailchimp email marketing including campaigns, audiences, subscribers, segments, and analytics via Rube MCP (Composio). Always search tools first for current schemas.
action-creator
anthropics
Creates user-specific one-click action templates that execute email operations when clicked in the chat interface. Use when user wants reusable actions for their specific workflows (send payment reminder to ACME Corp, forward bugs to engineering, archive old newsletters from specific sources).
convertkit-automation
Zidong-LLC
Automate ConvertKit (Kit) tasks via Rube MCP (Composio): manage subscribers, tags, broadcasts, and broadcast stats. Always search tools first for current schemas.
send-message
gitduk
Send a message to a Telegram chat via the Bot API directly. Self-contained — reads its own .env at the skill root and has no dependency on any Telegram plugin. Use when the user asks to push a Telegram notification to their phone, test the bot token, send from a hook or one-shot script, or 给 telegra
tg-bot-usage
kvcop
Use the Telegram bot effectively (commands, queue, attachments), including sending files/archives back via /upload.