Overriding provider endpoints
Correct a host, port, OAuth authority or scope from your own config without waiting for a release.
If Microsoft changes their endpoints
The Outlook IMAP host, OAuth authority URL, and IMAP scope are compiled into
providers.py as of when this was built. If Microsoft ever changes one of
them, you don't need to wait for a new release — add a [providers.outlook]
table to your own config.toml (never tracked by git) with the corrected
value, and it takes effect immediately:
[providers.outlook]
host = "outlook.office365.com" # current default, shown for reference
[providers.outlook.oauth]
authority = "https://login.microsoftonline.com/common"
scopes = ["https://outlook.office.com/IMAP.AccessAsUser.All"]
Only include the keys you actually need to change.
What is overridable
| Key | Applies to |
|---|---|
host | any provider |
port | any provider |
ssl | any provider |
oauth.authority | OAuth providers (outlook) |
oauth.scopes | OAuth providers (outlook) |
Anything else is rejected rather than silently ignored, so a typo surfaces as a config error instead of a mystery at connection time.
rubit-mcp-mail doctor prints a line naming any overrides currently in effect,
and the settings window's Providers tab writes the same table from a form
so you never have to hand-write TOML table syntax.This works for any provider, not just Outlook.