Agent skill · writing content · aiskillstore
gmail-automation
Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.
Why this skill is useful
Adds executable scripts for Gmail automation that provide capabilities not available in standard documentation.
What it needs
Requires python installed locally. Requires google account access. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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): Check authentication status: Logout when needed: Commands All operations via scripts/gmail.py. Auto-authenticates on first use if not logged in. Search Emails Read Email Content Send Emails Draft Management Modify Messages (Labels) List Labels Gmail Query Syntax Gmail supports powerful search operators: Query Description ------- ------------- from:user@example.com Emails from a specific sender to:user@example.com Emails to a specific recipient subject:meeting Emails with "meeting" in subject is:unread Unread emails is:starred Starred emails is:important Important emails has:attachment Emails with attachments after:2024/01/01 Emails after a date before:2024/12/31 Emails before a date newerthan:7d Emails from last 7 days olderthan:1m Emails older than 1 month label:work Emails with a specific label in:inbox Emails in inbox in:sent Sent emails in:trash Trashed emails Combine with AND (space), OR, or - (NOT): Common Label IDs Label ID ------- ----- Inbox INBOX Sent SENT Drafts DRAFT Spam SPAM Trash TRASH Starred STARRED Important IMPORTANT Unread UNREAD Token Management Tokens stored securely using the system keyring: macOS: Keychain Windows: Windows Credential Locker Linux: Secret Service API (GNOME Keyring, KDE Wallet, etc.) Service name: gmail-skill-oauth Tokens automatically refresh when expired using Google's cloud function. Limitations Use this skill only when the task clearly matches the scope described above. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/gmail-automation