Gmail, Fastmail, iCloud and any IMAP server

Connect any IMAP server with an app password.

Other providers

Anything that speaks IMAP with an app password. Add it in the settings window, or by hand:

[accounts.personal]
provider = "generic"
email    = "you@fastmail.com"
host     = "imap.fastmail.com"
# port   = 993   (default)

Then rubit-mcp-mail auth personal and paste the app password (or do both from the settings window).

Known hosts

ProviderIMAP hostNotes
Gmailimap.gmail.comApp-specific password required, not your login password
Fastmailimap.fastmail.comApp password
iCloudimap.mail.me.comApp-specific password required, not your login password
Yahooimap.mail.yahoo.comApp password
Self-hostedyour hostport and ssl are overridable

Anything else that speaks IMAP works too — provider = "generic" plus a host is the whole contract.

Without storing the password

To avoid storing the password at all, set RUBIT_MCP_MAIL_PASSWORD_<ACCOUNTNAME> in the environment instead — the account name uppercased. For [accounts.personal] that is RUBIT_MCP_MAIL_PASSWORD_PERSONAL.

Folder roles

Folders are addressed by roleinbox, sent, drafts, junk, trash, archive — so you never need to know that Outlook calls it Junk Email while Gmail calls it [Gmail]/Spam. Raw folder names work too.

Roles come from the server's RFC 6154 SPECIAL-USE flags where available. Outlook.com does not advertise them, so there names are matched instead — accent-insensitively, and including the localizations Outlook ships (Spanish, Catalan, French, German, Italian, Portuguese), so a mailbox with Elementos enviados still resolves to sent. Matching is done on the leaf name, so [Gmail]/Sent Mail resolves too.

Run rubit-mcp-mail doctor to see exactly how your folders were classified; any folder that comes out as other can still be addressed by its raw name.