Skip to main content
This requires registering a Google OAuth app. You do this once as the server admin — your users then connect their own Google accounts via the UI.

​
Server Setup

1

Create a Google Cloud project

Go to console.cloud.google.com and create a new project (or use an existing one).
2

Enable Gmail API and Google Calendar API

In the sidebar go to APIs & Services → Library. Search for and enable both:
  • Gmail API
  • Google Calendar API
Screenshot 2026 05 18 At 11 07 39 AM
3

Configure the OAuth consent screen

Go to APIs & Services → OAuth consent screen. Choose External, fill in the app name and your email, then add these scopes:
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/calendar.readonly
Add your own email as a test user while in development.
4

Create OAuth credentials

Go to APIs & Services → Credentials → Create Credentials → OAuth client ID. Choose Web application and add your redirect URI:
Screenshot 2026 05 18 At 11 10 20 AM
https://api.yourdomain.com/api/oauth/google/callback
Screenshot 2026 05 18 At 11 11 57 AM
5

Copy your Client ID and Secret

After creating, copy the Client ID and Client Secret.
6

Add to nous.env

GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_OAUTH_REDIRECT_URI=https://api.yourdomain.com/api/oauth/google/callback
Restart your containers after saving.

​
Connecting in Nous

Once the server is configured, each workspace connects their own Google account:
  1. Go to Settings → Integrations
  2. Click + Add Integration → Google Calendar / Gmail
  3. Complete the OAuth flow in the popup

​
What gets synced

DataHowFrequency
Sent & received emailsGmail APIEvery 30 min
Calendar events + attendeesCalendar APIEvery 10 min