@roomi-fields/notebooklm-mcp 1.3.4 → 1.3.6

package/README.md

@@ -1,715 +1,164 @@
-<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 -->
+
+</div>
+
+---
+
+## Why NotebookLM?
+
+| Approach            | Token Cost  | Hallucinations                | Answer Quality       |
+| ------------------- | ----------- | ----------------------------- | -------------------- |
+| Feed docs to Claude | Very high   | Yes - fills gaps              | Variable             |
+| Web search          | Medium      | High - unreliable sources     | Hit or miss          |
+| Local RAG           | Medium-High | Medium - retrieval gaps       | Depends on setup     |
+| **NotebookLM MCP**  | **Minimal** | **Zero** - refuses if unknown | **Expert synthesis** |
+
+NotebookLM is pre-indexed by Gemini, provides citation-backed answers, and requires no infrastructure.
+
+---
+
+## Quick Start
+
+### Option 1: MCP Mode (Claude Code, Cursor, Codex)
+
+```bash
+# Claude Code
+claude 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"]
+    }
+  }
+}
+```
+
+Then say: _"Log me in to NotebookLM"_ → Chrome opens → log in with Google.
+
+### Option 2: HTTP REST API (n8n, Zapier, Make.com)
+
+```bash
+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
+```
+
+```bash
+# Query the API
+curl -X POST http://localhost:3000/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question": "Explain X", "notebook_id": "my-notebook"}'
+```
+
+---
+
+## Documentation
+
+| 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            |
+| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | HTTP/MCP simultaneous mode issue          |
+
+---
+
+## Core Features
+
+- **Zero Hallucinations** — NotebookLM refuses to answer if info isn't in your docs
+- **Multi-Notebook Library** — Manage multiple notebooks with validation and smart selection
+- **Auto-Discovery** — Automatically generate metadata via NotebookLM queries
+- **HTTP REST API** — Use from n8n, Zapier, Make.com, or any HTTP client
+- **Daemon Mode** — Run as background process with PM2 (`npm run daemon:start`)
+- **Cross-Tool** — Works with Claude Code, Cursor, Codex, and any MCP client
+
+---
+
+## Architecture
+
+```
+Your Task → Agent/n8n → MCP/HTTP Server → Chrome Automation → NotebookLM → Gemini 2.5 → Your Docs
+                                                                    ↓
+                                                            Accurate Output
+```
+
+---
+
+## Roadmap
+
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
+
+**Next up (v1.4.0):** Separate Chrome profiles to enable HTTP + MCP modes simultaneously.
+
+---
+
+## Disclaimer
+
+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.
+
+See full [Disclaimer](#disclaimer-details) below.
+
+---
+
+## Contributing
+
+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.
+
+## License
+
+MIT — Use freely in your projects. See [LICENSE](./LICENSE).
+
+---
+
+<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), 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 powerful but can make mistakes:
+
+- Always review changes before committing or deploying
+- Test in safe environments first
+- Keep backups of important work
+- AI agents are assistants, not infallible oracles
+
+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.
+
+</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>