How to connect NotebookLM to Composio

3 min read

Composio connects AI agents to NotebookLM so they can work with notebooks and sources in Google’s Gemini Notebook Enterprise service.

Use your own Google OAuth app to control its credentials and the permissions your workflow requests.

Use an existing Gemini Notebook Enterprise deployment in the Global location. The user needs an active license and the Cloud NotebookLM User role in the deployment project. Use that project’s ID or number when you connect.

Part 1. Set up your Google OAuth app

Step 1. Select a project and enable the API

Open Google Cloud Console and select the project that will own your OAuth client.

Choose the Google Cloud project that owns your OAuth app

In APIs & Services → Library, find the service for your workflow. Enable the Discovery Engine API (discoveryengine.googleapis.com) in the Cloud project used for your Notebook Enterprise deployment.

Step 2. Configure branding and audience

Open Google Auth Platform → Branding. Enter an app name, support email, and developer contact details.

Set up app branding and contact information

Under Audience, choose the audience that matches your users. For an external app in Testing, add the accounts you will use under Test users.

Choose the audience and add test users when needed

Step 3. Choose permissions for your workflow

Open Google Auth Platform → Data Access and select Add or remove scopes. Add the scopes your workflow needs and save.

The toolkit uses discoveryengine.readwrite for its notebook connection. This scope can authorize Discovery Engine writes within the user’s IAM permissions. Review the grant and IAM role before you continue.

The example requests https://www.googleapis.com/auth/discoveryengine.readwrite. Choose scopes for the actions you plan to use.

Notebook Enterprise API prerequisites · Notebook listing scopes and IAM permissions

Step 4. Create the OAuth client

Open Google Auth Platform → Clients, select Create client, and choose Web application.

Choose Web application for the OAuth client

Under Authorized redirect URIs, add the production callback used by the Composio auth form.

https://backend.composio.dev/api/v1/auth-apps/add

Register the Composio production redirect URI

Select Create. Save the client ID and copy or download the client secret before you close the dialog. Google shows the full secret once. Store it privately.

Find the OAuth client settings after creation

Part 2. Connect NotebookLM in Composio

Step 1. Create an auth config

In the Composio dashboard, open Auth Configs → Create and select NotebookLM. Enter a config name and choose Next.

Select OAuth 2.0 if prompted. Choose Your Own Credentials when that option appears. Enter your client ID and client secret, verify the redirect URI, and select the scopes your workflow requires. Then select Create Auth Config.

Step 2. Authorize the account

Open the auth config and select Connect Account. Sign in with a Google account that meets the prerequisites above and review the permissions before you continue.

When Composio prompts for the Google Cloud project, enter the project ID or numeric project number that hosts the Notebook Enterprise deployment. Check the Global location, license, Discovery Engine API, and IAM access if the connection fails.

Step 3. Verify the connection

Return to the auth config and check that the connected account shows Active in Accounts.

Before using the app in production

Review Google’s verification requirements for the audience and scopes you chose. External apps in Testing can receive refresh tokens that expire after seven days. Check the requirements for your app before inviting production users.

Google OAuth verification

Share