Connect Google Calendar
This guide walks you through connecting your Google Calendar account to CalendarPipe. Google Calendar uses OAuth 2.0 with PKCE for secure authentication -- you sign in with Google and grant CalendarPipe access to your calendars.
Prerequisites
- A Google account with Google Calendar access
- You must be able to sign in to the Google account in your browser
Connection Steps
1. Start the connection
Navigate to Calendar Connections in the CalendarPipe sidebar and click Add Connection.
Screenshot: Add Connection button
2. Select Google
Choose Google from the list of calendar providers.
Screenshot: Google provider selection
3. Sign in and grant access
You will be redirected to Google's sign-in page. Sign in with the Google account whose calendars you want to sync.
Google will show a consent screen asking you to grant CalendarPipe the following permissions:
- See, edit, share, and permanently delete all the calendars you can access using Google Calendar -- This allows CalendarPipe to read events from source calendars and write synced events to target calendars.
- See your primary Google Account email address -- This identifies which Google account is connected.
Screenshot: Google OAuth consent screen
Click Allow to grant access. CalendarPipe uses the PKCE (Proof Key for Code Exchange) flow automatically for enhanced security.
4. Select calendars
After granting access, you will be returned to CalendarPipe where you can select which calendars from this Google account should be available for sync rules.
Screenshot: Calendar selection after Google connection
Select the calendars you want to use and confirm.
Multiple Google Accounts
You can connect multiple Google accounts to CalendarPipe. Simply click Add Connection again and select Google -- you will be prompted to sign in with a different Google account. This is useful for syncing between personal and work Google calendars.
Re-authorization
If CalendarPipe's required permissions change in a future update, you may need to re-authorize the connection. You will see a notification in CalendarPipe when re-authorization is needed. Simply click through the OAuth flow again to update your permissions.
Troubleshooting
- "Access blocked" error -- Make sure you are signed into the correct Google account. If you have multiple accounts, try using an incognito window to sign in with the specific account you want to connect.
- Calendars not showing -- Only calendars you own or have write access to will appear. Shared calendars with read-only access can be used as source calendars but not as target calendars.
- Connection expired -- CalendarPipe automatically refreshes your Google access token. If a connection stops working, try disconnecting and reconnecting.