Skip to content

Commit a66a33d

Browse files
committed
docs: rebrand Google NotebookLM to Gemini Notebook
1 parent ed21a32 commit a66a33d

28 files changed

Lines changed: 188 additions & 188 deletions

AGENTS.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
44

55
## Project Overview
66

7-
**NotebookLM MCP Server & CLI** - Provides programmatic access to NotebookLM (notebooklm.google.com) via both a Model Context Protocol server and a comprehensive command-line interface.
7+
**Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI** - Provides programmatic access to Gemini Notebook (notebook.google.com) via both a Model Context Protocol server and a comprehensive command-line interface.
88

99
Tested with personal/free tier accounts. May work with Google Workspace accounts but has not been tested.
1010

@@ -46,7 +46,7 @@ Extract CSRF token and session ID directly from network request - **no page fetc
4646

4747
```python
4848
# 1. Navigate to NotebookLM page
49-
navigate_page(url="https://notebooklm.google.com/")
49+
navigate_page(url="https://notebook.google.com/")
5050

5151
# 2. Get a batchexecute request (any NotebookLM API call)
5252
get_network_request(reqid=<any_batchexecute_request>)
@@ -185,7 +185,7 @@ src/notebooklm_tools/
185185

186186
## Features NOT Yet Implemented
187187

188-
None - all NotebookLM features that can be accessed programmatically are implemented.
188+
None - all Gemini Notebook features that can be accessed programmatically are implemented.
189189

190190
## Troubleshooting
191191

CHANGELOG.md

Lines changed: 42 additions & 42 deletions
Large diffs are not rendered by default.

CLAUDE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
**NotebookLM MCP Server & CLI** - Provides programmatic access to NotebookLM (notebooklm.google.com) via both a Model Context Protocol server and a comprehensive command-line interface.
7+
**Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI** - Provides programmatic access to Gemini Notebook (notebook.google.com) via both a Model Context Protocol server and a comprehensive command-line interface.
88

99
Tested with personal/free tier accounts. May work with Google Workspace accounts but has not been tested.
1010

@@ -49,7 +49,7 @@ Extract CSRF token and session ID directly from network request - **no page fetc
4949

5050
```python
5151
# 1. Navigate to NotebookLM page
52-
navigate_page(url="https://notebooklm.google.com/")
52+
navigate_page(url="https://notebook.google.com/")
5353

5454
# 2. Get a batchexecute request (any NotebookLM API call)
5555
get_network_request(reqid=<any_batchexecute_request>)
@@ -82,7 +82,7 @@ save_auth_tokens(cookies=<cookie_header>)
8282

8383
### Resilience: rotated RPC IDs
8484

85-
NotebookLM's internal API uses short RPC "method IDs" (e.g. `wXbhsf`) that Google rotates without notice. When one rotates, calls using the old ID fail. The client now:
85+
Gemini Notebook's internal API uses short RPC "method IDs" (e.g. `wXbhsf`) that Google rotates without notice. When one rotates, calls using the old ID fail. The client now:
8686

8787
- **Detects drift loudly**: raises `RPCDriftError` (instead of returning silently) when the server responds with **other** `wrb.fr` RPC IDs than the one requested. An empty response still returns silently (no comparison points), so use `--debug` to inspect in that case.
8888
- **Discovers the new ID**: run with `--debug` to log `RPC IDs in response: [...]` — the new ID for your call appears there.
@@ -200,7 +200,7 @@ src/notebooklm_tools/
200200

201201
## Features NOT Yet Implemented
202202

203-
None - all NotebookLM features that can be accessed programmatically are implemented.
203+
None - all Gemini Notebook features that can be accessed programmatically are implemented.
204204

205205
## Troubleshooting
206206

CONTRIBUTING.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Contributing to NotebookLM MCP Server & CLI
1+
# Contributing to Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI
22

3-
Thanks for your interest in contributing. This project gives you programmatic access to NotebookLM through an MCP server and CLI, built on top of Google's undocumented internal `batchexecute` API. The API can change without notice, so contributions need to be grounded in captured, verified payloads, not assumptions.
3+
Thanks for your interest in contributing. This project gives you programmatic access to Gemini Notebook through an MCP server and CLI, built on top of Google's undocumented internal `batchexecute` API. The API can change without notice, so contributions need to be grounded in captured, verified payloads, not assumptions.
44

