Legal

Privacy Policy

Last updated: August 2026  ·  Applies to: google-connector

This Privacy Policy describes how the google-connector NocoBase plugin ("the Plugin") handles data when users connect their Google accounts. The Plugin is open-source software distributed under the MIT License.

Google API Services User Data Policy: The Plugin's use of information received from Google APIs adheres to the Google API Services User Data Policy, including the Limited Use requirements.

What data we collect

When a user connects their Google account, the Plugin stores the following in the NocoBase database (googleConnections table), encrypted at rest:

FieldWhat it isWhy it's stored
googleEmailGmail address of the connected accountDisplayed to the user to confirm which account is connected
accessTokenShort-lived OAuth 2.0 access tokenAuthorises calls to Gmail and Calendar APIs
refreshTokenLong-lived OAuth 2.0 refresh token (encrypted)Obtains new access tokens without requiring re-consent
tokenExpiresAtExpiry timestamp of the current access tokenTriggers automatic refresh before the token expires
scopesOAuth scopes granted by the userRecords exactly what permissions were consented to
statusactive or errorSurfaces token revocation errors to the user

The Plugin does not persistently store Gmail message content (subjects, bodies, headers) or Google Calendar event content (titles, descriptions, times, attendees, locations) in the NocoBase database. This data is fetched from Google, processed transiently in memory for the duration of the requested action, returned to the user or AI employee that requested it, and then discarded by the Plugin — it is not written to any Plugin-managed table. Where that data ends up afterward (e.g. an email body summarized by an AI employee, or shown in a chat transcript) is subject to the data-handling and retention behavior of your NocoBase instance and its configured AI provider, not the Plugin itself.

Google OAuth scopes requested

The Plugin requests the narrowest scope set that supports its features. In particular it does not request gmail.modify, which would additionally permit labelling, archiving, marking read, and trashing messages — the Plugin performs none of those actions, so that authority is never requested.

Google User Data Access

Depending on which AI tool is invoked, the Plugin accesses the following Google user data on behalf of the connected user, and only at the moment a user-requested action needs it — data is not accessed in the background or on a schedule:

Gmail data

Google Calendar data

The Plugin only requests this data when a user (via an AI employee or a Connect Google block action) triggers a specific Gmail or Calendar operation. It does not run background sync jobs and does not pull Gmail or Calendar data without an explicit, user-initiated action.

How Google User Data Is Used

Google user data retrieved by the Plugin is used solely to carry out the specific action the user requested, and for no other purpose. Depending on the feature used, this includes:

The Plugin does not modify Gmail labels, mark messages read/unread, or delete emails. This is not merely a matter of the Plugin choosing not to: because it requests only gmail.readonly and gmail.send, the OAuth grant it holds carries no authority to perform those actions at all. Enabling any of them would require requesting a broader scope, re-obtaining user consent, and an update to this policy.

Sharing, Transfer, and Disclosure of Google User Data

Data isolation between users

Every API call is scoped to the individual NocoBase user who initiated the request. The Plugin verifies the caller's identity before each API call and uses only that user's stored tokens. No user can access another user's email or calendar data through the Plugin.

Data storage and security

Data retention and deletion

Your rights

You may revoke the Plugin's access to your Google account at any time:

Third-party services

The Plugin's own code communicates exclusively with Google APIs (accounts.google.com, www.googleapis.com) to authenticate and to make Gmail/Calendar calls — it does not independently contact any other external service. Separately, when an AI-powered feature is used, Gmail or Calendar data needed for that request is passed through NocoBase's own AI Employee feature to the AI model/provider configured in that NocoBase instance, as described in “Sharing, Transfer, and Disclosure of Google User Data” above. That AI provider is chosen and configured by the NocoBase administrator, not bundled by the Plugin.

Children's privacy

The Plugin is not directed at children under 13. It is intended for deployment within enterprise or personal NocoBase instances administered by adults.

Changes to this policy

Material changes will be reflected by updating the "Last updated" date and noted in the GitHub repository's release notes.

Contact

For questions or data deletion requests, open an issue on the GitHub repository.