@roomi-fields/notebooklm-mcp 1.3.4 → 1.3.5

package/README.md

@@ -1,715 +1,764 @@
-<div align="center">
-
-# NotebookLM MCP Server
-
-> **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
-
-**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
-
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
-[![MCP](https://img.shields.io/badge/MCP-2025-green.svg)](https://modelcontextprotocol.io/)
-[![npm](https://img.shields.io/npm/v/@roomi-fields/notebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![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)
-
-[MCP Installation](#mcp-installation) • [HTTP REST API](#http-rest-api) • [Why NotebookLM](#why-notebooklm-not-local-rag) • [Examples](#real-world-example) • [Documentation](./deployment/docs/)
-
-</div>
-
----
-
-> **⚠️ Current Limitation (v1.3.2):** HTTP and MCP stdio modes cannot run simultaneously due to Chrome profile locking. Choose one mode at a time, or see [Chrome Profile Limitation](./docs/CHROME_PROFILE_LIMITATION.md) for details. This will be fixed in v1.4.0 with automatic profile separation.
-
----
-
-## 🚀 Two Ways to Use This Server
-
-### 1️⃣ **HTTP REST API** (New! Recommended for n8n, Zapier, Make.com)
-
-Use NotebookLM from **any tool** via HTTP REST API:
-
-**Option A: Install from npm**
-```bash
-# Install globally
-npm install -g @roomi-fields/notebooklm-mcp
-
-# For MCP stdio mode (Claude Code, Cursor)
-notebooklm-mcp
-
-# For HTTP server mode
-# Note: Currently requires cloning the repo for HTTP mode
-# See Option B below
-```
-
-**Option B: Install from source (Required for HTTP mode)**
-```bash
-# Clone and install
-git clone https://github.com/roomi-fields/notebooklm-mcp.git
-cd notebooklm-mcp
-npm install
-npm run build
-npm run start:http
-```
-
-**Query the API:**
-```bash
-curl -X POST http://localhost:3000/ask \
-  -H "Content-Type: application/json" \
-  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
-```
-
-**Perfect for:**
-- ✅ n8n workflows and automation
-- ✅ Zapier, Make.com integrations
-- ✅ Custom web applications
-- ✅ Backend APIs
-
-**👉 Full HTTP setup guide:** [deployment/docs/01-INSTALL.md](./deployment/docs/01-INSTALL.md)
-
----
-
-### 2️⃣ **MCP stdio** (For Claude Code, Cursor, Codex)
-
-Use NotebookLM directly from your AI coding assistant:
-
-```bash
-# Claude Code
-claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
-
-# Codex
-codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
-
-# Cursor (add to ~/.cursor/mcp.json)
-{
-  "mcpServers": {
-    "notebooklm": {
-      "command": "npx",
-      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
-    }
-  }
-}
-```
-
-**Perfect for:**
-- ✅ Claude Code, Cursor, Codex
-- ✅ Any MCP-compatible AI assistant
-- ✅ Direct CLI integration
-
----
-
-## The Problem
-
-When you tell Claude Code or Cursor to "search through my local documentation", here's what happens:
-- **Massive token consumption**: Searching through documentation means reading multiple files repeatedly
-- **Inaccurate retrieval**: Searches for keywords, misses context and connections between docs
-- **Hallucinations**: When it can't find something, it invents plausible-sounding APIs
-- **Expensive & slow**: Each question requires re-reading multiple files
-
-## The Solution
-
-Let your tools chat directly with [**NotebookLM**](https://notebooklm.google/) — Google's **zero-hallucination knowledge base** powered by Gemini 2.5 that provides intelligent, synthesized answers from your docs.
-
-```
-Your Task → Agent/n8n asks NotebookLM → Gemini synthesizes answer → Correct output
-```
-
-**The real advantage**: No more manual copy-paste. Your agent/workflow asks NotebookLM directly and gets answers back. Build deep understanding through automatic follow-ups.
-
----
-
-## Why NotebookLM, Not Local RAG?
-
-| Approach | Token Cost | Setup Time | Hallucinations | Answer Quality |
-|----------|------------|------------|----------------|----------------|
-| **Feed docs to Claude** | 🔴 Very high (multiple file reads) | Instant | Yes - fills gaps | Variable retrieval |
-| **Web search** | 🟡 Medium | Instant | High - unreliable sources | Hit or miss |
-| **Local RAG** | 🟡 Medium-High | Hours (embeddings, chunking) | Medium - retrieval gaps | Depends on setup |
-| **NotebookLM MCP** | 🟢 Minimal | 5 minutes | **Zero** - refuses if unknown | Expert synthesis |
-
-### What Makes NotebookLM Superior?
-
-1. **Pre-processed by Gemini**: Upload docs once, get instant expert knowledge
-2. **Natural language Q&A**: Not just retrieval — actual understanding and synthesis
-3. **Multi-source correlation**: Connects information across 50+ documents
-4. **Citation-backed**: Every answer includes source references
-5. **No infrastructure**: No vector DBs, embeddings, or chunking strategies needed
-
----
-
-## HTTP REST API
-
-### Quick Start
-
-```powershell
-# 1. Clone and install
-git clone <repo-url> D:\notebooklm-http
-cd D:\notebooklm-http
-npm install
-npm run build
-
-# 2. Configure authentication (one-time)
-npm run setup-auth
-# Chrome opens → log in with Google → close Chrome
-
-# 3. Start the server
-
-# Option A: Foreground mode (terminal stays open)
-npm run start:http
-
-# Option B: Background daemon mode (recommended for production)
-npm run daemon:start    # Start in background
-npm run daemon:logs     # View logs
-npm run daemon:status   # Check status
-npm run daemon:stop     # Stop server
-
-# 4. Add your first notebook (in another terminal if using Option A)
-curl -X POST http://localhost:3000/notebooks \
-  -H "Content-Type: application/json" \
-  -d '{
-    "url": "https://notebooklm.google.com/notebook/YOUR-NOTEBOOK-ID",
-    "name": "My Knowledge Base",
-    "description": "My documentation",
-    "topics": ["docs", "api"]
-  }'
-
-# 5. Query NotebookLM
-curl -X POST http://localhost:3000/ask \
-  -H "Content-Type: application/json" \
-  -d '{"question": "Explain X"}'
-
-# 6. Validate installation (optional)
-.\deployment\scripts\test-server.ps1
-```
-
-**👉 See [Testing Guide](./deployment/scripts/README.md) for automated test suite**
-
-### API Endpoints
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| `GET` | `/health` | Check server health |
-| `POST` | `/ask` | Ask a question to NotebookLM |
-| `GET` | `/notebooks` | List all notebooks |
-| `POST` | `/notebooks` | Add notebook (with live validation) |
-| `POST` | `/notebooks/auto-discover` | Auto-generate notebook metadata |
-| `DELETE` | `/notebooks/:id` | Remove a notebook |
-| `PUT` | `/notebooks/:id/activate` | Set active notebook |
-| `GET` | `/sessions` | List active sessions |
-| `DELETE` | `/sessions/:id` | Close a session |
-
-**👉 Full API documentation:** [deployment/docs/03-API.md](./deployment/docs/03-API.md)
-
-### n8n Integration
-
-Perfect for n8n workflows:
-
-```json
-{
-  "nodes": [
-    {
-      "name": "Ask NotebookLM",
-      "type": "n8n-nodes-base.httpRequest",
-      "parameters": {
-        "method": "POST",
-        "url": "http://your-server:3000/ask",
-        "jsonParameters": true,
-        "bodyParametersJson": {
-          "question": "{{ $json.query }}",
-          "notebook_id": "my-notebook"
-        }
-      }
-    }
-  ]
-}
-```
-
-**👉 n8n guide:** [deployment/docs/04-N8N-INTEGRATION.md](./deployment/docs/04-N8N-INTEGRATION.md)
-
----
-
-## 🔍 Auto-Discovery : Self-Organizing Documentation
-
-Autonomous resource discovery enables AI orchestrators to find and use relevant documentation without manual intervention.
-
-### How it works
-
-**1. Add notebook** (zero manual metadata):
-```bash
-curl -X POST http://localhost:3000/notebooks/auto-discover \
-  -H "Content-Type: application/json" \
-  -d '{"url": "https://notebooklm.google.com/notebook/YOUR_ID"}'
-```
-
-**2. System queries NotebookLM** to auto-generate:
-- Kebab-case name (3 words max)
-- Concise description (2 sentences)
-- Relevant tags (8-10 keywords)
-
-**3. Orchestrators discover autonomously**:
-- Claude Code finds relevant docs without prompting
-- n8n workflows auto-select documentation
-- Cursor matches context to notebooks
-
-### Progressive disclosure pattern
-
-Inspired by [Claude Skills best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices#progressive-disclosure-patterns):
-
-- **Level 0** (startup): Lightweight metadata loaded (~500 tokens)
-- **Level 1** (matching): Local tag/description search (0 NotebookLM queries)
-- **Level 2** (deep query): Targeted NotebookLM query only when needed
-
-### Why this matters
-
-**Before**: Manual library management, orchestrators can't discover resources autonomously
-
-**After**: Self-organizing library, autonomous documentation discovery
-
-Perfect for:
-- ✅ Teams with 10+ documentation notebooks
-- ✅ n8n workflows needing dynamic doc access
-- ✅ Claude Code autonomous research
-- ✅ Onboarding new developers without manual setup
-
-### Example workflow
-
-```bash
-# 1. Add documentation notebooks (auto-discover metadata)
-curl -X POST /notebooks/auto-discover -d '{"url": "https://notebooklm.google.com/notebook/n8n-docs"}'
-curl -X POST /notebooks/auto-discover -d '{"url": "https://notebooklm.google.com/notebook/react-guide"}'
-
-# 2. Claude Code autonomously discovers relevant notebook
-User: "Build Gmail automation with n8n"
-→ System matches: "n8n-docs" (tags: ["n8n", "gmail", "automation"])
-→ Query NotebookLM: "Gmail node configuration?"
-→ Claude implements with accurate info
-
-# 3. Zero hallucinations, zero manual intervention
-```
-
----
-
-### Background Daemon Mode
-
-Run the HTTP server as a background process without keeping a terminal window open:
-
-```bash
-# Start server in background
-npm run daemon:start
-
-# View real-time logs
-npm run daemon:logs
-
-# Check server status
-npm run daemon:status
-
-# Restart server
-npm run daemon:restart
-
-# Stop server
-npm run daemon:stop
-
-# Remove from PM2 process list
-npm run daemon:delete
-```
-
-**Features:**
-- ✅ Runs in background without terminal window
-- ✅ Auto-restart on crash
-- ✅ Centralized log management (logs/pm2-*.log)
-- ✅ Memory limit protection (1GB max)
-- ✅ Production-ready process management
-
-**Configuration:** Edit `ecosystem.config.cjs` to customize PM2 behavior (env vars, restart policy, etc.)
-
-### Installation & Documentation
-
-- 📖 [**Installation Guide**](./deployment/docs/01-INSTALL.md) — Step-by-step setup
-- 🔧 [**Configuration**](./deployment/docs/02-CONFIGURATION.md) — Environment variables, security
-- 📡 [**API Reference**](./deployment/docs/03-API.md) — Complete endpoint documentation
-- 📚 [**Notebook Library**](./deployment/docs/06-NOTEBOOK-LIBRARY.md) — Multi-notebook management
-- ✅ [**Testing Suite**](./deployment/scripts/README.md) — Automated validation scripts
-- 🐛 [**Troubleshooting**](./deployment/docs/05-TROUBLESHOOTING.md) — Common issues
-
----
-
-## MCP Installation
-
-<details>
-<summary>Claude Code</summary>
-
-```bash
-claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
-```
-</details>
-
-<details>
-<summary>Codex</summary>
-
-```bash
-codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
-```
-</details>
-
-<details>
-<summary>Gemini</summary>
-
-```bash
-gemini mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
-```
-</details>
-
-<details>
-<summary>Cursor</summary>
-
-Add to `~/.cursor/mcp.json`:
-```json
-{
-  "mcpServers": {
-    "notebooklm": {
-      "command": "npx",
-      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
-    }
-  }
-}
-```
-</details>
-
-<details>
-<summary>amp</summary>
-
-```bash
-amp mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
-```
-</details>
-
-<details>
-<summary>VS Code</summary>
-
-```bash
-code --add-mcp '{"name":"notebooklm","command":"npx","args":["@roomi-fields/notebooklm-mcp@latest"]}'
-```
-</details>
-
-<details>
-<summary>Other MCP clients</summary>
-
-**Generic MCP config:**
-```json
-{
-  "mcpServers": {
-    "notebooklm": {
-      "command": "npx",
-      "args": ["@roomi-fields/notebooklm-mcp@latest"]
-    }
-  }
-}
-```
-</details>
-
-### MCP Quick Start
-
-1. **Install** the MCP server (see above)
-
-2. **Authenticate** (one-time)
-
-Say in your chat (Claude/Codex):
-```
-"Log me in to NotebookLM"
-```
-*A Chrome window opens → log in with Google*
-
-3. **Create your knowledge base**
-
-Go to [notebooklm.google.com](https://notebooklm.google.com) → Create notebook → Upload your docs:
-- 📄 PDFs, Google Docs, markdown files
-- 🔗 Websites, GitHub repos
-- 🎥 YouTube videos
-- 📚 Multiple sources per notebook
-
-Share: **⚙️ Share → Anyone with link → Copy**
-
-4. **Let Claude use it**
-
-```
-"I'm building with [library]. Here's my NotebookLM: [link]"
-```
-
-**That's it.** Claude now asks NotebookLM whatever it needs, building expertise before writing code.
-
----
-
-## Related Project: Claude Code Skill (by original author)
-
-The original author [PleasePrompto](https://github.com/PleasePrompto) also created a **Python-based Claude Code Skill** as an alternative approach:
-
-🔗 **[NotebookLM Claude Code Skill](https://github.com/PleasePrompto/notebooklm-skill)** - Python skill for Claude Code
-
-### When to use which approach?
-
-| Feature | This Project (MCP + HTTP) | Original Skill (Python) |
-|---------|---------------------------|-------------------------|
-| **Protocol** | MCP (Model Context Protocol) | Claude Skills |
-| **Installation** | `claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp` | Clone to `~/.claude/skills/` |
-| **Sessions** | ✅ Persistent browser sessions | Fresh browser per query |
-| **Compatibility** | ✅ Claude Code, Cursor, Codex, any MCP client | Claude Code only |
-| **HTTP API** | ✅ Works with n8n, Zapier, Make.com | ❌ Not available |
-| **Language** | TypeScript | Python |
-| **Use case** | Long conversations, automation workflows | Quick one-off queries |
-
-### Which one should you choose?
-
-- **Use this MCP project** if you want:
-  - Persistent sessions (faster repeated queries)
-  - Compatibility with multiple tools (Cursor, Codex, etc.)
-  - HTTP REST API for n8n/Zapier automation
-  - TypeScript-based development
-
-- **Use the original Skill** if you prefer:
-  - Python-based workflow
-  - Simpler clone-and-use installation
-  - Stateless queries (no session management)
-  - Only using Claude Code locally
-
-Both use the same Patchright browser automation technology and provide zero-hallucination answers from NotebookLM.
-
----
-
-## Real-World Example
-
-### Building an n8n Workflow Without Hallucinations
-
-**Challenge**: n8n's API is new — Claude hallucinates node names and functions.
-
-**Solution**:
-1. Downloaded complete n8n documentation → merged into manageable chunks
-2. Uploaded to NotebookLM
-3. Told Claude: *"Build me a Gmail spam filter workflow. Use this NotebookLM: [link]"*
-
-**Watch the AI-to-AI conversation:**
-
-```
-Claude → "How does Gmail integration work in n8n?"
-NotebookLM → "Use Gmail Trigger with polling, or Gmail node with Get Many..."
-
-Claude → "How to decode base64 email body?"
-NotebookLM → "Body is base64url encoded in payload.parts, use Function node..."
-
-Claude → "How to parse OpenAI response as JSON?"
-NotebookLM → "Set responseFormat to json, use {{ $json.spam }} in IF node..."
-
-Claude → "What about error handling if the API fails?"
-NotebookLM → "Use Error Trigger node with Continue On Fail enabled..."
-
-Claude → ✅ "Here's your complete workflow JSON..."
-```
-
-**Result**: Perfect workflow on first try. No debugging hallucinated APIs.
-
----
-
-## Core Features
-
-### **Zero Hallucinations**
-NotebookLM refuses to answer if information isn't in your docs. No invented APIs.
-
-### **Multi-Notebook Library**
-Manage multiple NotebookLM notebooks with automatic validation, duplicate detection, and smart selection.
-
-### **Autonomous Research**
-Claude asks follow-up questions automatically, building complete understanding before coding.
-
-### **Deep, Iterative Research**
-- Claude automatically asks follow-up questions to build complete understanding
-- Each answer triggers deeper questions until Claude has all the details
-- Example: For n8n workflow, Claude asked multiple sequential questions about Gmail integration, error handling, and data transformation
-
-### **HTTP REST API**
-Use NotebookLM from n8n, Zapier, Make.com, or any HTTP client. No MCP required.
-
-### **Cross-Tool Sharing**
-Set up once, use everywhere. Claude Code, Codex, Cursor, n8n — all can access the same library.
-
----
-
-## Architecture
-
-```mermaid
-graph LR
-    A[Your Task] --> B[Claude/n8n/HTTP Client]
-    B --> C[MCP/HTTP Server]
-    C --> D[Chrome Automation]
-    D --> E[NotebookLM]
-    E --> F[Gemini 2.5]
-    F --> G[Your Docs]
-    G --> F
-    F --> E
-    E --> D
-    D --> C
-    C --> B
-    B --> H[Accurate Output]
-```
-
----
-
-## Common Commands (MCP Mode)
-
-| Intent | Say | Result |
-|--------|-----|--------|
-| Authenticate | *"Open NotebookLM auth setup"* or *"Log me in to NotebookLM"* | Chrome opens for login |
-| Add notebook | *"Add [link] to library"* | Saves notebook with metadata |
-| List notebooks | *"Show our notebooks"* | Lists all saved notebooks |
-| Research first | *"Research this in NotebookLM before coding"* | Multi-question session |
-| Select notebook | *"Use the React notebook"* | Sets active notebook |
-| Update notebook | *"Update notebook tags"* | Modify metadata |
-| Remove notebook | *"Remove [notebook] from library"* | Deletes from library |
-| View browser | *"Show me the browser"* | Watch live NotebookLM chat |
-| Fix auth | *"Repair NotebookLM authentication"* | Clears and re-authenticates |
-| Switch account | *"Re-authenticate with different Google account"* | Changes account |
-| Clean restart | *"Run NotebookLM cleanup"* | Removes all data for fresh start |
-
----
-
-## Comparison to Alternatives
-
-### vs. Downloading docs locally
-- **You**: Download docs → Claude: "search through these files"
-- **Problem**: Claude reads thousands of files → massive token usage, often misses connections
-- **NotebookLM**: Pre-indexed by Gemini, semantic understanding across all docs
-
-### vs. Web search
-- **You**: "Research X online"
-- **Problem**: Outdated info, hallucinated examples, unreliable sources
-- **NotebookLM**: Only your trusted docs, always current, with citations
-
-### vs. Local RAG setup
-- **You**: Set up embeddings, vector DB, chunking strategy, retrieval pipeline
-- **Problem**: Hours of setup, tuning retrieval, still gets "creative" with gaps
-- **NotebookLM**: Upload docs → done. Google handles everything.
-
----
-
-## FAQ
-
-**Is it really zero hallucinations?**
-Yes. NotebookLM is specifically designed to only answer from uploaded sources. If it doesn't know, it says so.
-
-**What about rate limits?**
-Free tier has daily query limits per Google account. Quick account switching supported for continued research.
-
-**How secure is this?**
-Chrome runs locally. Your credentials never leave your machine. Use a dedicated Google account if concerned.
-
-**Can I see what's happening?**
-Yes! Say *"Show me the browser"* (MCP mode) or set `HEADLESS=false` (HTTP mode) to watch the live NotebookLM conversation.
-
-**What makes this better than Claude's built-in knowledge?**
-Your docs are always current. No training cutoff. No hallucinations. Perfect for new libraries, internal APIs, or fast-moving projects.
-
----
-
-## The Bottom Line
-
-**Without NotebookLM**: Write code → Find it's wrong → Debug hallucinated APIs → Repeat
-
-**With NotebookLM**: Research first → Write correct code → Ship faster
-
-Stop debugging hallucinations. Start shipping accurate code.
-
----
-
-## Disclaimer
-
-This tool automates browser interactions with NotebookLM to make your workflow more efficient. However, a few friendly reminders:
-
-**About browser automation:**
-While I've built in humanization features (realistic typing speeds, natural delays, mouse movements) to make the automation behave more naturally, I can't guarantee Google won't detect or flag automated usage. I recommend using a dedicated Google account for automation rather than your primary account—think of it like web scraping: probably fine, but better safe than sorry!
-
-**About CLI tools and AI agents:**
-CLI tools like Claude Code, Codex, and similar AI-powered assistants are incredibly powerful, but they can make mistakes. Please use them with care and awareness:
-- Always review changes before committing or deploying
-- Test in safe environments first
-- Keep backups of important work
-- Remember: AI agents are assistants, not infallible oracles
-
-I built this tool for myself because I was tired of the copy-paste dance between NotebookLM and my editor. I'm sharing it in the hope it helps others too, but I can't take responsibility for any issues, data loss, or account problems that might occur. Use at your own discretion and judgment.
-
-That said, if you run into problems or have questions, feel free to open an issue on GitHub. I'm happy to help troubleshoot!
-
----
-
-## Roadmap
-
-### ✅ Implemented in v1.3.2
-
-**🤖 Auto-Discovery: Autonomous Resource Discovery**
-- ✅ Automatically generate notebook name, description, and tags via NotebookLM
-- ✅ Progressive disclosure pattern inspired by Claude Skills best practices
-- ✅ Zero-friction notebook addition (30 seconds vs 5 minutes)
-- ✅ Validation of auto-generated metadata (kebab-case, description length, tags count)
-- ✅ Orchestrators discover relevant documentation autonomously
-
-**👉 See [Auto-Discovery Documentation](./deployment/docs/07-AUTO-DISCOVERY.md) for details**
-
-### 🔜 Planned for v1.4.0+
-
-**🔥 Separate Chrome Profiles by Mode (Priority):**
-- Enable HTTP and MCP stdio modes to run simultaneously
-- Automatic profile detection: `chrome_profile_http` vs `chrome_profile_stdio`
-- No user configuration needed - just works
-- Solves Chrome profile locking issue for dual-mode users
-- **👉 See [Chrome Profile Limitation](./docs/CHROME_PROFILE_LIMITATION.md) for details**
-
-**Smart Metadata Refresh:**
-- Auto-detect when notebook content has changed
-- Re-query NotebookLM to update metadata
-- Endpoint: `PATCH /notebooks/:id/refresh`
-
-**Semantic Matching:**
-- Use embeddings for advanced notebook matching beyond tags
-- Endpoint: `GET /notebooks/match?query=gmail&semantic=true`
-
-**Usage Analytics:**
-- Track which notebooks are queried together
-- Suggest related notebooks based on usage patterns
-- Endpoint: `GET /notebooks/:id/related`
-
-### 🚀 Previously Implemented
-
-**✅ PM2 Daemon Mode (v1.1.2):**
-- Cross-platform process manager with auto-restart
-- Commands: `npm run daemon:start`, `daemon:logs`, `daemon:status`
-- Built-in log rotation and monitoring
-
-**✅ Multi-Notebook Library (v1.1.2):**
-- Live validation of notebooks
-- Duplicate detection
-- Smart notebook selection
-
-### 💡 Have an idea?
-[Open a discussion](https://github.com/roomi-fields/notebooklm-mcp/discussions) to suggest new features!
-
----
-
-## Contributing
-
-Found a bug? Have a feature idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
-
-## License
-
-MIT — Use freely in your projects.
-
-See [LICENSE](./LICENSE) for 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)
+
+**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
+
+<!-- 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 -->
+
+[MCP Installation](#mcp-installation) • [HTTP REST API](#http-rest-api) • [Why NotebookLM](#why-notebooklm-not-local-rag) • [Examples](#real-world-example) • [Documentation](./deployment/docs/)
+
+</div>
+
+---
+
+> **⚠️ Current Limitation (v1.3.2):** HTTP and MCP stdio modes cannot run simultaneously due to Chrome profile locking. Choose one mode at a time, or see [Chrome Profile Limitation](./docs/CHROME_PROFILE_LIMITATION.md) for details. This will be fixed in v1.4.0 with automatic profile separation.
+
+---
+
+## 🚀 Two Ways to Use This Server
+
+### 1️⃣ **HTTP REST API** (New! Recommended for n8n, Zapier, Make.com)
+
+Use NotebookLM from **any tool** via HTTP REST API:
+
+**Option A: Install from npm**
+
+```bash
+# Install globally
+npm install -g @roomi-fields/notebooklm-mcp
+
+# For MCP stdio mode (Claude Code, Cursor)
+notebooklm-mcp
+
+# For HTTP server mode
+# Note: Currently requires cloning the repo for HTTP mode
+# See Option B below
+```
+
+**Option B: Install from source (Required for HTTP mode)**
+
+```bash
+# Clone and install
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install
+npm run build
+npm run start:http
+```
+
+**Query the API:**
+
+```bash
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
+```
+
+**Perfect for:**
+
+- ✅ n8n workflows and automation
+- ✅ Zapier, Make.com integrations
+- ✅ Custom web applications
+- ✅ Backend APIs
+
+**👉 Full HTTP setup guide:** [deployment/docs/01-INSTALL.md](./deployment/docs/01-INSTALL.md)
+
+---
+
+### 2️⃣ **MCP stdio** (For Claude Code, Cursor, Codex)
+
+Use NotebookLM directly from your AI coding assistant:
+
+```bash
+# Claude Code
+claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+
+# Codex
+codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+
+# Cursor (add to ~/.cursor/mcp.json)
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+
+**Perfect for:**
+
+- ✅ Claude Code, Cursor, Codex
+- ✅ Any MCP-compatible AI assistant
+- ✅ Direct CLI integration
+
+---
+
+## The Problem
+
+When you tell Claude Code or Cursor to "search through my local documentation", here's what happens:
+
+- **Massive token consumption**: Searching through documentation means reading multiple files repeatedly
+- **Inaccurate retrieval**: Searches for keywords, misses context and connections between docs
+- **Hallucinations**: When it can't find something, it invents plausible-sounding APIs
+- **Expensive & slow**: Each question requires re-reading multiple files
+
+## The Solution
+
+Let your tools chat directly with [**NotebookLM**](https://notebooklm.google/) — Google's **zero-hallucination knowledge base** powered by Gemini 2.5 that provides intelligent, synthesized answers from your docs.
+
+```
+Your Task → Agent/n8n asks NotebookLM → Gemini synthesizes answer → Correct output
+```
+
+**The real advantage**: No more manual copy-paste. Your agent/workflow asks NotebookLM directly and gets answers back. Build deep understanding through automatic follow-ups.
+
+---
+
+## Why NotebookLM, Not Local RAG?
+
+| Approach                | Token Cost                         | Setup Time                   | Hallucinations                | Answer Quality     |
+| ----------------------- | ---------------------------------- | ---------------------------- | ----------------------------- | ------------------ |
+| **Feed docs to Claude** | 🔴 Very high (multiple file reads) | Instant                      | Yes - fills gaps              | Variable retrieval |
+| **Web search**          | 🟡 Medium                          | Instant                      | High - unreliable sources     | Hit or miss        |
+| **Local RAG**           | 🟡 Medium-High                     | Hours (embeddings, chunking) | Medium - retrieval gaps       | Depends on setup   |
+| **NotebookLM MCP**      | 🟢 Minimal                         | 5 minutes                    | **Zero** - refuses if unknown | Expert synthesis   |
+
+### What Makes NotebookLM Superior?
+
+1. **Pre-processed by Gemini**: Upload docs once, get instant expert knowledge
+2. **Natural language Q&A**: Not just retrieval — actual understanding and synthesis
+3. **Multi-source correlation**: Connects information across 50+ documents
+4. **Citation-backed**: Every answer includes source references
+5. **No infrastructure**: No vector DBs, embeddings, or chunking strategies needed
+
+---
+
+## HTTP REST API
+
+### Quick Start
+
+```powershell
+# 1. Clone and install
+git clone <repo-url> D:\notebooklm-http
+cd D:\notebooklm-http
+npm install
+npm run build
+
+# 2. Configure authentication (one-time)
+npm run setup-auth
+# Chrome opens → log in with Google → close Chrome
+
+# 3. Start the server
+
+# Option A: Foreground mode (terminal stays open)
+npm run start:http
+
+# Option B: Background daemon mode (recommended for production)
+npm run daemon:start    # Start in background
+npm run daemon:logs     # View logs
+npm run daemon:status   # Check status
+npm run daemon:stop     # Stop server
+
+# 4. Add your first notebook (in another terminal if using Option A)
+curl -X POST http://localhost:3000/notebooks \
+  -H "Content-Type: application/json" \
+  -d '{
+    "url": "https://notebooklm.google.com/notebook/YOUR-NOTEBOOK-ID",
+    "name": "My Knowledge Base",
+    "description": "My documentation",
+    "topics": ["docs", "api"]
+  }'
+
+# 5. Query NotebookLM
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X"}'
+
+# 6. Validate installation (optional)
+.\deployment\scripts\test-server.ps1
+```
+
+**👉 See [Testing Guide](./deployment/scripts/README.md) for automated test suite**
+
+### API Endpoints
+
+| Method   | Endpoint                   | Description                         |
+| -------- | -------------------------- | ----------------------------------- |
+| `GET`    | `/health`                  | Check server health                 |
+| `POST`   | `/ask`                     | Ask a question to NotebookLM        |
+| `GET`    | `/notebooks`               | List all notebooks                  |
+| `POST`   | `/notebooks`               | Add notebook (with live validation) |
+| `POST`   | `/notebooks/auto-discover` | Auto-generate notebook metadata     |
+| `DELETE` | `/notebooks/:id`           | Remove a notebook                   |
+| `PUT`    | `/notebooks/:id/activate`  | Set active notebook                 |
+| `GET`    | `/sessions`                | List active sessions                |
+| `DELETE` | `/sessions/:id`            | Close a session                     |
+
+**👉 Full API documentation:** [deployment/docs/03-API.md](./deployment/docs/03-API.md)
+
+### n8n Integration
+
+Perfect for n8n workflows:
+
+```json
+{
+  "nodes": [
+    {
+      "name": "Ask NotebookLM",
+      "type": "n8n-nodes-base.httpRequest",
+      "parameters": {
+        "method": "POST",
+        "url": "http://your-server:3000/ask",
+        "jsonParameters": true,
+        "bodyParametersJson": {
+          "question": "{{ $json.query }}",
+          "notebook_id": "my-notebook"
+        }
+      }
+    }
+  ]
+}
+```
+
+**👉 n8n guide:** [deployment/docs/04-N8N-INTEGRATION.md](./deployment/docs/04-N8N-INTEGRATION.md)
+
+---
+
+## 🔍 Auto-Discovery : Self-Organizing Documentation
+
+Autonomous resource discovery enables AI orchestrators to find and use relevant documentation without manual intervention.
+
+### How it works
+
+**1. Add notebook** (zero manual metadata):
+
+```bash
+curl -X POST http://localhost:3000/notebooks/auto-discover \
+  -H "Content-Type: application/json" \
+  -d '{"url": "https://notebooklm.google.com/notebook/YOUR_ID"}'
+```
+
+**2. System queries NotebookLM** to auto-generate:
+
+- Kebab-case name (3 words max)
+- Concise description (2 sentences)
+- Relevant tags (8-10 keywords)
+
+**3. Orchestrators discover autonomously**:
+
+- Claude Code finds relevant docs without prompting
+- n8n workflows auto-select documentation
+- Cursor matches context to notebooks
+
+### Progressive disclosure pattern
+
+Inspired by [Claude Skills best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices#progressive-disclosure-patterns):
+
+- **Level 0** (startup): Lightweight metadata loaded (~500 tokens)
+- **Level 1** (matching): Local tag/description search (0 NotebookLM queries)
+- **Level 2** (deep query): Targeted NotebookLM query only when needed
+
+### Why this matters
+
+**Before**: Manual library management, orchestrators can't discover resources autonomously
+
+**After**: Self-organizing library, autonomous documentation discovery
+
+Perfect for:
+
+- ✅ Teams with 10+ documentation notebooks
+- ✅ n8n workflows needing dynamic doc access
+- ✅ Claude Code autonomous research
+- ✅ Onboarding new developers without manual setup
+
+### Example workflow
+
+```bash
+# 1. Add documentation notebooks (auto-discover metadata)
+curl -X POST /notebooks/auto-discover -d '{"url": "https://notebooklm.google.com/notebook/n8n-docs"}'
+curl -X POST /notebooks/auto-discover -d '{"url": "https://notebooklm.google.com/notebook/react-guide"}'
+
+# 2. Claude Code autonomously discovers relevant notebook
+User: "Build Gmail automation with n8n"
+→ System matches: "n8n-docs" (tags: ["n8n", "gmail", "automation"])
+→ Query NotebookLM: "Gmail node configuration?"
+→ Claude implements with accurate info
+
+# 3. Zero hallucinations, zero manual intervention
+```
+
+---
+
+### Background Daemon Mode
+
+Run the HTTP server as a background process without keeping a terminal window open:
+
+```bash
+# Start server in background
+npm run daemon:start
+
+# View real-time logs
+npm run daemon:logs
+
+# Check server status
+npm run daemon:status
+
+# Restart server
+npm run daemon:restart
+
+# Stop server
+npm run daemon:stop
+
+# Remove from PM2 process list
+npm run daemon:delete
+```
+
+**Features:**
+
+- ✅ Runs in background without terminal window
+- ✅ Auto-restart on crash
+- ✅ Centralized log management (logs/pm2-\*.log)
+- ✅ Memory limit protection (1GB max)
+- ✅ Production-ready process management
+
+**Configuration:** Edit `ecosystem.config.cjs` to customize PM2 behavior (env vars, restart policy, etc.)
+
+### Installation & Documentation
+
+- 📖 [**Installation Guide**](./deployment/docs/01-INSTALL.md) — Step-by-step setup
+- 🔧 [**Configuration**](./deployment/docs/02-CONFIGURATION.md) — Environment variables, security
+- 📡 [**API Reference**](./deployment/docs/03-API.md) — Complete endpoint documentation
+- 📚 [**Notebook Library**](./deployment/docs/06-NOTEBOOK-LIBRARY.md) — Multi-notebook management
+- ✅ [**Testing Suite**](./deployment/scripts/README.md) — Automated validation scripts
+- 🐛 [**Troubleshooting**](./deployment/docs/05-TROUBLESHOOTING.md) — Common issues
+
+---
+
+## MCP Installation
+
+<details>
+<summary>Claude Code</summary>
+
+```bash
+claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+```
+
+</details>
+
+<details>
+<summary>Codex</summary>
+
+```bash
+codex mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+```
+
+</details>
+
+<details>
+<summary>Gemini</summary>
+
+```bash
+gemini mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+```
+
+</details>
+
+<details>
+<summary>Cursor</summary>
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>amp</summary>
+
+```bash
+amp mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+```
+
+</details>
+
+<details>
+<summary>VS Code</summary>
+
+```bash
+code --add-mcp '{"name":"notebooklm","command":"npx","args":["@roomi-fields/notebooklm-mcp@latest"]}'
+```
+
+</details>
+
+<details>
+<summary>Other MCP clients</summary>
+
+**Generic MCP config:**
+
+```json
+{
+  "mcpServers": {
+    "notebooklm": {
+      "command": "npx",
+      "args": ["@roomi-fields/notebooklm-mcp@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+### MCP Quick Start
+
+1. **Install** the MCP server (see above)
+
+2. **Authenticate** (one-time)
+
+Say in your chat (Claude/Codex):
+
+```
+"Log me in to NotebookLM"
+```
+
+_A Chrome window opens → log in with Google_
+
+3. **Create your knowledge base**
+
+Go to [notebooklm.google.com](https://notebooklm.google.com) → Create notebook → Upload your docs:
+
+- 📄 PDFs, Google Docs, markdown files
+- 🔗 Websites, GitHub repos
+- 🎥 YouTube videos
+- 📚 Multiple sources per notebook
+
+Share: **⚙️ Share → Anyone with link → Copy**
+
+4. **Let Claude use it**
+
+```
+"I'm building with [library]. Here's my NotebookLM: [link]"
+```
+
+**That's it.** Claude now asks NotebookLM whatever it needs, building expertise before writing code.
+
+---
+
+## Related Project: Claude Code Skill (by original author)
+
+The original author [PleasePrompto](https://github.com/PleasePrompto) also created a **Python-based Claude Code Skill** as an alternative approach:
+
+🔗 **[NotebookLM Claude Code Skill](https://github.com/PleasePrompto/notebooklm-skill)** - Python skill for Claude Code
+
+### When to use which approach?
+
+| Feature           | This Project (MCP + HTTP)                                    | Original Skill (Python)      |
+| ----------------- | ------------------------------------------------------------ | ---------------------------- |
+| **Protocol**      | MCP (Model Context Protocol)                                 | Claude Skills                |
+| **Installation**  | `claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp` | Clone to `~/.claude/skills/` |
+| **Sessions**      | ✅ Persistent browser sessions                               | Fresh browser per query      |
+| **Compatibility** | ✅ Claude Code, Cursor, Codex, any MCP client                | Claude Code only             |
+| **HTTP API**      | ✅ Works with n8n, Zapier, Make.com                          | ❌ Not available             |
+| **Language**      | TypeScript                                                   | Python                       |
+| **Use case**      | Long conversations, automation workflows                     | Quick one-off queries        |
+
+### Which one should you choose?
+
+- **Use this MCP project** if you want:
+  - Persistent sessions (faster repeated queries)
+  - Compatibility with multiple tools (Cursor, Codex, etc.)
+  - HTTP REST API for n8n/Zapier automation
+  - TypeScript-based development
+
+- **Use the original Skill** if you prefer:
+  - Python-based workflow
+  - Simpler clone-and-use installation
+  - Stateless queries (no session management)
+  - Only using Claude Code locally
+
+Both use the same Patchright browser automation technology and provide zero-hallucination answers from NotebookLM.
+
+---
+
+## Real-World Example
+
+### Building an n8n Workflow Without Hallucinations
+
+**Challenge**: n8n's API is new — Claude hallucinates node names and functions.
+
+**Solution**:
+
+1. Downloaded complete n8n documentation → merged into manageable chunks
+2. Uploaded to NotebookLM
+3. Told Claude: _"Build me a Gmail spam filter workflow. Use this NotebookLM: [link]"_
+
+**Watch the AI-to-AI conversation:**
+
+```
+Claude → "How does Gmail integration work in n8n?"
+NotebookLM → "Use Gmail Trigger with polling, or Gmail node with Get Many..."
+
+Claude → "How to decode base64 email body?"
+NotebookLM → "Body is base64url encoded in payload.parts, use Function node..."
+
+Claude → "How to parse OpenAI response as JSON?"
+NotebookLM → "Set responseFormat to json, use {{ $json.spam }} in IF node..."
+
+Claude → "What about error handling if the API fails?"
+NotebookLM → "Use Error Trigger node with Continue On Fail enabled..."
+
+Claude → ✅ "Here's your complete workflow JSON..."
+```
+
+**Result**: Perfect workflow on first try. No debugging hallucinated APIs.
+
+---
+
+## Core Features
+
+### **Zero Hallucinations**
+
+NotebookLM refuses to answer if information isn't in your docs. No invented APIs.
+
+### **Multi-Notebook Library**
+
+Manage multiple NotebookLM notebooks with automatic validation, duplicate detection, and smart selection.
+
+### **Autonomous Research**
+
+Claude asks follow-up questions automatically, building complete understanding before coding.
+
+### **Deep, Iterative Research**
+
+- Claude automatically asks follow-up questions to build complete understanding
+- Each answer triggers deeper questions until Claude has all the details
+- Example: For n8n workflow, Claude asked multiple sequential questions about Gmail integration, error handling, and data transformation
+
+### **HTTP REST API**
+
+Use NotebookLM from n8n, Zapier, Make.com, or any HTTP client. No MCP required.
+
+### **Cross-Tool Sharing**
+
+Set up once, use everywhere. Claude Code, Codex, Cursor, n8n — all can access the same library.
+
+---
+
+## Architecture
+
+```mermaid
+graph LR
+    A[Your Task] --> B[Claude/n8n/HTTP Client]
+    B --> C[MCP/HTTP Server]
+    C --> D[Chrome Automation]
+    D --> E[NotebookLM]
+    E --> F[Gemini 2.5]
+    F --> G[Your Docs]
+    G --> F
+    F --> E
+    E --> D
+    D --> C
+    C --> B
+    B --> H[Accurate Output]
+```
+
+---
+
+## Common Commands (MCP Mode)
+
+| Intent          | Say                                                           | Result                           |
+| --------------- | ------------------------------------------------------------- | -------------------------------- |
+| Authenticate    | _"Open NotebookLM auth setup"_ or _"Log me in to NotebookLM"_ | Chrome opens for login           |
+| Add notebook    | _"Add [link] to library"_                                     | Saves notebook with metadata     |
+| List notebooks  | _"Show our notebooks"_                                        | Lists all saved notebooks        |
+| Research first  | _"Research this in NotebookLM before coding"_                 | Multi-question session           |
+| Select notebook | _"Use the React notebook"_                                    | Sets active notebook             |
+| Update notebook | _"Update notebook tags"_                                      | Modify metadata                  |
+| Remove notebook | _"Remove [notebook] from library"_                            | Deletes from library             |
+| View browser    | _"Show me the browser"_                                       | Watch live NotebookLM chat       |
+| Fix auth        | _"Repair NotebookLM authentication"_                          | Clears and re-authenticates      |
+| Switch account  | _"Re-authenticate with different Google account"_             | Changes account                  |
+| Clean restart   | _"Run NotebookLM cleanup"_                                    | Removes all data for fresh start |
+
+---
+
+## Comparison to Alternatives
+
+### vs. Downloading docs locally
+
+- **You**: Download docs → Claude: "search through these files"
+- **Problem**: Claude reads thousands of files → massive token usage, often misses connections
+- **NotebookLM**: Pre-indexed by Gemini, semantic understanding across all docs
+
+### vs. Web search
+
+- **You**: "Research X online"
+- **Problem**: Outdated info, hallucinated examples, unreliable sources
+- **NotebookLM**: Only your trusted docs, always current, with citations
+
+### vs. Local RAG setup
+
+- **You**: Set up embeddings, vector DB, chunking strategy, retrieval pipeline
+- **Problem**: Hours of setup, tuning retrieval, still gets "creative" with gaps
+- **NotebookLM**: Upload docs → done. Google handles everything.
+
+---
+
+## FAQ
+
+**Is it really zero hallucinations?**
+Yes. NotebookLM is specifically designed to only answer from uploaded sources. If it doesn't know, it says so.
+
+**What about rate limits?**
+Free tier has daily query limits per Google account. Quick account switching supported for continued research.
+
+**How secure is this?**
+Chrome runs locally. Your credentials never leave your machine. Use a dedicated Google account if concerned.
+
+**Can I see what's happening?**
+Yes! Say _"Show me the browser"_ (MCP mode) or set `HEADLESS=false` (HTTP mode) to watch the live NotebookLM conversation.
+
+**What makes this better than Claude's built-in knowledge?**
+Your docs are always current. No training cutoff. No hallucinations. Perfect for new libraries, internal APIs, or fast-moving projects.
+
+---
+
+## The Bottom Line
+
+**Without NotebookLM**: Write code → Find it's wrong → Debug hallucinated APIs → Repeat
+
+**With NotebookLM**: Research first → Write correct code → Ship faster
+
+Stop debugging hallucinations. Start shipping accurate code.
+
+---
+
+## Disclaimer
+
+This tool automates browser interactions with NotebookLM to make your workflow more efficient. However, a few friendly reminders:
+
+**About browser automation:**
+While I've built in humanization features (realistic typing speeds, natural delays, mouse movements) to make the automation behave more naturally, I can't guarantee Google won't detect or flag automated usage. I recommend using a dedicated Google account for automation rather than your primary account—think of it like web scraping: probably fine, but better safe than sorry!
+
+**About CLI tools and AI agents:**
+CLI tools like Claude Code, Codex, and similar AI-powered assistants are incredibly powerful, but they can make mistakes. Please use them with care and awareness:
+
+- Always review changes before committing or deploying
+- Test in safe environments first
+- Keep backups of important work
+- Remember: AI agents are assistants, not infallible oracles
+
+I built this tool for myself because I was tired of the copy-paste dance between NotebookLM and my editor. I'm sharing it in the hope it helps others too, but I can't take responsibility for any issues, data loss, or account problems that might occur. Use at your own discretion and judgment.
+
+That said, if you run into problems or have questions, feel free to open an issue on GitHub. I'm happy to help troubleshoot!
+
+---
+
+## Roadmap
+
+### ✅ Implemented in v1.3.2
+
+**🤖 Auto-Discovery: Autonomous Resource Discovery**
+
+- ✅ Automatically generate notebook name, description, and tags via NotebookLM
+- ✅ Progressive disclosure pattern inspired by Claude Skills best practices
+- ✅ Zero-friction notebook addition (30 seconds vs 5 minutes)
+- ✅ Validation of auto-generated metadata (kebab-case, description length, tags count)
+- ✅ Orchestrators discover relevant documentation autonomously
+
+**👉 See [Auto-Discovery Documentation](./deployment/docs/07-AUTO-DISCOVERY.md) for details**
+
+### 🔧 Minor Fixes (v1.3.5)
+
+**Cosmetic improvements:**
+
+- Fix PowerShell `CursorPosition` error in test scripts (non-interactive terminal)
+- Add strict type validation for `show_browser` parameter (return 400 on invalid types)
+
+### 🔜 Planned for v1.4.0+
+
+**🔥 Separate Chrome Profiles by Mode (Priority):**
+
+- Enable HTTP and MCP stdio modes to run simultaneously
+- Automatic profile detection: `chrome_profile_http` vs `chrome_profile_stdio`
+- No user configuration needed - just works
+- Solves Chrome profile locking issue for dual-mode users
+- **👉 See [Chrome Profile Limitation](./docs/CHROME_PROFILE_LIMITATION.md) for details**
+
+**Smart Metadata Refresh:**
+
+- Auto-detect when notebook content has changed
+- Re-query NotebookLM to update metadata
+- Endpoint: `PATCH /notebooks/:id/refresh`
+
+**Semantic Matching:**
+
+- Use embeddings for advanced notebook matching beyond tags
+- Endpoint: `GET /notebooks/match?query=gmail&semantic=true`
+
+**Usage Analytics:**
+
+- Track which notebooks are queried together
+- Suggest related notebooks based on usage patterns
+- Endpoint: `GET /notebooks/:id/related`
+
+### 🚀 Previously Implemented
+
+**✅ PM2 Daemon Mode (v1.1.2):**
+
+- Cross-platform process manager with auto-restart
+- Commands: `npm run daemon:start`, `daemon:logs`, `daemon:status`
+- Built-in log rotation and monitoring
+
+**✅ Multi-Notebook Library (v1.1.2):**
+
+- Live validation of notebooks
+- Duplicate detection
+- Smart notebook selection
+
+### 💡 Have an idea?
+
+[Open a discussion](https://github.com/roomi-fields/notebooklm-mcp/discussions) to suggest new features!
+
+---
+
+## Contributing
+
+Found a bug? Have a feature idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.
+
+## License
+
+MIT — Use freely in your projects.
+
+See [LICENSE](./LICENSE) for 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>