Connect Apple Calendar
This guide walks you through connecting your Apple Calendar (iCloud) to CalendarPipe. Apple Calendar uses the CalDAV protocol with an app-specific password for authentication -- this keeps your main Apple ID password secure.
Prerequisites
- An Apple ID with iCloud Calendar enabled
- Two-factor authentication (2FA) must be active on your Apple ID (required for app-specific passwords)
- Access to your Apple ID settings at appleid.apple.com
Step 1: Generate an App-Specific Password
Before connecting in CalendarPipe, you need to create an app-specific password from your Apple ID settings.
Do not use your regular Apple ID password. CalendarPipe requires an app-specific password, which is a separate password that grants limited access to your account.
- Go to appleid.apple.com and sign in with your Apple ID
- Navigate to Sign-In and Security
- Click App-Specific Passwords
- Click the + button to generate a new password
- Enter the label "CalendarPipe" (this helps you identify it later)
- Click Create
- Copy the generated password -- you will not be able to see it again
Screenshot: Apple ID app-specific passwords page
The app-specific password will look something like abcd-efgh-ijkl-mnop. Save it somewhere safe until you have completed the connection in CalendarPipe.
Step 2: Connect in CalendarPipe
- Navigate to Calendar Connections in the CalendarPipe sidebar
- Click Add Connection
- Select Apple from the list of providers
Screenshot: Apple provider in CalendarPipe
- Enter your Apple ID email address
- Paste the app-specific password you generated in Step 1
Screenshot: Apple Calendar credentials form
- Click Connect
- Select which iCloud calendars you want to use in CalendarPipe
Revoking Access
If you ever want to disconnect CalendarPipe from your Apple Calendar, you can revoke the app-specific password:
- Go to appleid.apple.com
- Navigate to Sign-In and Security > App-Specific Passwords
- Click the x next to the "CalendarPipe" password
- Confirm revocation
This immediately prevents CalendarPipe from accessing your Apple calendars.
Troubleshooting
- "Authentication failed" error -- Make sure you are using an app-specific password, not your regular Apple ID password. If the password was recently generated, wait a minute and try again.
- No calendars found -- Verify that iCloud Calendar is enabled in your Apple ID settings (System Settings > Apple ID > iCloud > Show More Apps > iCloud Calendar).
- 2FA not enabled -- App-specific passwords require two-factor authentication. Enable 2FA in your Apple ID settings before generating an app-specific password.
- Password expired -- App-specific passwords remain valid unless manually revoked. If your connection stops working, generate a new app-specific password and reconnect.