Calendar accounts

The calendar on this device, invitations read from mail, connecting Google, Microsoft 365, iCloud, Yahoo, Fastmail and CalDAV calendars, and the offline copy.

Calendar brings together three kinds of calendar. This page explains each one, how to connect calendar accounts, what is stored on this device, and every message you may see while connecting.

KindWhere it livesWhat you can do
My calendarOn this device, encrypted.Add, edit, move and delete events, and invite guests by email.
Invitations in mailIn your mailbox. One per connected mail account.See and answer invitations. Change them only where they came from.
Connected calendarsOn the calendar service: Google, Microsoft 365, iCloud, Yahoo, Fastmail, or any CalDAV server.Everything the service allows. Read-only calendars can only be viewed.

My calendar

My calendar is always there, under ON THIS DEVICE in the sidebar. You need no account to use it.

  • Its events are stored on this computer, encrypted with a key held in this device’s keychain.
  • They are never sent anywhere, except as invitations to guests you add, by your own mail account.
  • They do not appear on your other devices.
  • Settings › Privacy and security › Erase everything on this device deletes it.

Invitations in mail

For every connected mail account, Calendar reads the invitations in that mailbox and shows them in a calendar named Invitations in mail, under INVITATIONS — address.

  • Invitations are found in the most recent messages of the mailbox, the same window Documents and Team read. Under the calendar, a line says how far back that is, such as The last 1,000 of 8,432 messages.
  • Click Look further back to read five times as many messages, up to 25,000. When there is nothing further to read, the line says so, or says Every message in your mail has been read — N of them.
  • You can answer these invitations, but not edit or delete them. See Answer an invitation.
  • If an invitation is also in a connected calendar, it is shown once, from the calendar.

If no mail account and no calendar account is connected, Calendar shows No account is connected, so there are no invitations to read. Events you add are kept on this device.

Open Calendar accounts

Use either:

  • Add calendar account at the foot of the Calendar sidebar, or
  • Settings › Calendar › Calendar accounts › Manage.

The Calendar accounts window says Events you add go to the calendar you choose, and changes made on your phone or the web appear here within a few minutes. It has three parts:

PartWhat it lists
CONNECTEDEach calendar account you have connected, with Remove. Shown once you have one.
FROM YOUR MAIL ACCOUNTSA row for each connected mail account whose calendar Nixt Mail can reach: Google Calendar for Gmail, Microsoft 365 calendar for Outlook, iCloud calendar and Yahoo calendar for those accounts, and IMAP / SMTP calendar for an IMAP account with a Fastmail address. If none can be reached, it says None of your mail accounts has a calendar Nixt Mail can reach on its own. Use one of the services below.
OTHER CALENDAR SERVICESButtons for iCloud, Yahoo, Fastmail and Another CalDAV server.

Press Esc or click Close to close the window.

Connect Google Calendar

For a Gmail account already connected in Mail:

  1. Open Calendar accounts.
  2. Under FROM YOUR MAIL ACCOUNTS, find Google Calendar with the account’s address.
  3. Click Connect. Its tooltip reads Opens Google in the browser to allow calendar access.
  4. In the browser, choose the same Google account, and allow access to both your calendar and your mail.
  5. Return to Nixt Mail. While it waits, the window says Waiting for the browser….

When it works, the window says Google Calendar connected for address**.**, the button reads Connected, and the account’s calendars appear in the sidebar under GOOGLE — address. Google Calendar uses the same sign-in as the mail account; no password is typed into Nixt Mail.

If you close the browser without finishing, nothing changes.

Connect a Microsoft 365 calendar

For an Outlook.com or Microsoft 365 account already connected in Mail:

  1. Open Calendar accounts.
  2. Under FROM YOUR MAIL ACCOUNTS, find Microsoft 365 calendar with the account’s address.
  3. Click Connect. Its tooltip reads Opens Microsoft in the browser to allow calendar access.
  4. In the browser, choose the same account and allow calendar access.

When it works, the window says Microsoft 365 calendar connected for address**.** and the calendars appear under MICROSOFT — address.

Connect iCloud, Yahoo, Fastmail or another CalDAV server

These services connect with an app password — a separate password the service creates for one app — rather than your account password.

  1. Open Calendar accounts.
  2. Do one of the following:
    • Under FROM YOUR MAIL ACCOUNTS, click Set up beside the account’s calendar. The form is filled in with the account’s address.
    • Under OTHER CALENDAR SERVICES, click iCloud, Yahoo, Fastmail or Another CalDAV server.
  3. Read the note above the form. It says where to create an app password for that service.
  4. Check or fill in the fields:
    • Server — filled in for iCloud, Yahoo and Fastmail. For another server, type its CalDAV address, which is on the service’s help page.
    • Email address — the account’s address.
    • User name — usually the email address, and filled in from it.
    • App password — the app password you created.
  5. Click Connect, or press Return in the password field. The button reads Connecting… while Nixt Mail works.

Nixt Mail finds the account’s calendars, starting from the address you gave, before it saves anything. When it works, the window says Connected — N calendars added. If the password is wrong, nothing is saved and the form shows why.

ServiceWhere the note says to create an app password
iCloudAn app-specific password, at appleid.apple.com, under Sign-In and Security › App-Specific Passwords.
YahooAn app password, under Account security › Generate app password.
FastmailAn app password with calendar access, under Settings › Privacy & Security › App passwords.
Another CalDAV serverThe note lists Nextcloud, Radicale, Baïkal, Zimbra, Open-Xchange and Nixt Server as examples, and says the address is often your server’s address followed by /remote.php/dav or /dav.

