Connect Apple Calendar
Connect iCloud Calendar to Harmonise using your Apple Account email and an Apple app-specific password.
Before you begin
- An Apple Account with iCloud Calendar
- Two-factor authentication enabled for the Apple Account
- An Apple app-specific password
Connect Apple Calendar to see your iCloud Calendar events alongside your other plans in Harmonise.
If you have permission to edit an Apple calendar, Harmonise can also sync supported event changes back to iCloud Calendar.
To connect, you will need your Apple Account email and an app-specific password generated by Apple.
Do not use your normal Apple Account password when connecting Apple Calendar to Harmonise.
Before you begin
Make sure:
- You can sign in to the Apple Account that contains the calendars you want to connect.
- iCloud Calendar is enabled for that account.
- Two-factor authentication is enabled for your Apple Account.
Apple requires two-factor authentication before you can create an app-specific password.
When connecting, you will use:
- Your Apple Account email
- An Apple-generated app-specific password
An app-specific password is a separate password that allows Harmonise to connect to your iCloud Calendar without requiring your normal Apple Account password.
Your Apple connection shares the same connected-account allowance as Google, Outlook, Yahoo, and CalDAV accounts.
Create an Apple app-specific password
Before connecting Apple Calendar in Harmonise, create an app-specific password from your Apple Account.
- Go to account.apple.com and sign in.
- Open Sign-In and Security.
- Select App-Specific Passwords.
- Select Generate an app-specific password.
- Enter a name that helps you recognise the connection, such as Harmonise.
- Follow Apple’s prompts to generate the password.
- Copy the app-specific password shown by Apple.
Keep this password available while you connect your account in Harmonise.
Use this generated password in Harmonise instead of your normal Apple Account password.
Do not enter your:
- Normal Apple Account password
- Device passcode
- Two-factor authentication verification code
into the app-specific password field in Harmonise.
Connect on mobile
Once you have created your app-specific password:
- Open Settings > Calendars.
- Under Calendar integrations, select Connect Apple Calendar.
- Enter your Apple ID email.
- Enter the App-specific password you generated from Apple.
- Select Connect Apple Calendar.
- Wait for Harmonise to verify the connection and find your calendars.
Your connection may briefly show Pending while Harmonise verifies your account and discovers the calendars available through iCloud.
After connecting
Once connected, you can:
- Show or hide calendars
- Turn Sync on or off
- Choose an eligible default calendar
- Map connected calendars to calendars in Harmonise
See Choose calendars from a connected account for more information.
Editing Apple Calendar events
What you can change depends on your access to each Apple calendar.
- Read-only calendars can be viewed in Harmonise but cannot receive event changes.
- Editable calendars can receive supported event creates, edits, and deletions.
Recurring events may ask whether you want to change one occurrence or more of the series.
Tasks remain Harmonise Tasks and do not become Apple Reminders.
Calendar names and colours
The names and colours of connected Apple calendars are controlled by Apple Calendar.
If you rename or recolour a calendar in Apple Calendar, use Refresh calendars in Harmonise to retrieve the latest calendar information.
Calendars created directly in Harmonise can be renamed and recoloured within Harmonise.
Refresh or sync your calendars
Use Refresh calendars when you:
- Create a new iCloud calendar
- Remove an iCloud calendar
- Rename a calendar
- Change calendar sharing
- Change your access to a calendar
Use Sync now if an existing calendar is connected but its events appear out of date.
Some changes may take a short while to appear.
If your app-specific password is rejected
First check that you entered:
- The correct Apple Account email
- An app-specific password generated by Apple rather than your normal Apple Account password
If the app-specific password still does not work, generate a new one from your Apple Account and try again.
If you recently changed or reset your Apple Account password, Apple automatically revokes your existing app-specific passwords. You will need to generate a new app-specific password before Harmonise can connect again.
Use Replace credentials when available to update the connection.
If replacing the credentials does not restore the connection, disconnect Apple Calendar and connect it again using the new app-specific password.
If you cannot create an app-specific password
Make sure two-factor authentication is enabled for your Apple Account.
Apple requires two-factor authentication before app-specific passwords can be generated.
If App-Specific Passwords does not appear under Sign-In and Security, check your Apple Account security configuration before trying again.
Replace your Apple credentials
If the app-specific password used by Harmonise has been revoked or needs to be replaced:
- Go to account.apple.com.
- Open Sign-In and Security.
- Select App-Specific Passwords.
- Generate a new app-specific password for Harmonise.
- Copy the new password.
- Return to Harmonise.
- Use Replace credentials when available.
If replacing the credentials does not restore the connection, disconnect the Apple account and connect it again using the new password.
Disconnect Apple Calendar
Select Disconnect from the Apple Calendar connection in Harmonise to stop syncing that Apple Account.
Disconnecting the account from Harmonise:
- Stops future synchronization with that account
- Does not delete your calendars from iCloud
- Does not delete events stored with Apple
- Does not affect other calendar accounts connected to Harmonise
If you also want to revoke the credential used by Harmonise, return to App-Specific Passwords in your Apple Account and revoke the password you created for Harmonise.
Keep your credentials private
Treat your app-specific password like any other account credential.
Do not send your Apple Account password or app-specific password in a support message, email, or screenshot.
If you need help troubleshooting a connection, you can safely provide:
- The connection status shown in Harmonise
- The steps you completed in the mobile app
- The visible error message
Do not include the password itself.