gmailtail: tail -f Your Gmail
10 months ago
- #monitoring
- #automation
- #Gmail
- A command-line tool named gmailtail for monitoring Gmail messages and outputting them as JSON.
- Features include real-time monitoring with --tail mode, flexible filtering by sender, subject, labels, etc., checkpoint support, multiple output formats (JSON, JSON Lines, compact), and configuration via YAML files.
- Supports Gmail's search syntax and easy authentication via OAuth2 and service accounts.
- Installation involves cloning the repository and setting up with uv.
- Setup requires Google API credentials from the Google Cloud Console.
- Various usage examples provided, including monitoring specific senders, unread emails, emails with attachments, and custom output formats.
- Advanced usage includes integration with other tools like jq for processing JSON output, creating summaries, and triggering alerts.
- Configuration options detailed for authentication, filtering, output formatting, monitoring behavior, and checkpoint settings.
- Authentication setup instructions provided for both OAuth2 and service accounts.
- Development setup includes installing dependencies, running tests, and code formatting tools.
- Licensed under MIT License.