Skip to content
mxr

Gmail setup

Why you need your own Google Cloud project

mxr ships with a default OAuth client ID for quick testing, but Google shows a prominent “unverified app” warning screen when using it. This is normal for open-source projects, Google’s verification process doesn’t fit the local-first model.

For daily use, create your own Google Cloud project. Takes about 5 minutes, removes the warning screen entirely, and means your OAuth credentials are fully under your control. You’ve probably done this before.

Create your Google Cloud project

  1. Open Google Cloud Console.
  2. Create a new project (e.g., “mxr-email”).
  3. Go to APIs & Services > Library and enable the Gmail API.
  4. Go to APIs & Services > Credentials and click Create Credentials > OAuth client ID.
  5. Select Desktop app as the application type.
  6. Copy the Client ID and Client Secret.

Connect your Gmail account

  1. Run:
Terminal window
mxr accounts add gmail
  1. Enter the client id and secret when prompted.
  2. Complete browser authorization.
  3. Verify the runtime account exists:
Terminal window
mxr status
  1. Start syncing:
Terminal window
mxr sync

TUI account view

The TUI Accounts page shows runtime accounts, not just config-file accounts. A Gmail account added through browser auth appears there even if it’s not an editable IMAP/SMTP config entry.

Open it with:

  • Ctrl-p then Open Accounts Page

Notes

  • Gmail runtime accounts may be runtime-only.
  • IMAP/SMTP accounts are editable through the Accounts page and config-backed.
  • Compose resolves the sender from the active/default runtime account, not from a static status string.