Connect Gmail & Calendar
Use Detris AI for guided setup, or bring your own Google app.
Only need to send emails?
Open Settings → Integrations → Google → Send emails → Connect Gmail. This quick connection requests send-only Gmail access, not permission to read your inbox.
Gmail & Calendar assistant
Open the Gmail & Calendar assistant section under Google. Choose Set up with Detris AI, enter the Google account and select permissions. The AI configures your app and completes the selected consent in the VM. You handle passwords and Google verification only.
Enter passwords and codes on Google’s page, never in chat. Setup is complete only after Detris verifies the connection.
Advanced: your own Google app
- Open Google Cloud. Select or create the project you intend to use. Do not change an unrelated shared project.
- Enable Gmail API and Google Calendar API in APIs & Services.
- Configure Google Auth Platform: app name, contact details and audience. Choose Internal only for accounts in your Workspace organization. Otherwise use External. Add yourself as a test user while Testing; for ongoing use, publish the app when Google permits, then connect. Publishing is not Google verification.
- Create an OAuth client with type Web application, not Desktop. Copy the exact callback shown under Advanced setup in Detris into Authorized redirect URIs.
- Download the client JSON and paste it into Advanced setup → Save Google app. Never paste it into a public document.
- Select the permissions, then continue with AI or use Connect with Google in Advanced setup. Verify the account before approving.
DEV and production use different callbacks. A DEV-only client will not connect production unless its production callback is also configured.
Attachments
Ask the AI to download email attachments to your VM, read a PDF, or attach a VM file to an email or draft. Files stay under /workspace; downloads never overwrite existing files. Transfers support up to 25 MB total and 20 files per call, subject to Gmail’s message limits. Calendar events can link Google Drive files; this does not change their sharing permissions.
Common issues
Redirect URI mismatch
Copy the exact callback from the environment you are using. Check HTTPS, hostname and path, with no extra trailing slash.
Unverified app or access blocked
Confirm that this is your app and intended account. External testing requires a listed test user. Workspace policies may require administrator approval. Publishing is not the same as Google verification, and restricted scopes may require additional review.
Permissions look broader than expected
Google scopes are bundles: Calendar includes calendar deletion. Older grants to the same Google app may also appear. Detris separately enforces the permissions you selected. Ask the AI to compare the request with the page before allowing unexpected new access.
Connection expires during testing
Gmail/Calendar refresh tokens issued to External apps in Testing expire after seven days. For ongoing use, publish the app when permitted and reconnect. Organization policies or Google review may require additional steps.
Manage or remove access
Use the Google card’s action menu for Permissions, Reconnect, Disconnect or Clean up setup. You can also ask the AI to show the same controls in chat.
Cancel setup stops unfinished work. Disconnect removes the connection and requests token revocation. Cleanup asks before deleting a client recorded as created by setup; shared projects, APIs and other clients are preserved. Older/imported clients can be forgotten locally but are not automatically deleted from Google.
Disconnecting API access does not sign the VM out of Google. A signed-in browser can have wider access than the integration permissions. Sign out in the VM when you no longer need that session.