Gmail Integration
Connect your Berkeley Gmail to search professor emails and course communications. OpenMind uses read-only access — it can never send, delete, or modify your emails.
What you'll need
- - A Google account (your @berkeley.edu or personal Gmail)
- - Access to Google Cloud Console
Create a Google Cloud Project
Go to console.cloud.google.com and create a new project.
Name it something like OpenMind.
Enable the Gmail API
In your project, go to APIs & Services → Library.
Search for Gmail API and click Enable.
Configure OAuth Consent Screen
Go to APIs & Services → OAuth consent screen.
Select External user type.
Fill in the required fields (app name, user support email, developer email). The rest can be left blank.
Add scopes: gmail.readonly
Add your email as a test user.
Create OAuth Credentials
Go to APIs & Services → Credentials.
Click + Create Credentials → OAuth client ID.
Choose Desktop app as the application type.
Click Download JSON — this is your credentials.json file.
Save the file somewhere you can find it:
~/Downloads/credentials.json Enter in OpenMind Setup
Run openmind setup gmail and provide the path to your credentials file:
The first time you ask OpenMind about email, a browser window will open to authorize read-only access.
Security
OpenMind uses gmail.readonly scope only — it cannot send, delete, or modify emails. Credentials are stored locally at ~/.openmind/gmail/. Email content is sent to the LLM only when you ask about it.