Connect and manage your email accounts in Clarnix

Connecting an account

Clarnix works alongside your existing email. It never replaces your mail app, and your messages stay where they are.

• Gmail: sign in with Google. Clarnix asks to read and organise your mail and to read your calendar in the same consent screen. If you decline the calendar part, everything else still works.
• Outlook: sign in with Microsoft.
• iCloud: a dedicated option that fills in Apple’s server settings for you.
• Any other provider: the generic IMAP form takes your address, server, port, username and password.

Your password or access token is encrypted before it is stored, with a key derived for your account alone.

iCloud rejects my password

That is expected, and it is not a mistake on your part. Apple requires two-factor authentication on every Apple Account, which means no mail app can ever sign in with your normal Apple password. You need an app-specific password instead.

1. Generate an app-specific password in your Apple Account settings. Apple explains how at support.apple.com/en-us/102654.
2. Paste that password into the iCloud form in Clarnix instead of your usual one.
3. Leave the server and port as they are. The iCloud option fills them in for you.

Several other providers work the same way once two-factor authentication is on. If yours rejects a password that you know is correct, look for an "app password" in its security settings.

Nothing is saved until the password works

When you add an IMAP account, Clarnix opens a real connection and lists your folders before saving anything. If the details are wrong, the account is not created at all and you see the mail server’s own explanation, so there is never a half-connected account to clean up, and never an account that looks connected but quietly does nothing.

Gmail and Outlook go through their provider’s own sign-in, so there is no password for Clarnix to test.

Keeping an account out of your briefing

Each account has an "include in briefing" setting, on by default. Turn it off and the account is still polled, its mail is still classified, and your rules still fire on it. It is simply left out of the briefing you read.

That is the right setting for a shared inbox you want automated but do not want to read about every morning. Switching the account off entirely is different: that stops polling, classification and rules together.

If you exclude every account, no briefing is generated at all. That is the most common reason briefings stop arriving unexpectedly.

An account that stopped signing in

Passwords change and access gets revoked. Clarnix does not quarantine an account over one bad moment: it takes at least five failures spread over at least a day before an account is marked as broken, and a daily recheck can heal it on its own.

When an account does break you get an email and a notification in the app. Use Reconnect on the account to sign in again, or Update credentials for an IMAP account whose password changed. Reminders follow at 7 and 30 days, and an account still broken after 60 days is deactivated.

Disconnecting an account

Disconnecting deletes the account and its stored credentials from Clarnix and stops any further sync.

Disconnecting a single account does not withdraw the permission you granted at Google or Microsoft. To remove that too, visit Google Account → Security → Third-party access, or your Microsoft account permissions page. Deleting your whole Clarnix account is handled differently. See the Settings page.