Skip to content

Calendar & contacts

Mailclient can sync your contacts and calendar from a Nextcloud account using CardDAV and CalDAV. Once connected, your contacts power a browsable address book and recipient autocomplete when composing mail, and your calendar is available as month and day views you can edit.

Connect your Nextcloud account

You'll need an app password rather than your normal login password.

  1. In Nextcloud, go to Settings → Security → Devices & sessions and create a new app password (give it a name like "Mailclient"). Copy the generated password — Nextcloud only shows it once.
  2. In Mailclient, open Settings → Calendar & Contacts.
  3. Enter:
    • Server URL — your Nextcloud address, e.g. https://cloud.example.com (no /remote.php/... path; just the base URL).
    • Username — your Nextcloud username.
    • App password — the value you copied above.
  4. Select Connect. Mailclient discovers your address books and calendars and lists them below the form.

Your app password is stored encrypted. To change it later, re-enter it and save again; leaving the password field blank keeps the one already stored.

Choose what syncs

Under Address books & calendars you can Enable or Disable each discovered collection. Only enabled collections are synced and shown on the Calendar page. Select Sync now to refresh immediately, or Disconnect to remove the account and its synced copy from Mailclient (this does not delete anything in Nextcloud).

Use Set default to choose which calendar new events and which address book new contacts are filed into by default; the chosen collection is marked Default. If you don't set one, Mailclient picks a standard collection such as your Personal calendar or Contacts address book. When creating an event or contact you can still switch to any other enabled collection.

Calendar & contacts

Open Calendar from the mailbox sidebar. Calendar and contacts share one page: a month view with your contacts alongside it (a sidebar on wider screens; on a phone, use the Calendar / Contacts toggle at the top to switch between them).

Calendar

  • Switch between Month and Day with the toggle next to the navigation arrows. Each keeps its own arrows/Today for moving between months or days.
  • In month view, select a date number to jump straight to that day's Day view.
  • In day view, events are laid out on a 24-hour timeline, with all-day events shown in a strip above it; overlapping events appear side by side.
  • New event creates an event (title, start/end, all-day, location, notes). Double-clicking (or double-tapping on touch) an empty spot on a day starts a new event there; in day view, double-clicking a particular hour on the timeline starts a new, one-hour-long event at that hour.
  • Select an event to edit or delete it.
  • Recurring events are shown but are read-only in this release — edit them in Nextcloud.

Calendar preferences

Under Settings → Calendar & Contacts, the Calendar section lets you choose:

  • Time format — 24-hour (14:00) or 12-hour (2:00 PM). This governs event times and the day view's hour labels throughout the Calendar page. It also sets the clock style of the new/edit event form's start and end pickers, though that only takes effect in Chrome/Edge — Firefox and Safari's date/time pickers always follow your operating system's locale instead.
  • Start of week — Sunday or Monday. This changes which day the month view's week columns start on.
  • Time zone — the IANA zone (e.g. Europe/Amsterdam) Mailclient uses to display event times, day/month boundaries, and your mailbox's message dates (see Using your mailbox). Defaults to UTC until you choose one. For Nextcloud events that don't carry their own explicit time zone information, Mailclient interprets them using this preference.

Contacts

  • Search by name, organization, or email.
  • New contact adds a contact to an address book (name, organization, and one email/phone per line).
  • Edit and Delete change a contact; the change is written back to Nextcloud.
  • Selecting a contact's email address opens a new message addressed to them.

When composing, start typing a name or address in To, Cc, or Bcc and Mailclient suggests matching contacts.

Troubleshooting

  • "Could not find the DAV principal" — double-check the server URL (base URL only) and that the username/app password are correct.
  • Nothing syncs / no collections found — make sure the account actually has address books or calendars, then use Sync now.
  • Self-hosted on a LAN without HTTPS — Mailclient refuses plain http:// by default. An administrator can allow it with the DAV_ALLOW_INSECURE_HTTP setting, but HTTPS is strongly preferred.
  • Contact photos — inline photos display; contacts whose photo is only a remote link may show initials instead.