Skip to main content

​
Manage your emails in your console

1

Grab your mailbox credentials

  • Gmail
  • Outlook
  • Custom IMAP host
  • Head over to App passwords
  • Enter an App name (e.g. “Relay”)
  • Click on “Create” and save the password
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.
2

Install the CLI

pip install relaycli
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
5

Make something cool

Now it’s your turn!