How to Connect NotebookLM to Antigravity (MCP)

This guide walks you through connecting your Google NotebookLM account to Antigravity using the NotebookLM MCP Server, allowing Antigravity to query your notes and sources directly.

1. Prerequisites

Before starting, ensure you have:

• Google Account: A valid Google account with access to NotebookLM.

Tip: It is recommended to use a secondary or dedicated Google account for automation to avoid potential security flags on your main account.

• Python or Node.js installed on your system.
• uv (recommended for Python) or npm (Node.js).

2. Installing notebooklm-mcp-server

We recommend using uv for a clean, isolated installation.

Option A: Using uv (Recommended)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install the server tool
uv tool install notebooklm-mcp-server

Option B: Using pipx

pipx install notebooklm-mcp-server

Option C: Using npm

npm install -g @roomi-fields/notebooklm-mcp

3. Authenticating with NotebookLM

Authentication is handled by launching a browser to capture your session cookies.

Run the authentication command

# If installed via uv/pipx:
notebooklm-mcp-auth

# If installed via npm:
npx -y @roomi-fields/notebooklm-mcp auth

Log In

A Chrome window will open. Log in to your Google Account.

Complete Authentication

Once the terminal displays a success message, you can close the browser window.

Note: Cookies are typically saved to ~/.notebooklm-mcp/auth.json. Keep this file secure.

4. Configuring MCP in Antigravity

1. Open Antigravity.
2. Navigate to Agent Side Panel → MCP Servers.
3. Click Configure or View Raw Config to open mcp_config.json.
4. Add the notebooklm entry to the mcpServers object.

For uv/pipx installations

{
  "mcpServers": {
    "notebooklm": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "notebooklm-mcp-server"
      ],
      "env": {}
    }
  }
}

For npm installations

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": [
        "-y",
        "@roomi-fields/notebooklm-mcp"
      ]
    }
  }
}

5. Save the file. Antigravity should automatically attempt to connect.

Look for a green status indicator next to notebooklm in the MCP server list.

5. Verifying the Connection

1. In the Antigravity chat interface, type / to view available tools.
2. Confirm tools such as notebooklm_list_notebooks or notebooklm_query appear.
3. Ask:

List my notebooks in NotebookLM.

If the connection is successful, Antigravity will return your available notebooks.

6. Common Issues & Fixes

Authentication Failures (401/403)

Symptoms:

• "Unauthenticated" errors
• Immediate query failures

Fixes:

• Re-run notebooklm-mcp-auth to refresh expired cookies.
• Ensure authentication completed successfully before closing the browser.

MCP Configuration Errors (Red Status)

Symptoms:

• Antigravity displays a disconnected or red status icon.

Fixes:

• Verify the command path.
• Run:

which uv

and use the full executable path in your configuration.

• Check configuration and log files for permission-related errors.

Connection Closed (-32000)

Symptoms:

• "Connection closed unexpectedly" error.

Fix:

Run the server manually:

uv tool run notebooklm-mcp-server

Review the terminal output for missing dependencies, authentication issues, or startup failures.

Windows-Specific Issues

• Use full executable paths such as:

C:\\Users\\YourName\\AppData\\...\\uv.exe

• Escape backslashes properly when editing JSON files.

7. Best Practices

Use a Dedicated Account

A separate Google account reduces the likelihood of security challenges and cookie expiration issues.

Disable When Not in Use

Remove the MCP configuration when idle to conserve resources and avoid unnecessary authentication refreshes.

Profile Selection

Some versions support profiles such as:

• minimal
• standard
• full

Choose the profile that best matches your needs and context window requirements.

Conclusion

Connecting NotebookLM to Antigravity through the NotebookLM MCP Server enables seamless access to your notebooks, notes, and sources directly from your AI workflows. With proper authentication and configuration, you can query NotebookLM content without leaving Antigravity, making research and knowledge management significantly more efficient.