If you encounter any issue, make sure that App passwords are available for your account (Gmail Help).
As of July 2025, all you need is to turn 2-Step verification on.
If you encounter issues, please follow the installation steps for either pip or uv and then run the corresponding installation command.
3
Connect the inbox
relay accounts add
4
Try out CLI commands
Fetch recent emails
Search your inbox
Read a specific message
relay messages ls --unread
Using account: piedpiper Messages from richard@piedpiper.com┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓┃ UID ┃ Timestamp ┃ From ┃ Subject ┃ Snippet ┃┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩│ 15443 │ 2025-06-23 12:35:44 UTC │ gilfoyle@piedpiper.com │ Server │ The ││ │ │ │ migration │ migration ││ │ │ │ complete │ is done... ││ 15467 │ 2025-06-26 12:46:09 UTC │ dinesh@piedpiper.com │ RE: My │ Actually ││ │ │ │ code is │ Gilfoyle, ││ │ │ │ perfect │ your cod...│└───────┴──────────────────────────┴───────────────────────────────┴────────────┴────────────┘Showing 2 of 2 unread messages
relay messages grep "Son of Anton"
Using account: piedpiperNo messages found containing 'Son of Anton'
relay messages cat 15443
Using account: piedpiperMessage DetailsUID: 15443Timestamp: 2025-06-23 12:35:44 UTCSubject: Server migration completeFrom: "Bertram Gilfoyle" <gilfoyle@piedpiper.com>To: richard@piedpiper.comCC: dinesh@piedpiper.com, jared@piedpiper.comBCC: N/AMessage Body:The migration is done. Obviously.While you were all probably panicking about downtime (which never happened),I successfully migrated our entire server infrastructure to the new data center.Key accomplishments:- Migrated 47 servers in 3.2 hours- Implemented redundant failsafes- Optimized database queries by 340%- Fixed 23 security vulnerabilitiesRichard, the system is now running at 99.97% efficiency. The remaining 0.03%is due to the laws of physics, which even I cannot override.Dinesh, I've documented everything in a way that even you might comprehend,though I make no guarantees.The servers are purring like a well-fed cat. You may now return to yourregularly scheduled mediocrity.--Bertram GilfoyleSenior Systems ArchitectPied Piper Inc.No attachments
relay messages cat 15467
Using account: piedpiperMessage DetailsUID: 15467Timestamp: 2025-06-26 12:46:09 UTCSubject: RE: My code is perfectFrom: "Dinesh Chugtai" <dinesh@piedpiper.com>To: richard@piedpiper.comMessage Body:Actually Gilfoyle, your code has a memory leak in the compression algorithm.I've already fixed it. You're welcome.No attachments
