Connect your app to Google Workspace

Google Workspace includes services like Gmail, Google Sheets, Google Calendar, Google Drive, Google Docs, and Google Slides. The Google Workspace connectors enable your Lovable app to securely access and manage data from these services using your Google account. With Google Workspace, your app can:

• Send and read emails with Gmail
• Read and update spreadsheet data in Google Sheets
• Create and manage Google Calendar events
• Upload, organize, and retrieve files from Google Drive
• Generate and edit documents in Google Docs
• Create and update presentations in Google Slides

Each connection is authorized for a single Google account. You can create multiple connections to work with multiple accounts or environments.

​

Common use cases and example apps

These examples show both single-service apps and multi-service workflows. You can combine Google connectors within the same project to build more advanced automation and internal tools.

​

How Google Workspace connections work

Google Workspace connections are workspace-level integrations managed by workspace admins or owners. Admins and owners control which services the workspace connects and which permissions (scopes) each connection uses. This connector uses a single shared Google account for everyone who uses the app. If you need each end user to sign in with their own Google account and act on their own data, use an app user connector instead. All Google Workspace connectors use OAuth 2.0 to securely connect to your Google account. When you create a connection, you sign in with Google and authorize Lovable to access specific services on your behalf. Within your Lovable workspace:

• You can create multiple connections per Google service.
• Each connection is a separate OAuth authorization tied to a Google account.
• Each connection can use different scopes (permissions), so you can control exactly what the connection can access.
• Multiple projects within a single workspace can use the same connection.

This makes it easy to separate environments (for example, development and production) or connect different Google accounts for different purposes. Google Workspace connectors use Lovable’s gateway architecture for secure OAuth handling and automatic token refresh. See Gateway-based connectors for details on authentication and usage limits.

​

Working with shared drives

Google Drive stores files in two locations: My Drive (files owned by an individual account) and shared drives (files owned by the organization). The Google Drive connector can work with both, subject to the connected account’s access. To use a shared drive with the Google Drive, Docs, Sheets, or Slides connector:

• Connect with an account that is a member of the shared drive. The connection can only access shared drives the authorized Google account has been added to. To work with a different shared drive later, add the same Google account as a member of that shared drive too.
• Give that account the role it needs. Reading files requires at least Viewer. Uploading, editing, or creating files requires Contributor or higher. Moving or deleting files requires Content manager or Manager. Members with the Manager role assign these roles in the shared drive’s Manage members dialog.
• Point Lovable at the shared drive in your prompts. Paste the shared drive folder or file URL (or its ID) and mention that it lives in a shared drive, so Lovable builds the feature with shared-drive-aware requests. Files your app creates in a shared drive are owned by the shared drive, not by the connected account, so they stay accessible if that account later leaves the shared drive.

If a request against a shared drive fails with a permission error, confirm the connected Google account is still a member of that shared drive with the required role. Membership and role changes take effect on the next request. If it still fails, open the connection and click Reconnect to refresh its access.

​

How to connect a Google Workspace service

Workspace admins and owners can connect Google Workspace services. When a connection is created, it becomes available across all projects in the workspace.

​

Prerequisites

• A Google account with access to the service you want to connect
• Lovable workspace admin or owner role

​

Set up your Google connection

When connected, your Lovable apps can start using the selected Google service.

​

Connecting multiple Google services

If your app needs to use several Google services (for example, reading data from Sheets and sending results via Gmail), you can create a separate connection for each service. Each connector has its own OAuth flow and scopes, so they are configured independently. You can:

• Connect multiple services to the same Google account
• Use different Google accounts for different services
• Create separate connections for development and production

​

Manage your connection

Connections are managed from Connectors: select , then open the connection.

• Unlink projects to remove access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
• Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use stop working until a new connection is added. See Delete a connection for the steps and who can delete.