npm - @roomi-fields/notebooklm-mcp - Versions diffs - 1.3.5 → 1.3.6 - Mend

@roomi-fields/notebooklm-mcp 1.3.5 → 1.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +62 -662
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -14,78 +14,32 @@
 <!-- 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)
+## Why NotebookLM?
-Use NotebookLM from **any tool** via HTTP REST API:
+| 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** |
-**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)
+NotebookLM is pre-indexed by Gemini, provides citation-backed answers, and requires no infrastructure.
 ---
-### 2️⃣ **MCP stdio** (For Claude Code, Cursor, Codex)
+## Quick Start
-Use NotebookLM directly from your AI coding assistant:
+### Option 1: MCP Mode (Claude Code, Cursor, Codex)
 ```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)
+# Cursor - add to ~/.cursor/mcp.json
 {
   "mcpServers": {
     "notebooklm": {
@@ -96,662 +50,108 @@ codex mcp add notebooklm -- npx @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
+Then say: _"Log me in to NotebookLM"_ → Chrome opens → log in with Google.
-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:
+### Option 2: HTTP REST API (n8n, Zapier, Make.com)
 ```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
+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:
+## Documentation
-🔗 **[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.
+| 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 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.
+- **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
-```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]
+```
+Your Task → Agent/n8n → MCP/HTTP Server → Chrome Automation → NotebookLM → Gemini 2.5 → Your Docs
+                                                                    ↓
+                                                            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
+## Roadmap
-### vs. Local RAG setup
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
-- **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.
+**Next up (v1.4.0):** Separate Chrome profiles to enable HTTP + MCP modes simultaneously.
 ---
-## 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.
+## Disclaimer
-**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.
+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.
-**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.
+See full [Disclaimer](#disclaimer-details) below.
 ---
-## The Bottom Line
+## Contributing
-**Without NotebookLM**: Write code → Find it's wrong → Debug hallucinated APIs → Repeat
+Found a bug? Have an idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!
-**With NotebookLM**: Research first → Write correct code → Ship faster
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
-Stop debugging hallucinations. Start shipping accurate code.
+## License
----
+MIT — Use freely in your projects. See [LICENSE](./LICENSE).
-## 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
-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!
+- AI agents are assistants, not infallible oracles
----
-## 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:**
+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.
-- 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>
 ---

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@roomi-fields/notebooklm-mcp",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "MCP server for NotebookLM API with HTTP REST API - Zero hallucinations from your notebooks",
   "type": "module",
   "bin": {