Gmail, Fastmail, iCloud and any IMAP server
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
| Provider | IMAP host | Notes |
|---|---|---|
| Gmail | imap.gmail.com | App-specific password required, not your login password |
| Fastmail | imap.fastmail.com | App password |
| iCloud | imap.mail.me.com | App-specific password required, not your login password |
| Yahoo | imap.mail.yahoo.com | App password |
| Self-hosted | your host | port 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 role — inbox, 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.