notebooklm-mcp

# NotebookLM MCP HTTP Server Documentation > Complete documentation for the NotebookLM HTTP server --- ## 🚀 Quick Start **New to the project?** Start with the installation guide: 👉 [**01-INSTALL.md**](./01-INSTALL.md) — Complete installation from scratch (Windows) --- ## 📚 Complete Documentation | Document | Description | For whom? | | ------------------------------------------------------ | ------------------------------------------- | ----------------------- | | [**01-INSTALL.md**](./01-INSTALL.md) | Complete installation guide from scratch | First installation | | [**02-CONFIGURATION.md**](./02-CONFIGURATION.md) | Environment variables, security, deployment | Advanced configuration | | [**03-API.md**](./03-API.md) | Complete REST API reference | Developers, integration | | [**04-N8N-INTEGRATION.md**](./04-N8N-INTEGRATION.md) | Integration guide with n8n | n8n users | | [**05-TROUBLESHOOTING.md**](./05-TROUBLESHOOTING.md) | Solutions to common problems | Debugging, errors | | [**06-NOTEBOOK-LIBRARY.md**](./06-NOTEBOOK-LIBRARY.md) | Multi-notebook library management | Notebook management | | [**07-AUTO-DISCOVERY.md**](./07-AUTO-DISCOVERY.md) | Autonomous resource discovery pattern | Auto-discovery feature | | [**08-DOCKER.md**](./08-DOCKER.md) | Docker deployment with noVNC | Docker, NAS users | | [**11-MULTI-ACCOUNT.md**](./11-MULTI-ACCOUNT.md) | Multi-account management and rotation | Rate limit handling | | [**Test Scripts**](../scripts/README.md) | PowerShell validation scripts | Testing, CI/CD | --- ## 🎯 Guides by Use Case ### I'm getting started 1. [Installation](./01-INSTALL.md) — Install Node.js, compile, authenticate 2. [Notebook configuration](./06-NOTEBOOK-LIBRARY.md#-guide-de-d%C3%A9marrage) — Add your first notebook 3. [Testing](./01-INSTALL.md#-v%C3%A9rification) — Verify everything works ### I'm integrating with n8n 1. [Installation](./01-INSTALL.md) 2. [Network configuration](./02-CONFIGURATION.md#-s%C3%A9curit%C3%A9) 3. [n8n integration](./04-N8N-INTEGRATION.md) ### I have a problem 1. [Troubleshooting](./05-TROUBLESHOOTING.md) — Common problems and solutions 2. [Configuration](./02-CONFIGURATION.md#-troubleshooting-configuration) — Configuration issues ### I want to manage multiple notebooks 1. [Notebook library](./06-NOTEBOOK-LIBRARY.md) — Complete guide 2. [Notebooks API](./03-API.md#5-add-notebook) — Management endpoints ### I want to test my installation 1. [Test scripts](../scripts/README.md) — Automated tests 2. [Quick test](../scripts/README.md#-test-serverps1) — Validation in 30 seconds 3. [Complete tests](../scripts/README.md#-test-apips1) — Full suite (10 tests) ### I'm hitting rate limits 1. [Multi-account setup](./11-MULTI-ACCOUNT.md) — Configure multiple accounts 2. [Automatic rotation](./11-MULTI-ACCOUNT.md#automatic-rotation-flow) — How rotation works 3. [Quota management](./11-MULTI-ACCOUNT.md#troubleshooting) — Reset and monitor quotas ### I want to deploy on Docker/NAS 1. [Docker guide](./08-DOCKER.md) — Complete Docker deployment 2. [noVNC authentication](./08-DOCKER.md#first-time-authentication-via-novnc) — Visual auth in browser 3. [NAS deployment](./08-DOCKER.md#nas-deployment-synology-qnap) — Synology, QNAP setup --- ## 📖 Quick Reference ### Main Endpoints | Endpoint | Method | Description | | -------------------------- | ------ | ------------------------------------- | | `/health` | GET | Check server status | | `/ask` | POST | Ask a question to NotebookLM | | `/notebooks` | GET | List notebooks | | `/notebooks` | POST | Add a notebook (with validation) | | `/notebooks/auto-discover` | POST | Auto-generate notebook metadata | | `/notebooks/:id` | DELETE | Delete a notebook | | `/notebooks/:id/activate` | PUT | Activate a notebook | | `/content/sources` | POST | Add source to notebook | | `/content/generate` | POST | Generate content (audio, video, etc.) | | `/content/download` | GET | Download/export generated content | **👉 [Complete API reference](./03-API.md)** ### Useful Scripts | Command | Description | | -------------------------------------- | ---------------------------------------- | | `npm run build` | Compile TypeScript | | `npm run start:http` | Start HTTP server (foreground) | | `npm run daemon:start` | Start server in background (daemon mode) | | `npm run daemon:stop` | Stop background server | | `npm run daemon:logs` | View background server logs | | `npm run daemon:status` | Check daemon status | | `npm run dev:http` | Development mode (auto-reload) | | `npm run setup-auth` | Configure Google authentication | | `.\deployment\scripts\setup-auth.ps1` | PowerShell authentication script | | `.\deployment\scripts\test-server.ps1` | Quick tests (3 tests, 30s) | | `.\deployment\scripts\test-api.ps1` | Complete tests (10 tests, 5-10min) | | `.\deployment\scripts\test-errors.ps1` | Error case tests (12 tests) | ### Important Files | File | Location | Description | | -------------- | ------------------------------------------------------------ | -------------------- | | `state.json` | `%LOCALAPPDATA%\notebooklm-mcp\Data\browser_state\` | Authentication state | | `Cookies` | `%LOCALAPPDATA%\notebooklm-mcp\Data\chrome_profile\Default\` | Google cookies | | `library.json` | `%LOCALAPPDATA%\notebooklm-mcp\Data\` | Notebook library | --- ## 🆘 Need Help? ### Common Problems **Server won't start** → [Troubleshooting - EADDRINUSE](./05-TROUBLESHOOTING.md#probl%C3%A8me-eaddrinuse-address-already-in-use) **Authentication fails** → [Troubleshooting - Authentication](./05-TROUBLESHOOTING.md#probl%C3%A8me-authentication-failed) **Invalid notebook** → [Notebook Library - Validation](./06-NOTEBOOK-LIBRARY.md#-validations-automatiques) **n8n cannot connect** → [Configuration - Firewall](./02-CONFIGURATION.md#2-firewall-windows) ### External Documentation - [NotebookLM](https://notebooklm.google.com) — Official Google service - [n8n](https://n8n.io) — Automation platform - [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright) — Stealth browser automation - [Model Context Protocol](https://modelcontextprotocol.io/) — MCP specification --- ## Changelog ### v1.4.2 (2025-12-29) **Removed fake content generation:** - Removed `generate_content` endpoint for FAQ, Study Guide, Briefing Doc, Timeline, TOC - These were NOT real NotebookLM features - just chat prompts - Only REAL content generation: Audio Overview (podcast) - Updated all documentation for honesty ### v1.4.0 (2025-12-24) **Content Management:** - Audio Overview generation (podcast) - REAL NotebookLM feature - Audio download - Source management (files, URLs, text, YouTube) ### v1.3.1 (2025-01-24) **New features:** - MCP Auto-Discovery Tool: `auto_discover_notebook` for Claude Desktop/Cursor - Parity with HTTP API: MCP clients now have auto-discovery capability - Zero-friction notebook addition: just URL, metadata auto-generated **Critical Fixes:** - Claude Desktop compatibility: Disabled `CompleteRequestSchema` handler - Fixed "Server does not support completions" error on connection ### v1.1.2 (2025-11-22) **New features:** - ✅ Multi-notebook library system - ✅ Live validation of notebooks when adding - ✅ Protection against duplicate names - ✅ DELETE and PUT endpoints for notebooks - ✅ Detailed and contextualized error messages **Fixes:** - ✅ Fixed Cookies path (Default/Network/Cookies) - ✅ Cookies threshold lowered to 10KB - ✅ Better temporary session management **Documentation:** - ✅ New guide [06-NOTEBOOK-LIBRARY.md](./06-NOTEBOOK-LIBRARY.md) - ✅ "Notebook Configuration" section in [01-INSTALL.md](./01-INSTALL.md) - ✅ Enhanced API in [03-API.md](./03-API.md) --- ## 📝 Contributing Found an error in the documentation? An unclear section? **Open an issue:** [GitHub Issues](https://github.com/roomi-fields/notebooklm-mcp/issues) Or directly propose a PR to improve the documentation! --- **Documentation updated:** 2026-01-05 **Version:** 1.5.3