@roomi-fields/notebooklm-mcp 1.5.2 → 1.5.7

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
-Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
+Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,201 +1,219 @@
-<div align="center">
-
-# NotebookLM MCP Server
-
-> **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
-
-**Full automation of Google NotebookLM: Q&A, audio podcasts, and source management**
-
-<!-- Badges -->
-
-[![CI](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml) [![npm version](https://badge.fury.io/js/%40roomi-fields%2Fnotebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![npm downloads](https://img.shields.io/npm/dm/@roomi-fields/notebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![codecov](https://codecov.io/gh/roomi-fields/notebooklm-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/roomi-fields/notebooklm-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/) [![Node.js](https://img.shields.io/badge/Node.js->=18-green.svg)](https://nodejs.org/)
-
-[![MCP](https://img.shields.io/badge/MCP-2025-green.svg)](https://modelcontextprotocol.io/) [![Claude Code](https://img.shields.io/badge/Claude_Code-MCP-8A2BE2)](https://claude.ai/claude-code) [![n8n](https://img.shields.io/badge/n8n-HTTP_API-orange)](./deployment/docs/04-N8N-INTEGRATION.md) [![GitHub](https://img.shields.io/github/stars/roomi-fields/notebooklm-mcp?style=social)](https://github.com/roomi-fields/notebooklm-mcp)
-
-<!-- End Badges -->
-
-</div>
-
----
-
-## Features
-
-### Q&A with Citations
-
-- **Ask questions** to NotebookLM and get accurate, citation-backed answers
-- **Source citation extraction** with 5 formats: none, inline, footnotes, json, expanded
-- **Session management** for multi-turn conversations
-
-### Content Generation
-
-Generate multiple content types from your notebook sources:
-
-| Content Type       | Formats                  | Options                                        |
-| ------------------ | ------------------------ | ---------------------------------------------- |
-| **Audio Overview** | Podcast-style discussion | Language (80+), custom instructions            |
-| **Video**          | Brief, Explainer         | 6 visual styles, language, custom instructions |
-| **Infographic**    | Horizontal, Vertical     | Language, custom instructions                  |
-| **Report**         | Summary, Detailed        | Language, custom instructions                  |
-| **Presentation**   | Overview, Detailed       | Language, custom instructions                  |
-| **Data Table**     | Simple, Detailed         | Language, custom instructions                  |
-
-**Video Visual Styles**: classroom, documentary, animated, corporate, cinematic, minimalist
-
-### Content Download
-
-- **Download Audio** — WAV audio files
-- **Download Video** — MP4 video files
-- **Download Infographic** — PNG image files
-- Text-based content (report, presentation, data_table) is returned in the API response
-
-### Source Management
-
-- **Add sources**: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive
-- **List sources**: View all sources in a notebook
-
-### Notebook Library
-
-- **Multi-notebook management** with validation and smart selection
-- **Auto-discovery**: Automatically generate metadata via NotebookLM queries
-- **Search notebooks** by keyword in name, description, or topics
-
-### Integration Options
-
-- **MCP Protocol** — Claude Code, Cursor, Codex, any MCP client
-- **HTTP REST API** — n8n, Zapier, Make.com, custom integrations
-
----
-
-## Quick Start
-
-> ⚠️ **npm registry temporarily unavailable** - Install from GitHub instead (see below)
-
-### Option 1: MCP Mode (Claude Code, Cursor, Codex)
-
-```bash
-# Clone and build locally
-git clone https://github.com/roomi-fields/notebooklm-mcp.git
-cd notebooklm-mcp
-npm install && npm run build
-
-# Claude Code
-claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js
-
-# Cursor - add to ~/.cursor/mcp.json
-{
-  "mcpServers": {
-    "notebooklm": {
-      "command": "node",
-      "args": ["/path/to/notebooklm-mcp/dist/index.js"]
-    }
-  }
-}
-```
-
-Then say: _"Log me in to NotebookLM"_ → Chrome opens → log in with Google.
-
-### Option 2: HTTP REST API (n8n, Zapier, Make.com)
-
-```bash
-git clone https://github.com/roomi-fields/notebooklm-mcp.git
-cd notebooklm-mcp
-npm install && npm run build
-npm run setup-auth   # One-time Google login
-npm run start:http   # Start server on port 3000
-```
-
-```bash
-# Query the API
-curl -X POST http://localhost:3000/ask \
-  -H "Content-Type: application/json" \
-  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
-```
-
----
-
-## Documentation
-
-| Guide                                                        | Description                               |
-| ------------------------------------------------------------ | ----------------------------------------- |
-| [Installation](./deployment/docs/01-INSTALL.md)              | Step-by-step setup for HTTP and MCP modes |
-| [Configuration](./deployment/docs/02-CONFIGURATION.md)       | Environment variables and security        |
-| [API Reference](./deployment/docs/03-API.md)                 | Complete HTTP endpoint documentation      |
-| [n8n Integration](./deployment/docs/04-N8N-INTEGRATION.md)   | Workflow automation setup                 |
-| [Troubleshooting](./deployment/docs/05-TROUBLESHOOTING.md)   | Common issues and solutions               |
-| [Notebook Library](./deployment/docs/06-NOTEBOOK-LIBRARY.md) | Multi-notebook management                 |
-| [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |
-| [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |
-| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |
-| [Adding a Language](./docs/ADDING_A_LANGUAGE.md)             | i18n system for multilingual UI support   |
-
----
-
-## Roadmap
-
-See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
-
-**Latest releases:**
-
-- **v1.5.1** — Multilingual UI support (FR/EN) with i18n selector system + E2E tests (76 tests)
-- **v1.5.0** — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources
-- **v1.4.0** — Content management (sources, audio, generation) + Multi-account
-- **v1.3.7** — Source citation extraction (5 formats)
-
-**Not yet implemented:**
-
-- Discover sources (Web/Drive search with Fast/Deep modes)
-- Edit notes (create, delete, and convert are implemented)
-
----
-
-## Disclaimer
-
-This tool automates browser interactions with NotebookLM. Use a dedicated Google account for automation. CLI tools like Claude Code can make mistakes — always review changes before deploying.
-
-See full [Disclaimer](#disclaimer-details) below.
-
----
-
-## Contributing
-
-Found a bug? Have an idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
-
-## License
-
-MIT — Use freely in your projects. See [LICENSE](./LICENSE).
-
-## Author
-
-**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)
-
----
-
-<details>
-<summary><a name="disclaimer-details"></a>Full Disclaimer</summary>
-
-**About browser automation:**
-While I've built in humanization features (realistic typing speeds, natural delays, mouse movements), I can't guarantee Google won't detect or flag automated usage. Use a dedicated Google account for automation.
-
-**About CLI tools and AI agents:**
-CLI tools like Claude Code, Codex, and similar AI-powered assistants are powerful but can make mistakes:
-
-- Always review changes before committing or deploying
-- Test in safe environments first
-- Keep backups of important work
-- AI agents are assistants, not infallible oracles
-
-I built this tool for myself and share it hoping it helps others, but I can't take responsibility for any issues that might occur. Use at your own discretion.
-
-</details>
-
----
-
-<div align="center">
-
-Built with frustration about hallucinated APIs, powered by Google's NotebookLM
-
-⭐ [Star on GitHub](https://github.com/roomi-fields/notebooklm-mcp) if this saves you debugging time!
-
-</div>
+<div align="center">
+
+# NotebookLM MCP Server
+
+> **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
+
+**Full automation of Google NotebookLM: Q&A, audio podcasts, and source management**
+
+<!-- Badges -->
+
+[![CI](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml) [![npm version](https://badge.fury.io/js/%40roomi-fields%2Fnotebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![npm downloads](https://img.shields.io/npm/dm/@roomi-fields/notebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![codecov](https://codecov.io/gh/roomi-fields/notebooklm-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/roomi-fields/notebooklm-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/) [![Node.js](https://img.shields.io/badge/Node.js->=18-green.svg)](https://nodejs.org/)
+
+[![MCP](https://img.shields.io/badge/MCP-2025-green.svg)](https://modelcontextprotocol.io/) [![Claude Code](https://img.shields.io/badge/Claude_Code-MCP-8A2BE2)](https://claude.ai/claude-code) [![n8n](https://img.shields.io/badge/n8n-HTTP_API-orange)](./deployment/docs/04-N8N-INTEGRATION.md) [![GitHub](https://img.shields.io/github/stars/roomi-fields/notebooklm-mcp?style=social)](https://github.com/roomi-fields/notebooklm-mcp)
+
+<!-- End Badges -->
+
+</div>
+
+---
+
+## Features
+
+### Q&A with Citations
+
+- **Ask questions** to NotebookLM and get accurate, citation-backed answers
+- **Source citation extraction** with 5 formats: none, inline, footnotes, json, expanded (97% excerpt success rate)
+- **Session management** for multi-turn conversations with auto-reauth on session expiry
+
+### Content Generation
+
+Generate multiple content types from your notebook sources:
+
+| Content Type       | Formats                  | Options                                        |
+| ------------------ | ------------------------ | ---------------------------------------------- |
+| **Audio Overview** | Podcast-style discussion | Language (80+), custom instructions            |
+| **Video**          | Brief, Explainer         | 6 visual styles, language, custom instructions |
+| **Infographic**    | Horizontal, Vertical     | Language, custom instructions                  |
+| **Report**         | Summary, Detailed        | Language, custom instructions                  |
+| **Presentation**   | Overview, Detailed       | Language, custom instructions                  |
+| **Data Table**     | Simple, Detailed         | Language, custom instructions                  |
+
+**Video Visual Styles**: classroom, documentary, animated, corporate, cinematic, minimalist
+
+### Content Download
+
+- **Download Audio** — WAV audio files
+- **Download Video** — MP4 video files
+- **Download Infographic** — PNG image files
+- Text-based content (report, presentation, data_table) is returned in the API response
+
+### Source Management
+
+- **Add sources**: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive
+- **List sources**: View all sources in a notebook
+
+### Notebook Library
+
+- **Multi-notebook management** with validation and smart selection
+- **Auto-discovery**: Automatically generate metadata via NotebookLM queries
+- **Search notebooks** by keyword in name, description, or topics
+- **Scrape notebooks**: List all notebooks from NotebookLM with IDs and names
+- **Bulk delete**: Delete multiple notebooks at once
+
+### Integration Options
+
+- **MCP Protocol** — Claude Code, Cursor, Codex, any MCP client
+- **HTTP REST API** — n8n, Zapier, Make.com, custom integrations
+- **Docker** — Isolated deployment with Docker or Docker Compose
+
+---
+
+## Quick Start
+
+### Option 1: MCP Mode (Claude Code, Cursor, Codex)
+
+```bash
+# Clone and build locally
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install && npm run build
+
+# Claude Code
+claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js
+
+# Cursor - add to ~/.cursor/mcp.json
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "node",
+      "args": ["/path/to/notebooklm-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+Then say: _"Log me in to NotebookLM"_ → Chrome opens → log in with Google.
+
+### Option 2: HTTP REST API (n8n, Zapier, Make.com)
+
+```bash
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install && npm run build
+npm run setup-auth   # One-time Google login
+npm run start:http   # Start server on port 3000
+```
+
+```bash
+# Query the API
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
+```
+
+### Option 3: Docker (NAS, Server)
+
+```bash
+# Build and run
+docker build -t notebooklm-mcp .
+docker run -d --name notebooklm-mcp -p 3000:3000 -p 6080:6080 -v notebooklm-data:/data notebooklm-mcp
+
+# Authenticate via noVNC
+# 1. Open http://localhost:6080/vnc.html
+# 2. Run: curl -X POST http://localhost:3000/setup-auth -d '{"show_browser":true}'
+# 3. Login to Google in the VNC window
+```
+
+See [Docker Guide](./deployment/docs/08-DOCKER.md) for NAS deployment (Synology, QNAP).
+
+---
+
+## Documentation
+
+| Guide                                                        | Description                               |
+| ------------------------------------------------------------ | ----------------------------------------- |
+| [Installation](./deployment/docs/01-INSTALL.md)              | Step-by-step setup for HTTP and MCP modes |
+| [Configuration](./deployment/docs/02-CONFIGURATION.md)       | Environment variables and security        |
+| [API Reference](./deployment/docs/03-API.md)                 | Complete HTTP endpoint documentation      |
+| [n8n Integration](./deployment/docs/04-N8N-INTEGRATION.md)   | Workflow automation setup                 |
+| [Troubleshooting](./deployment/docs/05-TROUBLESHOOTING.md)   | Common issues and solutions               |
+| [Notebook Library](./deployment/docs/06-NOTEBOOK-LIBRARY.md) | Multi-notebook management                 |
+| [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |
+| [Docker](./deployment/docs/08-DOCKER.md)                     | Docker and Docker Compose deployment      |
+| [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |
+| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |
+| [Adding a Language](./docs/ADDING_A_LANGUAGE.md)             | i18n system for multilingual UI support   |
+
+---
+
+## Roadmap
+
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
+
+**Latest releases:**
+
+- **v1.5.3** — Docker deployment with noVNC for visual authentication + NAS support (Synology, QNAP)
+- **v1.5.2** — Notebook scraping from NotebookLM + Bulk delete + Bug fixes
+- **v1.5.1** — Multilingual UI support (FR/EN) with i18n selector system + E2E tests (76 tests)
+- **v1.5.0** — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources
+- **v1.4.0** — Content management (sources, audio, generation) + Multi-account
+
+**Not yet implemented:**
+
+- Discover sources (Web/Drive search with Fast/Deep modes)
+- Edit notes (create, delete, and convert are implemented)
+
+---
+
+## Disclaimer
+
+This tool automates browser interactions with NotebookLM. Use a dedicated Google account for automation. CLI tools like Claude Code can make mistakes — always review changes before deploying.
+
+See full [Disclaimer](#disclaimer-details) below.
+
+---
+
+## Contributing
+
+Found a bug? Have an idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT — Use freely in your projects. See [LICENSE](./LICENSE).
+
+## Author
+
+**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)
+
+---
+
+<details>
+<summary><a name="disclaimer-details"></a>Full Disclaimer</summary>
+
+**About browser automation:**
+While I've built in humanization features (realistic typing speeds, natural delays, mouse movements), I can't guarantee Google won't detect or flag automated usage. Use a dedicated Google account for automation.
+
+**About CLI tools and AI agents:**
+CLI tools like Claude Code, Codex, and similar AI-powered assistants are powerful but can make mistakes:
+
+- Always review changes before committing or deploying
+- Test in safe environments first
+- Keep backups of important work
+- AI agents are assistants, not infallible oracles
+
+I built this tool for myself and share it hoping it helps others, but I can't take responsibility for any issues that might occur. Use at your own discretion.
+
+</details>
+
+---
+
+<div align="center">
+
+Built with frustration about hallucinated APIs, powered by Google's NotebookLM
+
+⭐ [Star on GitHub](https://github.com/roomi-fields/notebooklm-mcp) if this saves you debugging time!
+
+</div>