notebooklm-mcp-server 1.1.6 → 1.1.7

package/README.md

@@ -54,6 +54,9 @@ npm install -g notebooklm-mcp-server
 npx playwright install chromium
 ```
 
+> [!NOTE]
+> **Auto-punto-actualización**: El servidor comprueba automáticamente si hay nuevas versiones al arrancar. Si existe una actualización, se instalará sola y te pedirá reiniciar para asegurar que siempre tengas las últimas correcciones de Google.
+
 ### 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]
+> **Sesión Expirada?** Si tu agente recibe errores de autenticación, simplemente pídele que ejecute la herramienta `refresh_auth`. Abrirá el navegador automáticamente para que renueves la sesión sin salir de tu 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.js

@@ -30,8 +30,8 @@ export class NotebookLMClient {
      * Internal RPC executor with correct batchexecute envelope format.
      */
     async callRpc(rpcId, params, _retryCount = 0) {
-        // Current Google batchexecute envelope format
-        const fReq = JSON.stringify([[[rpcId, JSON.stringify(params), null, "1"]]]);
+        // Use the 'generic' identifier which is more robust across Google services
+        const fReq = JSON.stringify([[[rpcId, JSON.stringify(params), null, "generic"]]]);
         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.7');
 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.7",
 }, {
     capabilities: {
         tools: {},
@@ -276,20 +276,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         switch (name) {
             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." }] };
-                }
-                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: JSON.stringify({
+                                status: "success",
+                                notebooks: notebooks || [],
+                                count: notebooks?.length || 0
+                            }, null, 2)
+                        }
+                    ]
+                };
             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: JSON.stringify({ status: "success", notebook_id: newId }) }] };
             case "notebook_delete":
                 await client.deleteNotebook(args?.notebook_id);
-                return { content: [{ type: "text", text: `Cuaderno eliminado exitosamente.` }] };
+                return { content: [{ type: "text", text: JSON.stringify({ status: "success", message: `Deleted notebook ${args?.notebook_id}` }) }] };
             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: JSON.stringify({ status: "success", message: `Renamed notebook 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,15 +363,22 @@ 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)}` }],
-            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: "error",
+                        error: error.message || String(error)
+                    }, null, 2)
+                }
+            ]
         };
     }
 });
 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.7 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.7",
   "description": "Node.js Model Context Protocol server for Google NotebookLM",
   "type": "module",
   "repository": {