@roomi-fields/notebooklm-mcp 1.3.5 → 1.5.0

package/README.md

@@ -4,7 +4,7 @@
 
 > **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
 
-**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
+**Full automation of Google NotebookLM: Q&A, audio podcasts, and source management**
 
 <!-- Badges -->
 
@@ -14,744 +14,179 @@
 
 <!-- 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:**
+## Features
 
-- ✅ Claude Code, Cursor, Codex
-- ✅ Any MCP-compatible AI assistant
-- ✅ Direct CLI integration
+### 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
 
-## The Problem
+### Content Generation
 
-When you tell Claude Code or Cursor to "search through my local documentation", here's what happens:
+Generate multiple content types from your notebook sources:
 
-- **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
+| 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                  |
 
-## The Solution
+**Video Visual Styles**: classroom, documentary, animated, corporate, cinematic, minimalist
 
-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.
+### Content Download
 
-```
-Your Task → Agent/n8n asks NotebookLM → Gemini synthesizes answer → Correct output
-```
+- **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
 
-**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.
+### Source Management
 
----
+- **Add sources**: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive
+- **List sources**: View all sources in a notebook
 
-## Why NotebookLM, Not Local RAG?
+### Notebook Library
 
-| 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   |
+- **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
 
-### What Makes NotebookLM Superior?
+### Integration Options
 
-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
+- **MCP Protocol** — Claude Code, Cursor, Codex, any MCP client
+- **HTTP REST API** — n8n, Zapier, Make.com, custom integrations
 
 ---
 
-## 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
+## Quick Start
 
-# Option A: Foreground mode (terminal stays open)
-npm run start:http
+> ⚠️ **npm registry temporarily unavailable** - Install from GitHub instead (see below)
 
-# 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):
+### Option 1: MCP Mode (Claude Code, Cursor, Codex)
 
 ```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>
+# Clone and build locally
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install && npm run build
 
-Add to `~/.cursor/mcp.json`:
+# Claude Code
+claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js
 
-```json
+# Cursor - add to ~/.cursor/mcp.json
 {
   "mcpServers": {
     "notebooklm": {
-      "command": "npx",
-      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+      "command": "node",
+      "args": ["/path/to/notebooklm-mcp/dist/index.js"]
     }
   }
 }
 ```
 
-</details>
+Then say: _"Log me in to NotebookLM"_ → Chrome opens → log in with Google.
 
-<details>
-<summary>amp</summary>
+### Option 2: HTTP REST API (n8n, Zapier, Make.com)
 
 ```bash
-amp mcp add notebooklm -- npx @roomi-fields/notebooklm-mcp@latest
+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
 ```
 
-</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]"
+# Query the API
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
 ```
 
-**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..."
-```
+## Documentation
 
-**Result**: Perfect workflow on first try. No debugging hallucinated APIs.
+| 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+)       |
 
 ---
 
-## 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
+## Roadmap
 
-### **HTTP REST API**
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
 
-Use NotebookLM from n8n, Zapier, Make.com, or any HTTP client. No MCP required.
+**Latest releases:**
 
-### **Cross-Tool Sharing**
+- **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)
 
-Set up once, use everywhere. Claude Code, Codex, Cursor, n8n — all can access the same library.
+**Not yet implemented:**
 
----
-
-## 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]
-```
+- Discover sources (Web/Drive search with Fast/Deep modes)
+- Edit notes (create, delete, and convert are implemented)
 
 ---
 
-## 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
+## Disclaimer
 
-### vs. Local RAG setup
+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.
 
-- **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.
+See full [Disclaimer](#disclaimer-details) below.
 
 ---
 
-## 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.
+## Contributing
 
-**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.
+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.
 
-## The Bottom Line
+## License
 
-**Without NotebookLM**: Write code → Find it's wrong → Debug hallucinated APIs → Repeat
+MIT — Use freely in your projects. See [LICENSE](./LICENSE).
 
-**With NotebookLM**: Research first → Write correct code → Ship faster
+## Author
 
-Stop debugging hallucinations. Start shipping accurate code.
+**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)
 
 ---
 
-## Disclaimer
-
-This tool automates browser interactions with NotebookLM to make your workflow more efficient. However, a few friendly reminders:
+<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) 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!
+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 incredibly powerful, but they can make mistakes. Please use them with care and awareness:
+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
-- Remember: AI agents are assistants, not infallible oracles
+- 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.
+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.
 
-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.
+</details>
 
 ---