Connect a CalDAV calendar

CalDAV is a standard that lets calendar apps access calendars on a compatible server. A CalDAV connection is a direct account connection with ongoing synchronization. It is different from following an ICS URL, which creates a read-only subscription.

Before you begin

Have the server or discovery URL, username, password, and an account label ready. Use the credentials for the CalDAV account, not a different provider password. Harmonise sends the details for verification and does not show the password in calendar settings.

CalDAV support depends on the server and the Harmonise deployment. If the CalDAV card says it is currently unavailable, wait for the deployment to restore the provider capability or use an ICS subscription instead.

On mobile

1. Open Settings > Calendars.
2. Under Calendar integrations, choose Connect CalDAV.
3. Enter an Account label, Server or discovery URL, Username, and Password.
4. Choose Verify CalDAV.
5. Wait for verification and calendar discovery to finish.

Verification can continue after you leave the screen. A status of Pending means Harmonise is still checking the account and discovering calendars.

On web

1. Open Settings.
2. Under Calendar integrations, choose Connect CalDAV.
3. Enter Account label, Server or discovery URL, Username, and Password.
4. Choose Verify CalDAV.
5. Wait for the account card and discovered calendars to appear.

Use Subscribed calendars when you only have an .ics URL. Do not enter an ICS feed URL as a CalDAV server unless the service documents it as a CalDAV endpoint.

After verification

The account card can show Pending, Connected, Error, Revoked, or Paused by plan. The account may initially show Pending while Harmonise verifies the connection and discovers calendars. Once calendars are discovered, open Calendars > Edit to set Visible or Hidden, turn Sync on or off, and choose Save. Use the account card’s mapping control to choose a destination; mapping is saved immediately and does not use this Save action.

Whether a CalDAV calendar is writable depends on the server permission. Read-only calendars can provide planning context but cannot receive Event or Task changes. Writable calendars can receive supported Event creates, edits, and deletions. On web, open a writable Event and choose Edit event; recurring changes may be limited by the server and the Event.

Choose Refresh calendars when the server adds, removes, or changes a calendar or permission. Choose Sync now when Events in an existing, sync-enabled calendar are stale. Provider processing or a server delay can make an update arrive later.

Reconnect or replace credentials

If verification fails, check the server URL, username, and password with the CalDAV service. Some services require a dedicated app password. If the card shows Error or Revoked, choose Replace credentials when it is shown, or disconnect and connect the account again.

If the server is temporarily unavailable or the provider capability is disabled in your deployment, wait and try Verify CalDAV again later. Do not repeatedly submit credentials while the card is still Pending.

CalDAV credentials are private. Do not include the password in a support message; share only the server host, visible status, platform, and safe error text.