Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.

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 newer than:7d Emails from last 7 days older than: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. Do not treat the output as a substitute for environment specific validation, testing, or expert review. Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

gmail-automation