55
## Before You Start
66

@@ -58,7 +58,7 @@ This project wraps an undocumented API. The only reliable way to implement new f
5858
### 1. Capture the API Call
5959

6060
1. Open Chrome DevTools, go to the **Network** tab
61-
2. Navigate to [notebooklm.google.com](https://notebooklm.google.com) and open a notebook
61+
2. Navigate to [notebook.google.com](https://notebook.google.com) and open a notebook
6262
3. Perform the action you want to implement in the web UI
6363
4. Filter for `batchexecute` requests
6464
5. Copy the `f.req` form parameter (request payload) and the response body
@@ -176,7 +176,7 @@ To report a security vulnerability, please email the maintainer directly. Don't
176176

177177
- **One feature or fix per PR.** Keeps reviews manageable.
178178
- **Include a clear description.** What changed, why, and how you verified it.
179-
- **Show live API verification.** Mention that you tested against the actual NotebookLM API, not just mocks.
179+
- **Show live API verification.** Mention that you tested against the actual Gemini Notebook API, not just mocks.
180180
- **Don't bump the version.** The maintainer handles versioning and releases.
181181
- **Don't add `Co-authored-by` trailers.** Commits are attributed to the PR author.
182182

GEMINI.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
## Project Overview
44

5-
**NotebookLM MCP Server & CLI**
5+
**Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI**
66

7-
This project implements a Model Context Protocol (MCP) server **and a full-featured Command Line Interface (CLI)** that provides programmatic access to [NotebookLM](https://notebooklm.google.com). It allows AI agents, developers, and power users to interact with NotebookLM notebooks, sources, query capabilities, and **download generated artifacts** (Audio, Video, PDF, etc.).
7+
This project implements a Model Context Protocol (MCP) server **and a full-featured Command Line Interface (CLI)** that provides programmatic access to [Gemini Notebook](https://notebook.google.com). It allows AI agents, developers, and power users to interact with Gemini Notebook notebooks, sources, query capabilities, and **download generated artifacts** (Audio, Video, PDF, etc.).
88

99
Tested with personal/free tier accounts. May work with Google Workspace accounts but has not been tested. This project relies on internal APIs (`batchexecute` RPCs).
1010

@@ -55,7 +55,7 @@ refresh_auth() # Reload tokens from disk or run headless auth
5555

5656
**Fallback: Manual extraction (if CLI fails)**
5757
If the automated tool doesn't work, extract cookies via Chrome DevTools:
58-
1. Open Chrome DevTools on notebooklm.google.com
58+
1. Open Chrome DevTools on notebook.google.com
5959
2. Go to Network tab, find a batchexecute request
6060
3. Copy the Cookie header and call `save_auth_tokens(cookies=...)`
6161

README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
1-
# NotebookLM CLI & MCP Server
1+
# Gemini Notebook (formerly Google NotebookLM) CLI & MCP Server
22

3-
![NotebookLM MCP Header](docs/media/header.jpg)
3+
![Gemini Notebook MCP Header](docs/media/header.jpg)
44

55
[![PyPI version](https://img.shields.io/pypi/v/notebooklm-mcp-cli)](https://pypi.org/project/notebooklm-mcp-cli/)
66
[![PyPI downloads](https://img.shields.io/pypi/dm/notebooklm-mcp-cli)](https://pypistats.org/packages/notebooklm-mcp-cli)
77
[![Total downloads](https://static.pepy.tech/badge/notebooklm-mcp-cli)](https://pepy.tech/projects/notebooklm-mcp-cli)
88
[![Python](https://img.shields.io/pypi/pyversions/notebooklm-mcp-cli)](https://pypi.org/project/notebooklm-mcp-cli/)
99
[![License](https://img.shields.io/pypi/l/notebooklm-mcp-cli)](https://github.com/jacob-bd/notebooklm-mcp-cli/blob/main/LICENSE)
1010

11-
**Programmatic access to Google NotebookLM** — via command-line interface (CLI) or Model Context Protocol (MCP) server.
11+
**Programmatic access to Gemini Notebook** — via command-line interface (CLI) or Model Context Protocol (MCP) server.
1212

13-
> **Note:** Tested with Pro/free and Google AI Ultra ($249/mo) tier accounts. May work with NotebookLM Enterprise accounts but has not been tested.
13+
> **Note:** Tested with Pro/free and Google AI Ultra ($249/mo) tier accounts. May work with Gemini Notebook Enterprise accounts but has not been tested.
1414
1515
> **If you find notebooklm-mcp-cli useful, consider [buying me a coffee](https://buymeacoffee.com/jacobbd).**
16-
> It's free and built in my spare time — but testing every NotebookLM feature takes real time and resources. A coffee helps me cover it and keep shipping. Thank you! 🙏
16+
> It's free and built in my spare time — but testing every Gemini Notebook feature takes real time and resources. A coffee helps me cover it and keep shipping. Thank you! 🙏
1717
>
1818
> <a href="https://buymeacoffee.com/jacobbd"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="42"></a>
1919
@@ -58,7 +58,7 @@ Run `nlm --ai` for comprehensive AI-assistant documentation.
5858

5959
### 🤖 MCP Server (for AI Agents)
6060

61-
Connect AI assistants (Claude, Gemini, Cursor, etc.) to NotebookLM:
61+
Connect AI assistants (Claude, Gemini, Cursor, etc.) to Gemini Notebook:
6262

6363
```bash
6464
# Automatic setup — picks the right config for each tool
@@ -100,7 +100,7 @@ Then use natural language: *"Create a notebook about quantum computing and gener
100100
| Diagnose issues | `nlm doctor` ||
101101

102102
📚 **More Documentation:**
103-
- **[Getting Started](docs/GETTING_STARTED.md)** — Install, login, agent setup, and migration from another NotebookLM MCP
103+
- **[Getting Started](docs/GETTING_STARTED.md)** — Install, login, agent setup, and migration from another Gemini Notebook MCP
104104
- **[CLI Guide](docs/CLI_GUIDE.md)** — Complete command reference
105105
- **[MCP Guide](docs/MCP_GUIDE.md)** — All 43 MCP tools with examples
106106
- **[Authentication](docs/AUTHENTICATION.md)** — Setup and troubleshooting
@@ -240,10 +240,10 @@ nlm login
240240
## Getting Started
241241

242242
If you are setting up the tool for the first time — or migrating from a
243-
browser-based NotebookLM MCP — see the
243+
browser-based Gemini Notebook MCP — see the
244244
[Getting Started Guide](docs/GETTING_STARTED.md). It covers install,
245245
login, agent registration, and a step-by-step migration path that avoids
246-
the "two NotebookLM servers registered" trap.
246+
the "two Gemini Notebook servers registered" trap.
247247

248248
## Uninstalling
249249

@@ -273,7 +273,7 @@ nlm setup remove cursor
273273

274274
## Authentication
275275

276-
Before using the CLI or MCP, you need to authenticate with NotebookLM:
276+
Before using the CLI or MCP, you need to authenticate with Gemini Notebook:
277277

278278
### CLI Authentication (Recommended)
279279

@@ -323,7 +323,7 @@ For detailed instructions and troubleshooting, see **[docs/AUTHENTICATION.md](do
323323

324324
## MCP Configuration
325325

326-
> **⚠️ Context Window Warning:** This MCP provides **43 tools**. Disable it when not using NotebookLM to preserve context. In Claude Code: `@notebooklm-mcp` to toggle. To keep it on but expose only a subset, see [Selective tool exposure](docs/MCP_GUIDE.md#selective-tool-exposure).
326+
> **⚠️ Context Window Warning:** This MCP provides **43 tools**. Disable it when not using Gemini Notebook to preserve context. In Claude Code: `@notebooklm-mcp` to toggle. To keep it on but expose only a subset, see [Selective tool exposure](docs/MCP_GUIDE.md#selective-tool-exposure).
327327
328328
### Automatic Setup (Recommended)
329329

@@ -350,7 +350,7 @@ nlm doctor
350350

351351
### Install AI Skills (Optional)
352352

353-
Install the NotebookLM expert guide for your AI assistant to help it use the tools effectively. Supported for **Cline**, **Antigravity**, **OpenClaw**, **Codex**, **OpenCode**, **Claude Code**, and **Gemini CLI**.
353+
Install the Gemini Notebook expert guide for your AI assistant to help it use the tools effectively. Supported for **Cline**, **Antigravity**, **OpenClaw**, **Codex**, **OpenCode**, **Claude Code**, and **Gemini CLI**.
354354

355355
```bash
356356
# Install skill files
@@ -458,7 +458,7 @@ Simply chat with your AI tool (Claude Code, Cursor, Gemini CLI) using natural la
458458

459459
### Research & Discovery
460460

461-
- "List all my NotebookLM notebooks"
461+
- "List all my Gemini Notebook notebooks"
462462
- "Create a new notebook called 'AI Strategy Research'"
463463
- "Start web research on 'enterprise AI ROI metrics' and show me what sources it finds"
464464
- "Do a deep research on 'cloud marketplace trends' and import the top 10 sources"
@@ -479,7 +479,7 @@ Simply chat with your AI tool (Claude Code, Cursor, Gemini CLI) using natural la
479479
- "Get an AI summary of what this notebook is about"
480480
- "Configure the chat to use a learning guide style with longer responses"
481481

482-
*(All queries sent from CLI or MCP automatically persist in your NotebookLM web UI chat history!)*
482+
*(All queries sent from CLI or MCP automatically persist in your Gemini Notebook web UI chat history!)*
483483

484484
### Content Generation
485485

@@ -570,7 +570,7 @@ See [CLAUDE.md](CLAUDE.md) for detailed API documentation and how to add new fea
570570

571571
Full transparency: this project was built by a non-developer using AI coding assistants. If you're an experienced Python developer, you might look at this codebase and wince. That's okay.
572572

573-
The goal here was to scratch an itch - programmatic access to NotebookLM - and learn along the way. The code works, but it's likely missing patterns, optimizations, or elegance that only years of experience can provide.
573+
The goal here was to scratch an itch - programmatic access to Gemini Notebook - and learn along the way. The code works, but it's likely missing patterns, optimizations, or elegance that only years of experience can provide.
574574

575575
**This is where you come in.** If you see something that makes you cringe, please consider contributing rather than just closing the tab. This is open source specifically because human expertise is irreplaceable. Whether it's refactoring, better error handling, type hints, or architectural guidance - PRs and issues are welcome.
576576

@@ -589,7 +589,7 @@ Special thanks to:
589589
- **Fabiana Furtado** ([@fabianafurtadoff](https://github.com/fabianafurtadoff)) for batch operations, cross-notebook query, pipelines, and smart select/tagging (PR #90).
590590
- **Amy-Ra-lph** ([@Amy-Ra-lph](https://github.com/Amy-Ra-lph)) for security hardening: TOCTOU-safe credential storage, sensitive cookie redaction from debug logs, and pinning all CI actions to full commit SHAs (PRs #205–207).
591591
- **Kyle Brodeur** ([@kylebrodeur](https://github.com/kylebrodeur)) for WSL2 authentication support with Windows Chrome integration (PR #138).
592-
- **Robiton** ([@Robiton](https://github.com/Robiton)) for enterprise NotebookLM support via configurable base URL (PR #114).
592+
- **Robiton** ([@Robiton](https://github.com/Robiton)) for enterprise Gemini Notebook support via configurable base URL (PR #114).
593593
- **pjeby** ([@pjeby](https://github.com/pjeby)) for connection pooling and fast startup improvements (PR #54).
594594
- **beausea** ([@beausea](https://github.com/beausea)) for making the interface language configurable via the `NOTEBOOKLM_HL` environment variable (PR #59).
595595
- **JumpLao** ([@JumpLao](https://github.com/JumpLao)) for extended audio, video, and image format support (PR #82).

docs/API_REFERENCE.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# NotebookLM MCP API Reference
1+
# Gemini Notebook (formerly Google NotebookLM) MCP API Reference
22

3-
This document contains detailed API documentation for the internal NotebookLM APIs. Only read this file when debugging API issues or adding new features.
3+
This document contains detailed API documentation for the internal Gemini Notebook APIs. Only read this file when debugging API issues or adding new features.
44

55
**For general project info, see [CLAUDE.md](../CLAUDE.md)**
66

@@ -231,7 +231,7 @@ prompt rather than an undocumented payload change.
231231
## Base Endpoint
232232

233233
```
234-
POST https://notebooklm.google.com/_/LabsTailwindUi/data/batchexecute
234+
POST https://notebook.google.com/_/LabsTailwindUi/data/batchexecute
235235
```
236236

237237
## Request Format
@@ -518,7 +518,7 @@ not yet used (no pagination).
518518

519519
## Research RPCs (Source Discovery)
520520

521-
NotebookLM's "Research" feature discovers and suggests sources based on a query. It supports two source types (Web and Google Drive) and two research modes (Fast and Deep).
521+
Gemini Notebook's "Research" feature discovers and suggests sources based on a query. It supports two source types (Web and Google Drive) and two research modes (Fast and Deep).
522522

523523
### Source Types
524524
| Type | Value | Description |
@@ -659,7 +659,7 @@ Imports selected sources from research results into the notebook.
659659

660660
## Studio RPCs (Audio/Video Overviews)
661661

662-
NotebookLM's "Studio" feature generates audio podcasts and video overviews from notebook sources.
662+
Gemini Notebook's "Studio" feature generates audio podcasts and video overviews from notebook sources.
663663

664664
### `R7cb6c` - Create Studio Content
665665

@@ -857,7 +857,7 @@ Returns the same structure as `R7cb6c` (Create Studio Content):
857857
| **Lengths** | 1=Short, 2=Default, 3=Long |
858858
| **Languages** | BCP-47 codes, including regional values such as `"es-ES"`, `"es-US"`, and `"es-419"` |
859859

860-
For Audio Overviews, NotebookLM has been observed using the region subtag to
860+
For Audio Overviews, Gemini Notebook has been observed using the region subtag to
861861
select the voice accent. `es` and `es-ES` produce Spain Spanish, while `es-US`
862862
and `es-419` produce Latin-American Spanish. Prompt text does not reliably
863863
override the accent. This is observed behavior and may change upstream.
@@ -1032,7 +1032,7 @@ Returns an AI-generated summary of the notebook and suggested report topics.
10321032

10331033
### `tr032e` - Get Source Guide
10341034

1035-
Generates an AI summary and keyword chips for a specific source. This is the "Source Guide" feature shown when clicking on a source in the NotebookLM UI.
1035+
Generates an AI summary and keyword chips for a specific source. This is the "Source Guide" feature shown when clicking on a source in the Gemini Notebook UI.
10361036

10371037
```python
10381038
# Request params
@@ -1484,7 +1484,7 @@ null # Null on success
14841484
## Drive Source Sync
14851485

14861486
### Problem
1487-
NotebookLM doesn't auto-update Google Drive sources when the underlying document changes. Users must manually click each source > "Check freshness" > "Click to sync with Google Drive".
1487+
Gemini Notebook doesn't auto-update Google Drive sources when the underlying document changes. Users must manually click each source > "Check freshness" > "Click to sync with Google Drive".
14881488

14891489
### Solution
14901490
The `source_list_drive` and `source_sync_drive` tools automate this process.
@@ -1581,7 +1581,7 @@ The MCP needs these cookies (automatically filtered from the full cookie header)
15811581
- Saves to cache for reuse
15821582

15831583
2. **From page fetch (slower first time):**
1584-
- Client fetches `notebooklm.google.com` using cookies
1584+
- Client fetches `notebook.google.com` using cookies
15851585
- Extracts `SNlM0e` (CSRF) and `FdrFJe` (session ID) from HTML
15861586
- Saves to cache for reuse
15871587
- ~1-2 seconds one-time delay
@@ -1778,7 +1778,7 @@ GyzE7e([[2], notebook_id, [label_id_to_remove]])
17781778

17791779
### `ozz5Z` — Get User Subscription Tier
17801780

1781-
Returns the user's current NotebookLM subscription tier. Fires on the homepage (`source-path=/`) during page load.
1781+
Returns the user's current Gemini Notebook subscription tier. Fires on the homepage (`source-path=/`) during page load.
17821782

17831783
**Captured request params (2026-04-27, `source-path=/`):**
17841784
```python

0 commit comments

Comments
 (0)