Connect a CalDAV calendar
CalDAV is an open standard protocol for accessing calendars over the internet. Many services support it, for example Fastmail, Nextcloud, SOGo, Radicale, Baikal and Synology Calendar.
Steps
-
Gather your CalDAV details
Before connecting, you need to find out the details of your CalDAV server. You usually find them:
- in your provider’s help or documentation,
- on your account settings page,
- in the e-mail your provider sent you when you signed up.
You’ll need:
- Server address – often the bare server address is enough, e.g.
cloud.example.com, and we look up the exact path to your calendars ourselves. Otherwise enter the full CalDAV URL, e.g.https://example.com/dav. - Username – usually your e-mail address or the account’s username
- Password – your account password or an app password
The details for Fastmail, Nextcloud, SOGo and Synology Calendar are listed below under Popular CalDAV providers.
-
Go to the Calendars page
In SyncMyDay, click Calendars in the menu, or go straight to the Calendars page.
-
Click “Other CalDAV”
In the Other providers list below the main tiles, click Other CalDAV.
-
Enter your CalDAV credentials
Fill in the form with the details you gathered:
- Server address – the server address or the CalDAV URL itself, for example:
https://caldav.fastmail.comhttps://nextcloud.example.com/remote.php/davcaldav.example.com(we addhttps://automatically)
- Username – usually your e-mail address (e.g.
you@example.com) or username - Password – your account password or an app password (if your provider requires one)
- E-mail (optional) – shown with the calendar if it differs from the username
If you enter the e-mail address of a provider that has its own form, we offer to switch to it. For an address on a custom domain, we try to look up its CalDAV server and fill in its address if you haven’t entered one yet.
- Server address – the server address or the CalDAV URL itself, for example:
-
Let SyncMyDay find your calendars
Click Find calendars. SyncMyDay then:
- checks that the server is reachable over HTTPS,
- signs in with your credentials,
- looks up the available calendars.
This usually takes a few seconds.
-
Choose calendars
You’ll see a list of the calendars available on your CalDAV server. Tick one or more calendars you want to sync and click Complete Setup. Each ticked calendar becomes a separate calendar in SyncMyDay, with its own colour and its own rules. It keeps its name from the server; you can change the name and colour later on the calendar’s page. You can also add more calendars from the account later with Add another calendar from this account on the calendar’s page.
Typically you’ll see calendars like these:
- Personal – your main calendar
- Work – work events
- Family – a shared family calendar
- any custom calendars you’ve created
A calendar marked Read-only can only be the source of a one-way rule. Blockers can’t be written into it, and you can’t set up two-way sync with it.
-
Done, the calendars are connected
The calendars you picked are now connected and ready to use, each as its own card in the list.
Popular CalDAV providers
Fastmail
A popular e-mail and calendar service.
- Server URL:
https://caldav.fastmail.com - Username: your Fastmail e-mail address
- Password: your Fastmail password (or an app password if 2FA is on)
Nextcloud
Self-hosted or managed Nextcloud.
- Server URL:
https://your-nextcloud.com/remote.php/dav - Username: your Nextcloud username
- Password: your Nextcloud password or an app password
SOGo
An open-source groupware server.
- Server URL:
https://your-sogo-server.com/SOGo/dav - Username: your SOGo username (often
email@domain.com) - Password: your SOGo password
Synology Calendar
The Calendar package for Synology NAS.
- Server URL:
https://your-nas-address.com:5001/calendar - Username: your Synology DSM username
- Password: your Synology DSM password
Make sure the Calendar package is installed and CalDAV is enabled in the Calendar settings.
Troubleshooting
“We can’t reach the server …” or “The server … has no valid certificate”
Check these common issues:
- Server address: we add
https://automatically. If the bare server address isn’t enough, enter the full CalDAV URL from your provider’s documentation. - Trailing slash: try the address with and without a slash (
/) at the end. - Port number: some servers need an explicit port (e.g.
:8443). - Certificate: we only connect over HTTPS, and for your security we never connect to servers with an invalid certificate (self-signed included). If you run the server yourself, give it a valid certificate.
- Internet access: a server you can only reach from an internal network or over a VPN can’t be connected.
“CalDAV rejected the sign-in details.”
Common causes:
- incorrect username or password,
- you need to use an app password (if 2FA is on),
- wrong username format (try it with and without
@domain.com), - the account is locked or disabled.
Solution: check your credentials, create an app password if needed, or contact your provider.
“We didn’t find any calendar. Please check the server address.”
If no calendars are found:
- Enter the full CalDAV URL from your provider’s documentation instead of the bare server address.
- Make sure you have at least one calendar in your account.
- Check that the calendars aren’t hidden or archived.
- Try creating a test calendar in your provider’s web interface.
Sync stopped and I got an e-mail
When the stored password stops working, SyncMyDay pauses the connection and sends you an e-mail. Open the calendar on the Calendars page, click Edit, fill in New password (optional) and click Save changes. The new password applies to all calendars from the account.
Sync is slow
CalDAV calendars sync every 5 minutes, which is slower than Google Calendar and Microsoft 365:
- This is normal because of the limits of the CalDAV protocol.
- Real-time push notifications aren’t available.
- The polling interval balances response time and server load.
Need faster sync? Consider Google Calendar or Microsoft 365, which support real-time webhooks.
Next steps
Technical details
For developers and IT
CalDAV protocol (RFC 4791)
SyncMyDay implements the CalDAV standard with these requests:
PROPFIND— discovering calendars, their privileges and change tagsREPORT— querying calendar data (calendar-query)PUT— creating and updating blockersDELETE— removing blockers
Service discovery
We find calendar collections with WebDAV service discovery:
- We try the URL you entered; if CalDAV doesn’t answer there, we try
/.well-known/caldav(RFC 6764). - Via
current-user-principalwe find thecalendar-home-setproperty. - We look up the calendar collections in the home set.
- From
current-user-privilege-setwe detect read-only calendars and mark them.
Authentication and security
- Basic Auth: standard HTTP Basic Authentication over HTTPS
- Digest Auth: supported if the server requires it
- HTTPS with a valid certificate only; addresses in internal networks are refused.
- Credentials are encrypted in the database (libsodium).
Polling strategy
Since CalDAV doesn’t support push notifications:
- We check for changes every 5 minutes.
- We compare the calendar’s
getctag/sync-token; if it hasn’t changed, we don’t download the events again. - If it has changed, we fetch the events of the whole sync period with a
REPORTrequest (calendar-query). - At least once an hour, we go through the whole calendar even without a change.
iCalendar format
Events are exchanged in the iCalendar format (RFC 5545):
- We parse
VEVENTcomponents. - We extract
DTSTART,DTENDandSTATUS. - We handle recurrence rules (
RRULE). - We support time zone conversion (
VTIMEZONE).
Known limitations
- No real-time sync: 5-minute polling interval
- Server dependency: requires a correct CalDAV implementation
- Firewall restrictions: the server must be reachable from the internet
Didn't work? Write to us and we will help you.