The password is kept in this device’s keychain. The account’s address, server and user name are kept in Nixt Mail’s settings.

Remove a calendar account

  1. Open Calendar accounts.
  2. Under CONNECTED, click Remove beside the account.

The account’s calendars leave the sidebar, and its stored password is deleted from the keychain. Nothing is deleted from the calendar service.

Keep calendars up to date

  • While Nixt Mail is open, connected calendars are checked again every five minutes, because other people change shared calendars.
  • To check now, click the refresh button in the Calendar header, press R, or choose View › Refresh Calendars.
  • Every change you make is written to the service with the version Nixt Mail last read. If someone else changed the event in the meantime, your change is refused rather than overwriting theirs. Refresh and make the change again.

Keep an offline copy

The offline copy keeps connected calendars on this device so they open at once and can be read without a connection. It is off until you turn it on.

  1. Open Settings › Calendar.
  2. Under Calendar accounts, turn on Offline copy.

With it on, the setting reads Kept encrypted on this device with a key in its keychain. Turning this off deletes the copy. With it off, it reads Connected calendars open from their servers each time, and are empty with no connection.

What the copy holds and how it behaves:

  • The calendars of each connected account, and their events for the few months you last looked at.
  • Encrypted with its own key, held in this device’s keychain.
  • A calendar with a copy opens from it at once, then checks its server and redraws only if something changed.
  • If the server cannot be reached, the copy stays on screen and the sidebar says Can’t reach the server. Showing the copy saved on this device.
  • Refresh always asks the server, even for a calendar just shown from its copy.
  • Turning Offline copy off deletes the copy and its key. Erase everything on this device deletes them too.
  • Restore defaults in Settings › Calendar does not turn it off.

What is stored on this device

ItemWhereWhat it holds
Mail and calendar passwords, and OAuth tokensKeychainApp passwords for CalDAV calendars. A connected Google or Microsoft calendar uses the same sign-in as its mail account.
Calendar accountsOn diskThe address and server of each calendar account. No passwords.
Calendar settingsOn diskThe view, the first day of the week, the working day, and which calendars you hid.
Calendar on this deviceEncrypted on diskThe events in My calendar.
Events from connected calendarsMemory onlyHeld while Nixt Mail is open, unless the offline copy is on.
Offline copy of connected calendarsEncrypted on diskNothing until you turn on Offline copy.
Upcoming calendar remindersHeld by the operating systemOnly with Calendar reminders set to also use the system: the next week of reminders, kept by the operating system’s notification service — not encrypted by Nixt Mail — until each goes off.

See Privacy and security for everything else Nixt Mail stores.

Messages

Messages while connecting appear in red under the form. Messages about a calendar that is already connected appear under its group in the sidebar.

MessageWhat it meansWhat to do
That server address is not a web address (https://…).The Server field is not a complete address.Type the full address, starting with https://.
The address and password are both needed.Email address or App password is empty.Fill in both.
The server did not accept that user name and password. iCloud and Yahoo need an app-specific password, not the account password.The sign-in was refused.Create an app password and use it. Check the user name.
Signed in, but that account has no calendars.The sign-in worked, but the account has no calendars.Create a calendar with the service, then connect again.
This device’s keychain would not keep the password, so the calendar was not added.The password could not be stored.On Linux, start a keychain service such as GNOME Keyring or KWallet, then try again.
No CalDAV account was found at host**.**Nothing at that address answered as a calendar server.Check the address on the service’s help page.
The server did not say where your calendars are kept.The server did not describe the account’s calendars.Check the address; try the full CalDAV address rather than the site’s address.
The server did not answer like a CalDAV server.The address is a web server, but not a calendar server.Check the address.
The server sent a reply Nixt Mail could not read.The server’s reply was damaged or not in the expected format.Try again later, or check the address.
host did not answer in time.The server took too long.Try again.
Could not reach host**.**No connection to the server.Check your connection and the address.
The server redirected without saying where to. or The server redirected too many times.The server’s redirects could not be followed.Use the final address of the CalDAV service.
The server pointed at an address Nixt Mail cannot open.The server redirected to something that is not a web address.Check the address.
host asked for your password over an unencrypted connection, so Nixt Mail did not send it.The server moved the request to an address without encryption, and Nixt Mail withheld the password.Use the service’s https:// address. Typing the password again will not help.
That was address, not address. Choose address in the browser.You signed in to a different Google or Microsoft account.Connect again and choose the right account.
Google signed you in but did not give Nixt Mail the calendar. Try again and leave the calendar permission ticked.Calendar access was not granted.Connect again and allow calendar access.
Google gave the calendar but took away mail. Try again and leave both permissions ticked.Mail access was removed in the browser. Nixt Mail did not save the change, so your mail stays connected.Connect again and allow both.
The calendar server did not accept the sign-in. Remove the calendar account and add it again.The stored app password stopped working.Remove the account and connect it again with a new app password.
The password for this calendar is not in the keychain any more. Remove it and add it again.The stored password is missing.Remove the account and connect it again.
The account’s sign-in is not in the keychain. Sign in to the mail account again.The Google or Microsoft sign-in is missing.Reconnect the mail account.
Google has not given Nixt Mail access to this calendar. Remove the calendar account and connect it again.The stored Google sign-in lacks calendar access.Remove and connect again.
Microsoft did not accept the sign-in for this calendar. Remove it and connect it again.The Microsoft sign-in stopped working.Remove and connect again.
Microsoft asked Nixt Mail to slow down. Try again in a moment.Microsoft is limiting requests.Wait.

Something unclear or out of date on this page? Tell us.