Google Cloud Setup Guide

1. Go to the Create Project page in Google Cloud Console.
2. Enter a project name (e.g., MailFeed).
3. Click Create and wait for it to provision.
4. Make sure the new project is selected in the top navigation bar.

Google Cloud Console — Create Project page with project name field

1. Open the Gmail API page in the API Library.
2. Click Enable.
3. Wait for the API to be enabled — you'll see a confirmation with usage metrics.

Gmail API page in API Library with the Enable button highlighted

1. Go to OAuth consent screen.
2. Select External as the user type and click Create.
3. Fill in the required fields:
   • App name: MailFeed
   • User support email: your email address
   • Developer contact: your email address
4. On the Scopes step, click Add or Remove Scopes and add: https://www.googleapis.com/auth/gmail.readonly

Add or Remove Scopes dialog with gmail.readonly scope selected

5. Now configure the audience of users who can access your app. On the Test users step, add the Gmail address you'll use to log in.
6. Click Save and Continue through the remaining steps.

OAuth consent screen configuration with app name, scopes, and test users

1. Go to Credentials and click Create Credentials → OAuth client ID.
2. Set Application type to Web application.
3. Name it anything (e.g., MailFeed Local).
4. Under Authorized redirect URIs, click Add URI and enter:

   http://localhost:3000/api/auth/callback/google

5. Click Create.

Create OAuth client ID form with Web application type and redirect URI

1. After creating the credentials, a dialog shows your Client ID and Client Secret.
2. Copy both values into your .env file:

   GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
   GOOGLE_CLIENT_SECRET="GOCSPX-your-client-secret"

3. You can also find these later under Credentials by clicking the credential name.

This key powers AI semantic search. MailFeed works without it — you can add it later. The simplest way to get one is through Google AI Studio with a Gemini API key.

1. Go to Google AI Studio.
2. Click Create API Key and select your Google Cloud project.
3. Copy the key into your .env file:

   GEMINI_API_KEY="your-gemini-api-key"

Google AI Studio API key creation page