gmail-automation

# 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): ```bash python scripts/auth.py login ``` Check authentication status: ```bash python scripts/auth.py status ``` Logout when needed: ```bash python scripts/auth.py logout ``` ## Commands All operations via `scripts/gmail.py`. Auto-authenticates on first use if not logged in. ### Search Emails ```bash # Search with Gmail query syntax python scripts/gmail.py search "from:someone@example.com is:unread" # Search recent emails (no query returns all) python scripts/gmail.py search --limit 20 # Filter by label python scripts/gmail.py search --label INBOX --limit 10 # Include spam and trash python scripts/gmail.py search "subject:important" --include-spam-trash ``` ### Read Email Content ```bash # Get full message content python scripts/gmail.py get MESSAGE_ID # Get just metadata (headers) python scripts/gmail.py get MESSAGE_ID --format metadata # Get minimal response (IDs only) python scripts/gmail.py get MESSAGE_ID --format minimal ``` ### Send Emails ```bash # Se...