| name | gmail-automation |
| description | Lightweight Gmail integration with standalone OAuth authentication. No MCP server required. |
| type | skill |
| created | 2026-02-27T00:00:00.000Z |
| domain | productivity |
| category | automation |
| risk | critical |
| source | community |
| tags | ["skill","productivity","automation","gmail"] |
Gmail
Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.
⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.
When to Use
- You need to search, read, or send Gmail messages from the command line without an MCP server.
- You are automating inbox workflows for a Google Workspace account.
- You want a lightweight Gmail integration backed by standalone OAuth scripts.
First-Time Setup
Authenticate with Google (opens browser):
python scripts/auth.py login
Check authentication status:
python scripts/auth.py status
Logout when needed:
python scripts/auth.py logout
Commands
All operations via scripts/gmail.py. Auto-authenticates on first use if not logged in.
Search Emails
python scripts/gmail.py search "from:someone@example.com is:unread"
python scripts/gmail.py search --limit 20
python scripts/gmail.py search --label INBOX --limit 10
python scripts/gmail.py search "subject:important" --include-spam-trash
Read Email Content
python scripts/gmail.py get MESSAGE_ID
python scripts/gmail.py get MESSAGE_ID --format metadata
python scripts/gmail.py get MESSAGE_ID --format minimal
Send Emails
python scripts/gmail.py send --to "user@example.com" --subject "Hello" --body "Message body"
python scripts/gmail.py send --to --cc --bcc \
--subject --body
python scripts/gmail.py send --to --subject --body \
--from
python scripts/gmail.py send --to --subject \
--body --html