Google Calendar

Integrate your application with the Google Calendar API

🚀 Quickstart

Connect to Google Calendar with Nango and see data flow in 2 minutes.

1. Create an integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> Google Calendar.

   Nango has a Nango-managed OAuth app you can use in development and production. Select it when you create the integration.

2. Authorize Google Calendar

   Go to Connections -> Add Test Connection -> Authorize, then log in to Google Calendar. Later, you’ll let your users do the same directly from your app.

3. Call the Google Calendar API

   Let’s make your first request to the Google Calendar API (fetch a list of calendars). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

   cURL

   curl "https://api.nango.dev/proxy/calendar/v3/users/me/calendarList?maxResults=10" \
     -H "Authorization: Bearer <NANGO-API-KEY>" \
     -H "Provider-Config-Key: <INTEGRATION-ID>" \
     -H "Connection-Id: <CONNECTION-ID>"
   

   Node

   Install Nango’s backend SDK with npm i @nangohq/node. Then run:

   import { Nango } from '@nangohq/node';
   
   const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
   
   const res = await nango.get({
       endpoint: '/calendar/v3/users/me/calendarList',
       params: { maxResults: 10 },
       providerConfigKey: '<INTEGRATION-ID>',
       connectionId: '<CONNECTION-ID>'
   });
   
   console.log(res.data);
   

   Or fetch credentials dynamically via the Node SDK or API.

   ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4. Implement Nango in your app

   Follow our Auth implementation guide to integrate Nango in your app.

   To use your own OAuth app instead of the Nango-managed one, follow the setup guide linked below.

📚 Google Calendar Integration Guides

Nango maintained guides for common use cases.

• How to register your own Google Calendar OAuth app
  Register an OAuth app with Google Calendar and obtain credentials to connect it to Nango

• How to setup webhooks with Google Calendar on Nango Set up Google Calendar push notifications using notification channels to receive real-time calendar and event updates

• Google App & Security Review Pass Google’s OAuth app verification to go to production with your own OAuth app (not needed with the Nango-managed app)

Official docs: Google Calendar API documentation

🧩 Pre-built syncs & tools for Google Calendar

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

Others

Function name	Description	Type
add-attendee	Fetch an event, append an attendee, and patch the attendee list	Tool
clear-calendar	Clear the primary calendar by deleting all events.	Tool
create-acl-rule	Create an access control rule	Tool
create-all-day-event	Create an all-day calendar event using start and end dates	Tool
create-calendar	Create a new secondary Google Calendar with the specified title.	Tool
create-event	Create a calendar event	Tool
create-recurring-event	Create a recurring event with supplied start, end, and RRULE values	Tool
delete-acl-rule	Delete an access control rule	Tool
delete-calendar	Delete a calendar	Tool
delete-event	Delete a calendar event	Tool
find-free-slots	Query free/busy data and return gaps meeting a minimum duration.	Tool
get-acl-rule	Get an access control rule by ID	Tool
get-calendar-list-entry	Retrieve a calendar list entry with access role and colors	Tool
get-calendar	Get a calendar by ID	Tool
get-colors	Return available calendar and event color definitions	Tool
get-event	Get an event by ID	Tool
get-setting	Retrieve a single Google Calendar user setting by ID	Tool
import-event	Import an event as a private copy using an iCalendar UID.	Tool
insert-calendar-to-list	Add an existing calendar to the user’s list with optional colors	Tool
list-acl-rules	List ACL rules for a calendar with pagination support	Tool
list-calendar-list	List calendars in the user’s calendar list	Tool
list-event-instances	List instances of a recurring event	Tool
list-events	List events on a calendar	Tool
list-settings	List calendar settings	Tool
list-upcoming-events	List upcoming events from now, ordered by start time	Tool
move-event	Move an event to another calendar, changing its organizer.	Tool
patch-event	Partially update only provided event fields like time, location, or description	Tool
query-free-busy	Return free/busy blocks for one or more calendars in a time range	Tool
quick-add-event	Create an event from a text string	Tool
remove-attendee	Remove an attendee from a Google Calendar event by email	Tool
remove-calendar-from-list	Remove a calendar from the user’s calendar list	Tool
search-events	Search a calendar’s events by text query and optional time bounds	Tool
settings	Fetch all user settings across pages from Google Calendar	Tool
stop-channel	Stop push notifications for a channel	Tool
update-acl-rule	Update an access control rule	Tool
update-attendee-response	Fetch an event and update one attendee’s response status	Tool
update-calendar-list-entry	Update a calendar list entry’s settings	Tool
update-calendar	Update a calendar’s metadata	Tool
update-event	Update a calendar event	Tool
watch-calendar-list	Subscribe to changes in the calendar list	Tool
watch-events	Subscribe to event changes on a calendar	Tool
watch-settings	Subscribe to changes in calendar settings	Tool
whoami	Return the current user’s Google account ID and email	Tool
calendar-events	Incrementally sync full Google Calendar event objects	Sync
calendar-list	Full sync of the user’s calendar list, including access role, colors, primary/selected flags, and deleted status.	Sync
settings	Sync calendar settings	Sync

---