The settings window
The settings window
The installer and rubit-mcp-mail install cover
first-time setup. For everything after that — a second mailbox, a typo'd
client_id, a changed download directory — this is the editor, and everything
in config.toml can be managed from a window instead of a text editor.
Setup puts it in your Start Menu and on your Desktop (Windows) or in your application menu (Linux), as rubit-mcp-mail Settings. Click it. Nothing needs to be typed, and no browser is involved. From a terminal, or from a source checkout, the same window opens with:
rubit-mcp-mail gui
The four tabs
Accounts
Every account at a glance: provider, server, and whether it is signed in, with
the same diagnosis doctor gives. Add, edit and remove them here; pick Outlook
or any other IMAP server, and the form is validated before anything is written.
The Outlook form offers Thunderbird's shared client ID for accounts that
can't register their own Azure app.
The attachment download directory lives at the bottom.
Permissions
The grid of accounts and tools described under Permissions.
Providers
The [providers.*] overrides described under
Overriding provider endpoints, without
writing TOML table syntax.
Doctor
Runs the full check, connection included, and shows the result.
Signing in
Signing in happens in the window too: the password prompt for app-password
providers, and the full device-code flow for Outlook, so neither needs a
terminal. Credentials go to the same keyring (or 0600 file) the CLI uses; the
config file never holds a secret. Outlook's device-code step still opens your
browser, because the page you approve on is Microsoft's.
It is the same file
It reads and writes the very same file the CLI and server use, through the same parser:
- a hand-edited config opens correctly in the window
- saving one account leaves every other line, comment and ordering untouched
- a change that would not load is refused rather than written
- an account too broken to load is still listed and still opens — which is the case you most need it for