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 — Complete installation from scratch (Windows)
📚 Complete Documentation
| Document | Description | For whom? |
|---|---|---|
| 01-INSTALL.md | Complete installation guide from scratch | First installation |
| 02-CONFIGURATION.md | Environment variables, security, deployment | Advanced configuration |
| 03-API.md | Complete REST API reference | Developers, integration |
| 04-N8N-INTEGRATION.md | Integration guide with n8n | n8n users |
| 05-TROUBLESHOOTING.md | Solutions to common problems | Debugging, errors |
| 06-NOTEBOOK-LIBRARY.md | Multi-notebook library management | Notebook management |
| 07-AUTO-DISCOVERY.md | Autonomous resource discovery pattern | Auto-discovery feature |
| 08-DOCKER.md | Docker deployment with noVNC | Docker, NAS users |
| 11-MULTI-ACCOUNT.md | Multi-account management and rotation | Rate limit handling |
| Test Scripts | PowerShell validation scripts | Testing, CI/CD |
🎯 Guides by Use Case
I'm getting started
- Installation — Install Node.js, compile, authenticate
- Notebook configuration — Add your first notebook
- Testing — Verify everything works
I'm integrating with n8n
I have a problem
- Troubleshooting — Common problems and solutions
- Configuration — Configuration issues
I want to manage multiple notebooks
- Notebook library — Complete guide
- Notebooks API — Management endpoints
I want to test my installation
- Test scripts — Automated tests
- Quick test — Validation in 30 seconds
- Complete tests — Full suite (10 tests)
I'm hitting rate limits
- Multi-account setup — Configure multiple accounts
- Automatic rotation — How rotation works
- Quota management — Reset and monitor quotas
I want to deploy on Docker/NAS
- Docker guide — Complete Docker deployment
- noVNC authentication — Visual auth in browser
- NAS deployment — 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 |
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
Authentication fails → Troubleshooting - Authentication
Invalid notebook → Notebook Library - Validation
n8n cannot connect → Configuration - Firewall
External Documentation
- NotebookLM — Official Google service
- n8n — Automation platform
- Patchright — Stealth browser automation
- Model Context Protocol — MCP specification
Release History
Every release from 1.0.0 to the current version is documented with full "Added / Changed / Fixed / Security" breakdowns.
👉 See the full release history — 13 versions, 6 years of changes.
Latest: v1.5.8 (2026-04-19) — 2026 NotebookLM UI selectors, doctor scripts, PII scrub, npm audit fix.
📝 Contributing
Found an error in the documentation? An unclear section?
Open an issue: GitHub Issues
Or directly propose a PR to improve the documentation!
Documentation updated: 2026-01-05 Version: 1.5.3