Gmail & Google Calendar

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

Create a Google Cloud project

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

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

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.

Create OAuth credentials

Go to APIs & Services → Credentials → Create Credentials → OAuth client ID. Choose Web application and add your redirect URI:

https://api.yourdomain.com/api/oauth/google/callback

Copy your Client ID and Secret

After creating, copy the Client ID and Client Secret.

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:

Go to Integrations
Click + Add Integration → Google Calendar / Gmail
Complete the OAuth flow in the popup

What gets synced

Data	How	Frequency
Sent & received emails	Gmail API	Every 30 min
Calendar events + attendees	Calendar API	Every 10 min

Add a new provider Custom SMTP / IMAP

Getting Started

Installation

Providers

Gmail & Google Calendar

Server Setup

Connecting in Nous

What gets synced

​Server Setup

​Connecting in Nous

​What gets synced

Server Setup

Connecting in Nous

What gets synced