notebooklm-mcp

# Complete Index - NotebookLM MCP HTTP Deployment Package > Your navigation guide through the deployment documentation --- ## 📚 Overview This package contains **everything you need** to deploy NotebookLM MCP in HTTP REST API mode. **Package contents:** - ✅ 10 documentation files - ✅ 4 automated PowerShell scripts - ✅ Step-by-step installation guide - ✅ Complete API documentation - ✅ n8n integration guide - ✅ Auto-discovery feature documentation --- ## 🗂️ Directory Structure ``` deployment/ ├── README.md ← Start here! ├── QUICK-START.md ← For the impatient (5 min) ├── INDEX.md ← This file ├── LICENSE ← MIT License ├── CONTRIBUTING.md ← Contribution guide ├── CHANGELOG.md ← Version history ├── CREDITS.md ← Credits and acknowledgments ├── PACKAGE-FILES.txt ← List of files to copy │ ├── docs/ │ ├── 01-INSTALL.md ← Detailed installation guide │ ├── 02-CONFIGURATION.md ← Advanced configuration │ ├── 03-API.md ← API documentation │ ├── 04-N8N-INTEGRATION.md ← n8n integration │ ├── 05-TROUBLESHOOTING.md ← Problem resolution │ ├── 06-NOTEBOOK-LIBRARY.md ← Multi-notebook management │ └── 07-AUTO-DISCOVERY.md ← Auto-discovery pattern │ └── scripts/ ├── install.ps1 ← Automatic installation ├── start-server.ps1 ← Server startup ├── stop-server.ps1 ← Server shutdown └── test-server.ps1 ← Validation tests ``` --- ## 🎯 Where to Start? ### I'm in a HURRY (5 minutes) → **[QUICK-START.md](./QUICK-START.md)** Installation and testing in 5 quick steps ### I want a COMPLETE installation → **[README.md](./README.md)** then **[docs/01-INSTALL.md](./docs/01-INSTALL.md)** Detailed guide with explanations ### I want to AUTOMATE the installation → **[scripts/install.ps1](./scripts/install.ps1)** PowerShell script that does everything --- ## 📖 Available Documentation ### 📄 Main Guides | File | Description | Reading time | | -------------------------------------------- | ---------------------------- | ------------ | | **[README.md](./README.md)** | Package overview | 5 min | | **[QUICK-START.md](./QUICK-START.md)** | Quick start in 5 steps | 2 min | | **[INDEX.md](./INDEX.md)** | This file - navigation guide | 3 min | | **[PACKAGE-FILES.txt](./PACKAGE-FILES.txt)** | List of required files | 2 min | ### 📚 Detailed Documentation (docs/) | File | Description | Reading time | | ----------------------------------------------------------- | ------------------------------------------- | ------------ | | **[01-INSTALL.md](./docs/01-INSTALL.md)** | Complete installation from scratch | 15 min | | **[02-CONFIGURATION.md](./docs/02-CONFIGURATION.md)** | Advanced configuration, variables, security | 12 min | | **[03-API.md](./docs/03-API.md)** | Complete REST API documentation | 15 min | | **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)** | Integration with n8n, workflows | 20 min | | **[05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)** | Complete problem resolution | 15 min | | **[06-NOTEBOOK-LIBRARY.md](./docs/06-NOTEBOOK-LIBRARY.md)** | Multi-notebook library management | 12 min | | **[07-AUTO-DISCOVERY.md](./docs/07-AUTO-DISCOVERY.md)** | Autonomous resource discovery pattern | 15 min | ### 🤝 Contribution and Project | File | Description | Reading time | | ---------------------------------------- | --------------------------------- | ------------ | | **[LICENSE](./LICENSE)** | MIT License with attributions | 3 min | | **[CONTRIBUTING.md](./CONTRIBUTING.md)** | Detailed contribution guide | 10 min | | **[CHANGELOG.md](./CHANGELOG.md)** | Complete version history | 8 min | | **[CREDITS.md](./CREDITS.md)** | Credits, technologies, philosophy | 8 min | ### 🔧 PowerShell Scripts (scripts/) | Script | Description | Usage | | -------------------------------------------------- | ------------------------------- | ---------------------------- | | **[install.ps1](./scripts/install.ps1)** | Complete automatic installation | `.\scripts\install.ps1` | | **[start-server.ps1](./scripts/start-server.ps1)** | HTTP server startup | `.\scripts\start-server.ps1` | | **[stop-server.ps1](./scripts/stop-server.ps1)** | Clean server shutdown | `.\scripts\stop-server.ps1` | | **[test-server.ps1](./scripts/test-server.ps1)** | Validation tests | `.\scripts\test-server.ps1` | --- ## 🚀 Recommended Workflow ### 1️⃣ Initial Installation ```powershell # 1. Read the overview cat deployment\README.md # 2. Run automatic installation cd deployment .\scripts\install.ps1 # 3. Configure authentication (one time only) npm run setup-auth ``` ### 2️⃣ Daily Usage ```powershell # Start the server cd deployment .\scripts\start-server.ps1 # In another terminal: test .\scripts\test-server.ps1 # Stop the server .\scripts\stop-server.ps1 ``` ### 3️⃣ Integration with n8n 1. Read: **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)** (TODO) 2. Configure the HTTP Request node in n8n 3. Test from n8n --- ## 🎓 Usage Scenarios ### Scenario 1: First Deployment ``` 1. README.md → Overview 2. 01-INSTALL.md → Detailed installation 3. scripts/install.ps1 → Automation 4. scripts/test-server.ps1 → Validation ``` ### Scenario 2: Quick Deployment (Already familiar with Node.js) ``` 1. QUICK-START.md → 5 quick steps 2. scripts/install.ps1 → Installation 3. npm run setup-auth → Auth 4. scripts/start-server.ps1 → Startup ``` ### Scenario 3: n8n Integration ``` 1. 01-INSTALL.md → Server installation 2. 04-N8N-INTEGRATION.md → n8n configuration 3. scripts/test-server.ps1 → Tests 4. n8n Workflow → Production ``` ### Scenario 4: Troubleshooting ``` 1. 05-TROUBLESHOOTING.md → Common solutions 2. Server logs → Diagnostics 3. scripts/test-server.ps1 → Validation 4. GitHub Issues → Community support ``` --- ## 📊 Progress Status | Document | Status | Notes | | ---------------------- | ----------- | ------------------------ | | README.md | ✅ Complete | Overview updated | | QUICK-START.md | ✅ Complete | 5 min quick guide | | INDEX.md | ✅ Complete | This file - navigation | | PACKAGE-FILES.txt | ✅ Complete | File list | | LICENSE | ✅ Complete | MIT with attributions | | CONTRIBUTING.md | ✅ Complete | Contribution guide | | CHANGELOG.md | ✅ Complete | Version 1.1.2-http | | CREDITS.md | ✅ Complete | Complete credits | | 01-INSTALL.md | ✅ Complete | Detailed installation | | 02-CONFIGURATION.md | ✅ Complete | Variables, security, PM2 | | 03-API.md | ✅ Complete | 12 documented endpoints | | 04-N8N-INTEGRATION.md | ✅ Complete | 3 example workflows | | 05-TROUBLESHOOTING.md | ✅ Complete | Complete solutions | | 06-NOTEBOOK-LIBRARY.md | ✅ Complete | Multi-notebook library | | 07-AUTO-DISCOVERY.md | ✅ Complete | Auto-discovery pattern | | install.ps1 | ✅ Complete | Automatic installation | | start-server.ps1 | ✅ Complete | Startup with checks | | stop-server.ps1 | ✅ Complete | Clean shutdown | | test-server.ps1 | ✅ Complete | Validation tests | **Overall status:** ✅ 100% Complete - Ready for Git publication --- ## 🆘 Need Help? ### Quick Support 1. **Installation problem?** → [01-INSTALL.md](./docs/01-INSTALL.md) 2. **Startup error?** → [05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md) 3. **API question?** → [03-API.md](./docs/03-API.md) 4. **n8n integration?** → [04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md) ### Community Support - **GitHub Issues:** [To be configured upon repository publication] - **Discussions:** [To be configured upon repository publication] --- ## 📝 Release Notes **Current version:** 1.3.1 **Included in this version:** - ✅ MCP Auto-Discovery Tool: `auto_discover_notebook` for Claude Desktop - ✅ Critical fix: Claude Desktop compatibility (disabled CompleteRequestSchema) - ✅ HTTP Auto-Discovery: POST `/notebooks/auto-discover` endpoint - ✅ Progressive disclosure inspired by Claude Skills - ✅ Automatic metadata validation and generation - ✅ Orchestrators can discover documentation autonomously - ✅ Fix persistent authentication Windows - ✅ Fix NotebookLM streaming detection - ✅ Removal of "EXTREMELY IMPORTANT" system phrase - ✅ Server listens on 0.0.0.0 (network accessible) - ✅ PowerShell automation scripts - ✅ Complete deployment documentation - ✅ Chrome profile limitation documented **Possible future improvements (1.4.0+):** - 🔥 Separate Chrome profiles by mode (HTTP vs stdio) - HIGH PRIORITY - ⏳ Smart metadata refresh endpoint - ⏳ Semantic matching with embeddings - ⏳ Usage analytics for notebooks - ⏳ Optional Docker support - ⏳ Web administration interface - ⏳ Automated tests (unit + integration) - ⏳ JWT/OAuth authentication support --- ## 📄 License **MIT License** - See [LICENSE](./LICENSE) for complete details. - Original project © 2025 Please Prompto! - HTTP Wrapper © 2025 (Developed with Claude Code - Anthropic Claude Sonnet 4.5) --- ## 🤝 Contribution See [CONTRIBUTING.md](./CONTRIBUTING.md) for: - Reporting bugs - Proposing improvements - Submitting code - Standards and Git workflow --- **Last updated:** January 23, 2025 **Version:** 1.3.1 **Status:** ✅ Production-ready - Complete documentation