---
title: "Rocket Chat Google OAuth Configuration Guide"
slug: "google-oauth-setup"
description: "Configure Google OAuth for Rocket Chat. Enable secure login, identity management, and resilient collaboration."
updated: 2026-08-18T16:23:53Z
published: 2026-08-18T16:23:53Z
canonical: "docs.rocket.chat/google-oauth-setup"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Google OAuth Setup

You can allow users to sign in to your Rocket.Chat workspace with their Google accounts. This makes logging in fast and secure.

## Prerequisites

Before setting up Google OAuth, you need:

- A project in the [Google Cloud Console.](https://console.cloud.google.com/welcome/new?pli=1)
- A consent screen. You can create one under **API & Services > OAuth consent screen**, then fill in the required fields.
- OAuth credentials (Client ID and Client Secret).
  - To create them, go to **Credentials > Create Credentials > OAuth client ID**.
  - Choose **Web application** as the application type.
  - Enter the required details, including the **Authorized redirect URIs** shown below:

```plaintext
https://YOUR DOMAIN/_oauth/google?close
https://YOUR DOMAIN/_oauth/google
```

> [!WARNING]
> Be sure to include the `?close` variant to avoid the error: `Error 400: redirect_uri_mismatch`.
> 
> See [this reference](https://github.com/RocketChat/Rocket.Chat/issues/16919#issuecomment-601321898) for detailed information.

After creating the OAuth client, copy the **Client ID** and **Client Secret** (or download the JSON file). You’ll use these while configuring Google OAuth in your Rocket.Chat workspace.

## Configure Google OAuth

Once you have your Client ID and Client Secret, configure Google OAuth in Rocket.Chat:

1. In your Rocket.Chat workspace, go to **Manage → Workspace → Settings → OAuth** and expand the **Google** section.
2. Toggle **Google Login** to **on**.
3. Enter your **Google ID** and **Google Secret** (from the credentials you created).
4. Verify that the **Google Callback URL** matches one of the authorized redirect URIs you set in your Google project.
5. Click **Save changes**.

After saving, a **Sign in with Google** button will appear on your workspace login page. Users can now sign in with their Google accounts.