CalDAV Integration
Sync Tymeslot with CalDAV calendars — Nextcloud, Radicale, Zimbra, mailbox.org, iCloud, and Fastmail. Real-time conflict detection with no Google or Microsoft dependency.
Back to Overview
Nextcloud CalDAV Integration
Connect Tymeslot to your Nextcloud calendar — with step-by-step instructions for finding your CalDAV URL, generating an app password, and verifying the sync.
Luka Breitig
Technical Product Builder & AI Developer
📋 Before you begin
- A Nextcloud instance accessible over HTTPS from the public internet — local-only servers will not reach Tymeslot's sync service
- The Nextcloud Calendar app installed and at least one calendar created
- Your Nextcloud username (the short login name, not an email address unless you log in with email)
What you will have at the end
Tymeslot will read events from your Nextcloud calendar to block unavailable time slots, and write new bookings back to Nextcloud as events.
Nextcloud Calendar and CalDAV
Nextcloud ships CalDAV support out of the box. Every calendar you create in the Nextcloud Calendar app is immediately accessible via a CalDAV URL — no plugins or configuration required. Tymeslot uses that URL to sync events bidirectionally using your account credentials.
Because Nextcloud supports app passwords, you can give Tymeslot its own revocable credential that never touches your main account password. This is the recommended approach even if two-factor authentication is not enabled.
1 Find your Nextcloud CalDAV URL
Tymeslot needs the URL for a specific calendar, not the account-level principal URL. The easiest way to get the right URL is directly from the Calendar app.
- 1 Open the Calendar app in Nextcloud.
- 2 In the left sidebar, hover over the calendar you want to sync. Click the three-dot menu (⋯) that appears to the right of the calendar name.
- 3 Click [Copy private link]. This copies the CalDAV URL for that specific calendar to your clipboard.
The URL will look like this:
https://your-nextcloud.com/remote.php/dav/calendars/USERNAME/personal/
Replace your-nextcloud.com
with your Nextcloud domain,
USERNAME
with your Nextcloud username, and
personal
with the internal name of your calendar (visible in the URL after you copy it).
Account URL vs calendar URL
Some CalDAV clients give you the account-level URL
(
/remote.php/dav/calendars/USERNAME/
without a calendar name at the end). Tymeslot requires a specific calendar URL with the calendar name appended. The per-calendar URL is what you get from the Calendar app's three-dot menu.
2 Generate an app password
App passwords let Tymeslot authenticate without your main account password. If two-factor authentication is enabled on your Nextcloud account, an app password is required. Even without 2FA, it is the recommended approach.
- 1 Click your avatar in the top-right corner of Nextcloud and select [Personal settings].
- 2 In the left sidebar, click [Security].
- 3 Scroll to the App passwords section. Enter a descriptive name — for example, Tymeslot — in the text field.
- 4 Click [Create new app password]. A password appears — copy it immediately. It will not be shown again.
Copy now — shown once
Copy the generated app password before navigating away. Nextcloud only displays it once. If you lose it, delete the app password entry and generate a new one.
3 Add the calendar in Tymeslot
- 1 Go to [Dashboard] → [Settings] → [Integrations].
- 2 Find the [CalDAV] section and click [Add CalDAV Calendar].
- 3 Enter the Server URL you copied from Nextcloud, your Nextcloud Username, and the app password you just generated.
- 4 Click [Save]. Tymeslot tests the connection immediately. On success, your calendar name appears in the Integrations list with a green status.
🔧 Troubleshooting
"Authentication failed"
If two-factor authentication is enabled on your Nextcloud account, your main account password will not work — Nextcloud blocks it for third-party access. You must use an app password generated in Personal settings → Security. Also confirm the username is your short Nextcloud login name, not an email address (unless you sign in to Nextcloud using an email).
"Calendar not found" or "404 Not Found"
The URL is pointing to the wrong path. Make sure you copied the per-calendar URL (ending with the calendar name, like
/personal/),
not the account-level URL. Confirm the trailing slash is present. Internal calendar names are case-sensitive — check the URL against what the Calendar app generated.
Connection succeeds but new bookings don't appear in Nextcloud
The calendar may be read-only or shared to you without write access. Verify the connected calendar belongs to your Nextcloud user (not shared from another user) and that the app password was generated under the same account that owns the calendar.
Events aren't blocking availability after sync
CalDAV sync runs on a schedule — allow up to 5 minutes for new events to be picked up. If still not blocked after 5 minutes, check the sync status indicator in [Integrations]. A red indicator shows the sync failed; click it for the error detail.
❓ Frequently Asked Questions
How do I find the internal name of my calendar?
The internal name is the last path segment of the CalDAV URL. When you copy the private link from the Calendar app's three-dot menu, the URL ends with that name — for example,
/personal/
or
/work/.
The display name shown in the sidebar may differ from the internal URL path.
Can I sync multiple Nextcloud calendars?
Yes. Add one CalDAV integration per calendar in Tymeslot — each one connects to a separate per-calendar URL. Go to [Integrations] and click [Add CalDAV Calendar] for each additional calendar. You can then choose which calendar each event type reads from and writes to.
Do I need 2FA enabled to generate an app password?
No. App passwords can be created whether or not two-factor authentication is active. If 2FA is enabled, app passwords become required for third-party CalDAV access. Even without 2FA, generating a dedicated app password is recommended so you can revoke Tymeslot's access independently without changing your main password.
My Nextcloud runs on a home server — will this work?
Only if your Nextcloud is reachable from the public internet over HTTPS. Tymeslot's sync service reaches out to your server — it does not receive inbound connections. A server at a private IP (192.168.x.x) or behind a VPN without a public DNS record will not work. You need a public domain with a valid TLS certificate pointed at your Nextcloud.
🔗 Related Articles
Radicale CalDAV Integration
Connect Tymeslot to a self-hosted Radicale server. Covers the collection URL format, account password authentication, case-sensitive paths, and network requirements.
Zimbra CalDAV Integration
Connect Tymeslot to Zimbra Collaboration Server via CalDAV. Covers the DAV URL format, user@domain authentication, named calendars, and admin-managed account considerations.