You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
4
4
5
5
## Project Overview
6
6
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.
8
8
9
9
Tested with personal/free tier accounts. May work with Google Workspace accounts but has not been tested.
10
10
@@ -46,7 +46,7 @@ Extract CSRF token and session ID directly from network request - **no page fetc
Copy file name to clipboardExpand all lines: CLAUDE.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
5
5
## Project Overview
6
6
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.
8
8
9
9
Tested with personal/free tier accounts. May work with Google Workspace accounts but has not been tested.
10
10
@@ -49,7 +49,7 @@ Extract CSRF token and session ID directly from network request - **no page fetc
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:
86
86
87
87
-**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.
88
88
-**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/
200
200
201
201
## Features NOT Yet Implemented
202
202
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.
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Contributing to NotebookLM MCP Server & CLI
1
+
# Contributing to Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI
2
2
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.
4
4
5
5
## Before You Start
6
6
@@ -58,7 +58,7 @@ This project wraps an undocumented API. The only reliable way to implement new f
58
58
### 1. Capture the API Call
59
59
60
60
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
62
62
3. Perform the action you want to implement in the web UI
63
63
4. Filter for `batchexecute` requests
64
64
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
176
176
177
177
-**One feature or fix per PR.** Keeps reviews manageable.
178
178
-**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.
180
180
-**Don't bump the version.** The maintainer handles versioning and releases.
181
181
-**Don't add `Co-authored-by` trailers.** Commits are attributed to the PR author.
Copy file name to clipboardExpand all lines: GEMINI.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,9 @@
2
2
3
3
## Project Overview
4
4
5
-
**NotebookLM MCP Server & CLI**
5
+
**Gemini Notebook (formerly Google NotebookLM) MCP Server & CLI**
6
6
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.).
8
8
9
9
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).
10
10
@@ -55,7 +55,7 @@ refresh_auth() # Reload tokens from disk or run headless auth
55
55
56
56
**Fallback: Manual extraction (if CLI fails)**
57
57
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
59
59
2. Go to Network tab, find a batchexecute request
60
60
3. Copy the Cookie header and call `save_auth_tokens(cookies=...)`
**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.
12
12
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.
14
14
15
15
> ☕ **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! 🙏
17
17
>
18
18
> <ahref="https://buymeacoffee.com/jacobbd"><imgsrc="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png"alt="Buy Me A Coffee"height="42"></a>
19
19
@@ -58,7 +58,7 @@ Run `nlm --ai` for comprehensive AI-assistant documentation.
58
58
59
59
### 🤖 MCP Server (for AI Agents)
60
60
61
-
Connect AI assistants (Claude, Gemini, Cursor, etc.) to NotebookLM:
61
+
Connect AI assistants (Claude, Gemini, Cursor, etc.) to Gemini Notebook:
62
62
63
63
```bash
64
64
# 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
100
100
| Diagnose issues |`nlm doctor`| — |
101
101
102
102
📚 **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
-**[MCP Guide](docs/MCP_GUIDE.md)** — All 43 MCP tools with examples
106
106
-**[Authentication](docs/AUTHENTICATION.md)** — Setup and troubleshooting
@@ -240,10 +240,10 @@ nlm login
240
240
## Getting Started
241
241
242
242
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
244
244
[Getting Started Guide](docs/GETTING_STARTED.md). It covers install,
245
245
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.
247
247
248
248
## Uninstalling
249
249
@@ -273,7 +273,7 @@ nlm setup remove cursor
273
273
274
274
## Authentication
275
275
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:
277
277
278
278
### CLI Authentication (Recommended)
279
279
@@ -323,7 +323,7 @@ For detailed instructions and troubleshooting, see **[docs/AUTHENTICATION.md](do
323
323
324
324
## MCP Configuration
325
325
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).
327
327
328
328
### Automatic Setup (Recommended)
329
329
@@ -350,7 +350,7 @@ nlm doctor
350
350
351
351
### Install AI Skills (Optional)
352
352
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**.
354
354
355
355
```bash
356
356
# Install skill files
@@ -458,7 +458,7 @@ Simply chat with your AI tool (Claude Code, Cursor, Gemini CLI) using natural la
458
458
459
459
### Research & Discovery
460
460
461
-
- "List all my NotebookLM notebooks"
461
+
- "List all my Gemini Notebook notebooks"
462
462
- "Create a new notebook called 'AI Strategy Research'"
463
463
- "Start web research on 'enterprise AI ROI metrics' and show me what sources it finds"
464
464
- "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
479
479
- "Get an AI summary of what this notebook is about"
480
480
- "Configure the chat to use a learning guide style with longer responses"
481
481
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!)*
483
483
484
484
### Content Generation
485
485
@@ -570,7 +570,7 @@ See [CLAUDE.md](CLAUDE.md) for detailed API documentation and how to add new fea
570
570
571
571
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.
572
572
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.
574
574
575
575
**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.
576
576
@@ -589,7 +589,7 @@ Special thanks to:
589
589
-**Fabiana Furtado** ([@fabianafurtadoff](https://github.com/fabianafurtadoff)) for batch operations, cross-notebook query, pipelines, and smart select/tagging (PR #90).
590
590
-**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).
591
591
-**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).
593
593
-**pjeby** ([@pjeby](https://github.com/pjeby)) for connection pooling and fast startup improvements (PR #54).
594
594
-**beausea** ([@beausea](https://github.com/beausea)) for making the interface language configurable via the `NOTEBOOKLM_HL` environment variable (PR #59).
595
595
-**JumpLao** ([@JumpLao](https://github.com/JumpLao)) for extended audio, video, and image format support (PR #82).
Copy file name to clipboardExpand all lines: docs/API_REFERENCE.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# NotebookLM MCP API Reference
1
+
# Gemini Notebook (formerly Google NotebookLM) MCP API Reference
2
2
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.
4
4
5
5
**For general project info, see [CLAUDE.md](../CLAUDE.md)**
6
6
@@ -231,7 +231,7 @@ prompt rather than an undocumented payload change.
231
231
## Base Endpoint
232
232
233
233
```
234
-
POST https://notebooklm.google.com/_/LabsTailwindUi/data/batchexecute
234
+
POST https://notebook.google.com/_/LabsTailwindUi/data/batchexecute
235
235
```
236
236
237
237
## Request Format
@@ -518,7 +518,7 @@ not yet used (no pagination).
518
518
519
519
## Research RPCs (Source Discovery)
520
520
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).
522
522
523
523
### Source Types
524
524
| Type | Value | Description |
@@ -659,7 +659,7 @@ Imports selected sources from research results into the notebook.
659
659
660
660
## Studio RPCs (Audio/Video Overviews)
661
661
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.
663
663
664
664
### `R7cb6c` - Create Studio Content
665
665
@@ -857,7 +857,7 @@ Returns the same structure as `R7cb6c` (Create Studio Content):
857
857
|**Lengths**| 1=Short, 2=Default, 3=Long |
858
858
|**Languages**| BCP-47 codes, including regional values such as `"es-ES"`, `"es-US"`, and `"es-419"`|
859
859
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
861
861
select the voice accent. `es` and `es-ES` produce Spain Spanish, while `es-US`
862
862
and `es-419` produce Latin-American Spanish. Prompt text does not reliably
863
863
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.
1032
1032
1033
1033
### `tr032e` - Get Source Guide
1034
1034
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.
1036
1036
1037
1037
```python
1038
1038
# Request params
@@ -1484,7 +1484,7 @@ null # Null on success
1484
1484
## Drive Source Sync
1485
1485
1486
1486
### 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".
1488
1488
1489
1489
### Solution
1490
1490
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)
1581
1581
- Saves to cache for reuse
1582
1582
1583
1583
2.**From page fetch (slower first time):**
1584
-
- Client fetches `notebooklm.google.com` using cookies
1584
+
- Client fetches `notebook.google.com` using cookies
1585
1585
- Extracts `SNlM0e` (CSRF) and `FdrFJe` (session ID) from HTML
0 commit comments