notebooklm-mcp-server 1.1.6 → 1.1.8

package/README.md

@@ -54,6 +54,9 @@ npm install -g notebooklm-mcp-server
 npx playwright install chromium
 ```
 
+> [!NOTE]
+> **Auto-update**: The server automatically checks for new versions at startup. If an update exists, it will install itself and ask you to restart to ensure you always have the latest Google fixes.
+
 ### 2. Direct usage with NPX (Zero-Config)
 
 If you don't want to install it globally, you can run it directly:
@@ -76,6 +79,9 @@ Before using the server, you must link it to your Google Account. This version u
 2. A browser window will open. Log in with your Google account.
 3. Close the browser once you see your notebooks. Your session is now securely saved locally.
 
+> [!TIP]
+> **Session Expired?** If your agent receives authentication errors, simply ask it to run the command `npx notebooklm-mcp-server refresh_auth`. It will automatically open the browser for you to renew the session without leaving your chat.
+
 ---
 
 ## ⚡ Quick Start
@@ -170,17 +176,45 @@ claude skill add notebooklm -- "npx -y notebooklm-mcp-server start"
 
 ## 📖 Documentation
 
-| Tool                      | Description                                           |
-| :------------------------ | :---------------------------------------------------- |
-| `list_notebooks`          | Lists all notebooks available in your account.        |
-| `create_notebook`         | Creates a new notebook with an optional title.        |
-| `get_notebook`            | Retrieves the details and sources of a notebook.      |
-| `query_notebook`          | Asks a grounded question to a specific notebook.      |
-| `add_source_url`          | Adds a website or YouTube video as a source.          |
-| `add_source_text`         | Adds pasted text content as a source.                 |
-| `generate_audio_overview` | Triggers the generation of an Audio Overview podcast. |
-| `rename_notebook`         | Renames an existing notebook.                         |
-| `delete_notebook`         | Deletes a notebook (Warning: Destructive).            |
+The following tools are available through this MCP server:
+
+### 📒 Notebook Management
+| Tool               | Description                                           |
+| :----------------- | :---------------------------------------------------- |
+| `notebook_list`    | Lists all notebooks in your account.                  |
+| `notebook_create`  | Creates a new notebook with a title.                  |
+| `notebook_rename`  | Renames an existing notebook.                         |
+| `notebook_delete`  | Deletes a notebook (Warning: Destructive).            |
+
+### 🖇️ Source Management
+| Tool                     | Description                                            |
+| :----------------------- | :----------------------------------------------------- |
+| `notebook_add_url`        | Adds a website or YouTube video as a source.           |
+| `notebook_add_text`       | Adds custom text content as a source.                  |
+| `notebook_add_local_file` | Uploads a local PDF, Markdown or Text file.            |
+| `notebook_add_drive`      | Adds a file from Google Drive (Docs, Slides, etc).     |
+| `source_delete`           | Removes a source from a notebook.                      |
+| `source_sync`             | Syncs a Drive source to get the latest version.        |
+
+### 🔍 Research & Query
+| Tool               | Description                                           |
+| :----------------- | :---------------------------------------------------- |
+| `notebook_query`   | Asks a grounded question to a specific notebook.      |
+| `research_start`   | Starts a web/drive research task.                     |
+| `research_poll`    | Polls for research status and results.                |
+| `research_import`  | Imports research results as permanent sources.        |
+
+### 🎨 Studio & Generation
+| Tool                    | Description                                           |
+| :---------------------- | :---------------------------------------------------- |
+| `audio_overview_create` | Generates an Audio Overview (podcast).                |
+| `studio_poll`           | Checks status of generated audio/video artifacts.     |
+| `mind_map_generate`     | Generates a Mind Map JSON from sources.               |
+
+### ⚙️ System
+| Tool           | Description                                                        |
+| :------------- | :----------------------------------------------------------------- |
+| `refresh_auth` | **Interactive**: Opens a browser to renew your Google session. Use this if tools start failing. |
 
 ---
 

package/dist/auth-cli.js

@@ -1,23 +1,22 @@
 #!/usr/bin/env node
 import { AuthManager } from './auth.js';
 import chalk from 'chalk';
-import ora from 'ora';
 export async function runAuthCli() {
     const auth = new AuthManager();
-    console.log('\n' + chalk.cyan.bold('╔═══════════════════════════════════════════╗'));
-    console.log(chalk.cyan.bold('║      NotebookLM MCP Authentication        ║'));
-    console.log(chalk.cyan.bold('╚═══════════════════════════════════════════╝\n'));
-    const spinner = ora('Initializing browser...').start();
+    // Use stderr for ALL logs to avoid breaking MCP stdout
+    console.error('\n' + chalk.cyan.bold('╔═══════════════════════════════════════════╗'));
+    console.error(chalk.cyan.bold('║      NotebookLM MCP Authentication        ║'));
+    console.error(chalk.cyan.bold('╚═══════════════════════════════════════════╝\n'));
     try {
         await auth.runAuthentication((status) => {
-            spinner.text = status;
+            console.error(chalk.blue(`[Status] ${status}`));
         });
-        spinner.succeed(chalk.green.bold('Authentication successful!'));
-        console.log('\n' + chalk.white('Your session is now active. You can use the server with your favorite MCP client.'));
+        console.error('\n' + chalk.green.bold('Authentication successful!'));
+        console.error(chalk.white('Your session is now active. You can close any leftovers and return to your chat.'));
     }
     catch (error) {
-        spinner.fail(chalk.red.bold('Authentication failed'));
-        console.error('\n' + chalk.red('Error: ') + error.message);
+        console.error('\n' + chalk.red.bold('Authentication failed'));
+        console.error(chalk.red('Error: ') + error.message);
         process.exit(1);
     }
 }

package/dist/auth.js

@@ -89,7 +89,7 @@ export class AuthManager {
             fs.mkdirSync(path.dirname(this.authPath), { recursive: true });
         }
         fs.writeFileSync(this.authPath, JSON.stringify(authData, null, 2));
-        console.log(`Authentication successful! Cookies saved to ${this.authPath}`);
+        console.error(`Authentication successful! Cookies saved to ${this.authPath}`);
         await browser.close();
     }
     getSavedCookies() {

package/dist/client.d.ts

@@ -12,7 +12,7 @@ export declare class NotebookLMClient {
     private sessionId;
     constructor(cookies: string);
     /**
-     * Internal RPC executor with correct batchexecute envelope format.
+     * Internal RPC executor with the original, working legacy format.
      */
     private callRpc;
     /**

package/dist/client.js

@@ -27,11 +27,11 @@ export class NotebookLMClient {
         });
     }
     /**
-     * Internal RPC executor with correct batchexecute envelope format.
+     * Internal RPC executor with the original, working legacy format.
      */
     async callRpc(rpcId, params, _retryCount = 0) {
-        // Current Google batchexecute envelope format
-        const fReq = JSON.stringify([[[rpcId, JSON.stringify(params), null, "1"]]]);
+        // Reverting to the simpler format that proved stable in v1.1.2
+        const fReq = JSON.stringify([null, JSON.stringify(params)]);
         const body = new URLSearchParams();
         body.append('f.req', fReq);
         if (this.csrfToken) {

package/dist/index.js

@@ -5,7 +5,7 @@ const program = new Command();
 program
     .name('notebooklm-mcp-server')
     .description('NotebookLM MCP Server (Node.js)')
-    .version('1.1.6');
+    .version('1.1.8');
 program
     .command('server')
     .description('Start the MCP server (default)')

package/dist/server.js

@@ -6,7 +6,7 @@ import { AuthManager } from "./auth.js";
 import chalk from "chalk";
 const server = new Server({
     name: "notebooklm-mcp-server",
-    version: "1.1.6",
+    version: "1.1.8",
 }, {
     capabilities: {
         tools: {},
@@ -277,19 +277,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "notebook_list":
                 const notebooks = await client.listNotebooks();
                 if (!notebooks || notebooks.length === 0) {
-                    return { content: [{ type: "text", text: "No se encontraron cuadernos. Si crees que esto es un error, intenta ejecutar 'refresh_auth' para renovar la sesión." }] };
+                    return { content: [{ type: "text", text: "No notebooks found. Please verify your session with 'notebooklm-mcp-auth'." }] };
                 }
                 const listText = notebooks.map(n => `- ${n.title} (ID: ${n.id})`).join('\n');
-                return { content: [{ type: "text", text: `Has encontrado ${notebooks.length} cuadernos:\n\n${listText}` }] };
+                return { content: [{ type: "text", text: `I found ${notebooks.length} notebooks in your account:\n\n${listText}` }] };
             case "notebook_create":
                 const newId = await client.createNotebook(args?.title);
-                return { content: [{ type: "text", text: `Cuaderno creado exitosamente con ID: ${newId}` }] };
+                return { content: [{ type: "text", text: `Successfully created notebook: ${args?.title} (ID: ${newId})` }] };
             case "notebook_delete":
                 await client.deleteNotebook(args?.notebook_id);
-                return { content: [{ type: "text", text: `Cuaderno eliminado exitosamente.` }] };
+                return { content: [{ type: "text", text: `Notebook deleted.` }] };
             case "notebook_rename":
                 await client.renameNotebook(args?.notebook_id, args?.title);
-                return { content: [{ type: "text", text: `Cuaderno renombrado correctamente a: ${args?.title}` }] };
+                return { content: [{ type: "text", text: `Notebook renamed to: ${args?.title}` }] };
             case "notebook_add_url":
                 const sourceIdUrl = await client.addUrlSource(args?.notebook_id, args?.url);
                 return { content: [{ type: "text", text: JSON.stringify({ status: "success", source_id: sourceIdUrl }) }] };
@@ -356,7 +356,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     catch (error) {
         console.error(chalk.red(`Tool execution error [${name}]:`), error);
         return {
-            content: [{ type: "text", text: `Error de ejecución: ${error.message || String(error)}` }],
+            content: [{ type: "text", text: `Error: ${error.message || String(error)}` }],
             isError: true,
         };
     }
@@ -364,7 +364,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("NotebookLM MCP Server v1.1.6 running on stdio");
+    console.error("NotebookLM MCP Server v1.1.8 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notebooklm-mcp-server",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Node.js Model Context Protocol server for Google NotebookLM",
   "type": "module",
   "repository": {