@pan-sec/notebooklm-mcp 2026.1.8 → 2026.1.9

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 (3) hide show
  1. package/README.md +101 -10
  2. package/package.json +1 -1
  3. package/server.json +2 -2
package/README.md CHANGED
@@ -27,18 +27,29 @@
27
27
  >
28
28
  > Security-hardened fork of [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp) • Maintained by [Pantheon Security](https://pantheonsecurity.io)
29
29
 
30
+ ### ⚡ TL;DR — What You Get
31
+
32
+ - 🔍 **Query your NotebookLM notebooks** — source-grounded, zero-hallucination answers
33
+ - 📚 **Create & manage notebooks programmatically** — no manual clicking
34
+ - 🎙️ **Generate audio overviews** — podcast-style summaries of your docs
35
+ - 🔬 **Gemini Deep Research** — comprehensive multi-source research (optional API)
36
+ - 📄 **Document API** — upload & query PDFs without browser (optional API)
37
+ - 🔐 **14 security layers** — post-quantum encryption, audit logs, secrets scanning
38
+ - ✅ **Enterprise compliance** — GDPR, SOC2, CSSF ready
39
+ - 💡 **No API key required** — core features work with just browser auth
40
+
30
41
  ---
31
42
 
32
43
  ## 🚀 What's New in 2026
33
44
 
34
- **v2026.1.1** brings powerful new capabilities:
45
+ **Latest: v2026.1.8** — Updated dependencies, post-quantum crypto improvements
35
46
 
36
- | Feature | Description |
37
- |---------|-------------|
38
- | 🔍 **Deep Health Check** | Verifies NotebookLM chat UI actually loads — catches stale sessions |
39
- | 📊 **Chat History Extraction** | Recover conversations from browser, with pagination & file export |
40
- | 🎯 **Context Management** | Preview mode, offset pagination, output to file — never overflow context |
41
- | 📅 **CalVer Versioning** | Modern `2026.MINOR.PATCH` format for predictable releases |
47
+ | Version | Highlights |
48
+ |---------|------------|
49
+ | **v2026.1.8** | Major dependency updates (zod 4.x, dotenv 17.x, post-quantum 0.5.4) |
50
+ | **v2026.1.7** | MCP Protocol UX: tool icons, human-friendly titles, behavior annotations |
51
+ | **v2026.1.4** | Defense-in-depth path validation, security hardening |
52
+ | **v2026.1.1** | Deep health checks, chat history extraction, context management |
42
53
 
43
54
  ```bash
44
55
  # Quick install
@@ -58,6 +69,66 @@ claude mcp add notebooklm -- npx @pan-sec/notebooklm-mcp@latest
58
69
  | Chat history extraction | ❌ | ✅ **NEW** |
59
70
  | Deep health verification | ❌ | ✅ **NEW** |
60
71
 
72
+ <details>
73
+ <summary><b>📋 Full Feature List (43 Tools)</b></summary>
74
+
75
+ #### Core NotebookLM (No API Key Required)
76
+ | Tool | Description |
77
+ |------|-------------|
78
+ | `ask_question` | Query notebooks with source-grounded answers |
79
+ | `add_notebook` | Add a notebook to your library |
80
+ | `list_notebooks` | List all notebooks in library |
81
+ | `select_notebook` | Set active notebook |
82
+ | `update_notebook` | Update notebook metadata |
83
+ | `remove_notebook` | Remove from library |
84
+ | `create_notebook` | Programmatically create new notebooks |
85
+ | `batch_create_notebooks` | Create multiple notebooks at once |
86
+ | `sync_library` | Sync library with NotebookLM |
87
+ | `list_sources` | List sources in a notebook |
88
+ | `add_source` | Add source to notebook |
89
+ | `remove_source` | Remove source from notebook |
90
+ | `generate_audio_overview` | Create podcast-style audio |
91
+ | `get_audio_status` | Check audio generation status |
92
+ | `download_audio` | Download generated audio |
93
+ | `list_sessions` | List active sessions |
94
+ | `close_session` | Close a session |
95
+ | `reset_session` | Reset session history |
96
+ | `get_health` | Check server & auth status |
97
+ | `setup_auth` | Initial authentication |
98
+ | `re_auth` | Re-authenticate |
99
+ | `cleanup_data` | Clean up local data |
100
+ | `get_quota` | Check usage quotas |
101
+ | `set_quota_tier` | Set quota tier |
102
+ | `get_query_history` | View past queries |
103
+ | `get_notebook_chat_history` | Extract browser chat history |
104
+ | `get_project_info` | Get project context |
105
+ | `export_library` | Export library backup |
106
+
107
+ #### Gemini API (Optional - Requires GEMINI_API_KEY)
108
+ | Tool | Description |
109
+ |------|-------------|
110
+ | `deep_research` | Comprehensive research agent |
111
+ | `gemini_query` | Fast grounded queries |
112
+ | `get_research_status` | Check research progress |
113
+ | `upload_document` | Upload docs to Gemini |
114
+ | `query_document` | Query uploaded documents |
115
+ | `query_chunked_document` | Query large documents |
116
+ | `list_documents` | List uploaded documents |
117
+ | `delete_document` | Delete uploaded document |
118
+
119
+ #### Webhooks & Integrations
120
+ | Tool | Description |
121
+ |------|-------------|
122
+ | `configure_webhook` | Set up webhook notifications |
123
+ | `list_webhooks` | List configured webhooks |
124
+ | `test_webhook` | Test webhook delivery |
125
+ | `remove_webhook` | Remove a webhook |
126
+
127
+ #### Enterprise Compliance (16 additional tools)
128
+ See [Compliance Documentation](./docs/COMPLIANCE-SPEC.md) for full list.
129
+
130
+ </details>
131
+
61
132
  ---
62
133
 
63
134
  ## Gemini Deep Research (v1.8.0)
@@ -119,7 +190,7 @@ Run deep research in the background and check progress:
119
190
  │ │
120
191
  │ ┌────────────────────────────────┐ ┌──────────────────────────────────┐ │
121
192
  │ │ BROWSER AUTOMATION │ │ GEMINI API │ │
122
- │ │ (Your Documents) │ │ (Research & Documents) │ │
193
+ │ │ ✅ NO API KEY NEEDED │ │ ⚡ OPTIONAL - needs API key │ │
123
194
  │ ├────────────────────────────────┤ ├──────────────────────────────────┤ │
124
195
  │ │ │ │ │ │
125
196
  │ │ QUERY │ │ RESEARCH │ │
@@ -147,10 +218,12 @@ Run deep research in the background and check progress:
147
218
  └──────────────────────────────────────────────────────────────────────────────┘
148
219
  ```
149
220
 
150
- ### Gemini Configuration
221
+ > **💡 Gemini API is completely optional!** All core NotebookLM features (ask_question, notebooks, sessions, audio) work via browser automation with **no API key required**. The Gemini tools below are bonus features for users who want direct API access.
222
+
223
+ ### Gemini Configuration (Optional)
151
224
 
152
225
  ```bash
153
- # Required for Gemini features
226
+ # Only required if you want Gemini API features (deep_research, gemini_query, upload_document)
154
227
  GEMINI_API_KEY=your-api-key # Get from https://aistudio.google.com/apikey
155
228
 
156
229
  # Optional settings
@@ -540,6 +613,24 @@ See [COMPLIANCE-SPEC.md](./docs/COMPLIANCE-SPEC.md) for full documentation.
540
613
 
541
614
  ## Installation
542
615
 
616
+ ### What Works Out of the Box (No API Key)
617
+
618
+ All core NotebookLM features work immediately with just browser authentication:
619
+
620
+ | Feature | Tool | Description |
621
+ |---------|------|-------------|
622
+ | 🔍 Query notebooks | `ask_question` | Get source-grounded answers from your documents |
623
+ | 📚 Manage library | `add_notebook`, `list_notebooks`, etc. | Organize your notebook collection |
624
+ | 🎙️ Audio overviews | `generate_audio_overview` | Create podcast-style summaries |
625
+ | 📝 Create notebooks | `create_notebook` | Programmatically create new notebooks |
626
+ | 🔄 Session management | `list_sessions`, `reset_session` | Manage conversation context |
627
+ | 📊 Chat history | `get_notebook_chat_history` | Extract past conversations |
628
+ | ❤️ Health checks | `get_health` | Verify authentication status |
629
+
630
+ **Optional:** Add `GEMINI_API_KEY` for bonus features like `deep_research`, `gemini_query`, and `upload_document`.
631
+
632
+ ---
633
+
543
634
  ### Claude Code
544
635
  ```bash
545
636
  claude mcp add notebooklm -- npx @pan-sec/notebooklm-mcp@latest
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pan-sec/notebooklm-mcp",
3
- "version": "2026.1.8",
3
+ "version": "2026.1.9",
4
4
  "mcpName": "io.github.Pantheon-Security/notebooklm-mcp-secure",
5
5
  "description": "Security-hardened MCP server for NotebookLM API with enterprise compliance (GDPR, SOC2, CSSF)",
6
6
  "type": "module",
package/server.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.Pantheon-Security/notebooklm-mcp-secure",
4
4
  "description": "Security-hardened NotebookLM MCP with post-quantum encryption",
5
- "version": "2026.1.8",
5
+ "version": "2026.1.9",
6
6
  "repository": {
7
7
  "url": "https://github.com/Pantheon-Security/notebooklm-mcp-secure",
8
8
  "source": "github"
@@ -11,7 +11,7 @@
11
11
  {
12
12
  "registryType": "npm",
13
13
  "identifier": "@pan-sec/notebooklm-mcp",
14
- "version": "2026.1.8",
14
+ "version": "2026.1.9",
15
15
  "transport": {
16
16
  "type": "stdio"
17
17
  }