All guides

Connect Apple iCloud

  • About 7 minutes
  • Apple ID and app-specific password

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.

At a glance: first you create an app-specific password at Apple, then you enter it in SyncMyDay.

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.
You don't enter your Apple ID password in SyncMyDay, but a separate app-specific password.

Create an app-specific password

  1. 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.

  2. 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.
  3. Open Sign-In and Security

    On your account page, click the Sign-In and Security section.

  4. Click “App-Specific Passwords”

    In the Sign-In and Security section, click App-Specific Passwords.

  5. 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.

  6. Copy the password

    Apple creates a password in the format abcd-efgh-ijkl-mnop.

Connect the calendar in SyncMyDay

  1. Go to the Calendars page

    Go back to SyncMyDay and click Calendars in the main menu, or go straight to the Calendars page.

  2. Click “Apple iCloud”

    Click the Apple iCloud tile.

  3. 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.

  4. 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.

  5. 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.