Connect Apple iCloud
You connect Apple iCloud through CalDAV with an app-specific password. Apple requires one for all third-party apps, because two-factor authentication is mandatory for Apple accounts.
Before you start
- an Apple ID with calendars in iCloud,
- two-factor authentication (turned on automatically for Apple accounts),
- access to account.apple.com, where you create the app-specific password.
Create an app-specific password
-
Sign in at account.apple.com
Open account.apple.com in your browser and sign in with the email and password of your Apple ID. This is the only place where you enter your regular password.
-
Verify with two-factor authentication
Apple sends a six-digit code to your trusted devices (iPhone, iPad, Mac). Type it in.
The code arrives on a device signed in with the same Apple ID. -
Open Sign-In and Security
On your account page, click the Sign-In and Security section.
-
Click “App-Specific Passwords”
In the Sign-In and Security section, click App-Specific Passwords.
-
Create a new password
Click + and give the password a name, for example
SyncMyDay. The name helps you find it later if you want to revoke it. Confirm with Create; Apple may ask for your Apple ID password again. -
Copy the password
Apple creates a password in the format
abcd-efgh-ijkl-mnop.
Connect the calendar in SyncMyDay
-
Go to the Calendars page
Go back to SyncMyDay and click Calendars in the main menu, or go straight to the Calendars page.
-
Click “Apple iCloud”
Click the Apple iCloud tile.
-
Enter your Apple ID and app-specific password
Fill in the Connect Apple iCloud form:
- Your Apple ID: the email of your Apple ID (e.g. anna@icloud.com)
- Password: the app-specific password from the previous step (with or without the dashes)
You don't need to enter a server or calendars, we find them ourselves. Continue with Find calendars.
-
Choose calendars
Your iCloud calendars appear. Tick one or more calendars you want to sync and confirm with Complete Setup. Each ticked calendar becomes a separate calendar in SyncMyDay, with its own colour and its own rules. It keeps its name from iCloud; you can change the name and colour later on the calendar's page. Calendars marked Read-only (for example shared ones without write access) can only be used as a source.
-
Done, your calendars are connected
Each iCloud calendar you picked appears in the list as its own card with the Active label, and you can use it in a sync rule right away.
Troubleshooting
The connection failed
Common causes: you entered your Apple ID password instead of an app-specific password, there is a typo in the email or password, or the app-specific password was revoked.
Solution: check the email (including @icloud.com or @me.com), create a new app-specific password and try again.
I can't see “App-Specific Passwords”
Two-factor authentication isn't turned on for the account. Turn it on in the Sign-In and Security section; the item then appears.
Why don't changes show up immediately?
iCloud (CalDAV) can't report changes itself the way Google or Microsoft do. So we check the calendar every 5 minutes, and changes show up within a few minutes. If you need near real-time sync, use Google Calendar or Microsoft 365 as the source.
Syncing stopped and I got an email
When the saved password stops working (for example after the app-specific password was revoked), SyncMyDay pauses the connection and sends you an email. Create a new app-specific password, 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.
How do I revoke the app-specific password?
On account.apple.com, open Sign-In and Security → App-Specific Passwords and revoke the one named “SyncMyDay”. Syncing then stops working; disconnect the account's calendars in SyncMyDay as well.
Next steps
Technical details
For developers and IT
CalDAV protocol
- Server:
https://caldav.icloud.com; we find the path to your calendars automatically (DAV service discovery). - Sign-in: Apple ID and app-specific password.
Checking for changes
- CalDAV doesn't support push notifications, so we check the calendar every 5 minutes.
- First we compare the calendar's
getctag/sync-token. If it hasn't changed, we don't download the events again; at least once an hour we go through the whole calendar.
Credential storage
- We store the app-specific password encrypted (libsodium) and use it only for syncing.
- We delete it as soon as you disconnect the account's last calendar.
Compatibility
- Calendars on iCloud.com and calendars synced to iCloud from an iPhone, iPad or Mac.
- Shared iCloud calendars; without write access only as a source.
Didn't work? Write to us and we will help you.