@pan-sec/notebooklm-mcp 2026.1.8 → 2026.1.10
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.
- package/README.md +101 -10
- package/dist/tools/definitions/ask-question.d.ts.map +1 -1
- package/dist/tools/definitions/ask-question.js +12 -7
- package/dist/tools/definitions/ask-question.js.map +1 -1
- package/dist/tools/definitions/gemini.d.ts.map +1 -1
- package/dist/tools/definitions/gemini.js +22 -10
- package/dist/tools/definitions/gemini.js.map +1 -1
- package/package.json +1 -1
- 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.
|
|
45
|
+
**Latest: v2026.1.8** — Updated dependencies, post-quantum crypto improvements
|
|
35
46
|
|
|
36
|
-
|
|
|
37
|
-
|
|
38
|
-
|
|
|
39
|
-
|
|
|
40
|
-
|
|
|
41
|
-
|
|
|
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
|
-
│ │
|
|
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
|
-
|
|
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
|
-
#
|
|
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
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ask-question.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/ask-question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"ask-question.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/ask-question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA4G5E;AAED,eAAO,MAAM,eAAe,EAAE,IA4G7B,CAAC"}
|
|
@@ -7,20 +7,23 @@ export function buildAskQuestionDescription(library) {
|
|
|
7
7
|
if (active) {
|
|
8
8
|
const topics = active.topics.join(", ");
|
|
9
9
|
const useCases = active.use_cases.map((uc) => ` - ${uc}`).join("\n");
|
|
10
|
-
return `#
|
|
10
|
+
return `# NotebookLM Research (Browser-Based • NO API KEY REQUIRED)
|
|
11
11
|
|
|
12
12
|
**Active Notebook:** ${active.name}
|
|
13
13
|
**Content:** ${active.description}
|
|
14
14
|
**Topics:** ${topics}
|
|
15
15
|
|
|
16
|
-
>
|
|
16
|
+
> **IMPORTANT:** This tool uses browser automation - NO GEMINI_API_KEY needed! Just requires browser authentication via setup_auth.
|
|
17
17
|
|
|
18
18
|
## What This Tool Is
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- Source-cited responses
|
|
19
|
+
- Query your NotebookLM notebooks via browser automation
|
|
20
|
+
- NO API key required - works with just browser authentication
|
|
21
|
+
- Source-cited responses grounded in YOUR uploaded documents
|
|
22
|
+
- Session-based: each follow-up uses prior context for deeper answers
|
|
22
23
|
|
|
23
24
|
## When To Use
|
|
25
|
+
- **PREFER THIS TOOL** for questions about your NotebookLM notebooks
|
|
26
|
+
- Use this instead of gemini_query when you have relevant notebooks
|
|
24
27
|
${useCases}
|
|
25
28
|
|
|
26
29
|
## Rules (Important)
|
|
@@ -91,7 +94,9 @@ ${bt}${bt}${bt}
|
|
|
91
94
|
- If ambiguous which notebook fits, ASK the user which to use`;
|
|
92
95
|
}
|
|
93
96
|
else {
|
|
94
|
-
return `#
|
|
97
|
+
return `# NotebookLM Research (Browser-Based • NO API KEY REQUIRED)
|
|
98
|
+
|
|
99
|
+
> **IMPORTANT:** This tool uses browser automation - NO GEMINI_API_KEY needed!
|
|
95
100
|
|
|
96
101
|
## No Active Notebook
|
|
97
102
|
- Visit https://notebooklm.google to create a notebook and get a share link
|
|
@@ -99,7 +104,7 @@ ${bt}${bt}${bt}
|
|
|
99
104
|
- Use **list_notebooks** to show available sources
|
|
100
105
|
- Use **select_notebook** to set one active
|
|
101
106
|
|
|
102
|
-
> Auth tip: If login is required, use the prompt 'notebooklm.auth-setup' and then verify with the 'get_health' tool.
|
|
107
|
+
> Auth tip: If login is required, use the prompt 'notebooklm.auth-setup' and then verify with the 'get_health' tool.
|
|
103
108
|
|
|
104
109
|
Tip: Tell the user you can manage NotebookLM library and ask which notebook to use for the current task.`;
|
|
105
110
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ask-question.js","sourceRoot":"","sources":["../../../src/tools/definitions/ask-question.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAwB;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,mDAAmD;IAEnE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtE,OAAO;;uBAEY,MAAM,CAAC,IAAI;eACnB,MAAM,CAAC,WAAW;cACnB,MAAM
|
|
1
|
+
{"version":3,"file":"ask-question.js","sourceRoot":"","sources":["../../../src/tools/definitions/ask-question.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/gemini.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;
|
|
1
|
+
{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/tools/definitions/gemini.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA2W/D;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,IAAI,EAY7B,CAAC"}
|
|
@@ -11,20 +11,25 @@ const deepResearchTool = {
|
|
|
11
11
|
name: "deep_research",
|
|
12
12
|
description: `Perform deep research using Gemini's Deep Research agent.
|
|
13
13
|
|
|
14
|
+
> **⚠️ REQUIRES GEMINI_API_KEY** - Do NOT use this tool unless GEMINI_API_KEY is configured. For notebook queries, use ask_question instead (no API key needed).
|
|
15
|
+
|
|
14
16
|
This runs in the background and can take 1-5 minutes to complete.
|
|
15
17
|
|
|
16
18
|
## When to Use
|
|
17
|
-
-
|
|
19
|
+
- ONLY when GEMINI_API_KEY is configured
|
|
20
|
+
- You need comprehensive research on a topic NOT in your notebooks
|
|
18
21
|
- No specific NotebookLM notebook is relevant
|
|
19
|
-
|
|
22
|
+
|
|
23
|
+
## When NOT to Use
|
|
24
|
+
- **Use ask_question instead** for queries about your NotebookLM notebooks (no API key needed)
|
|
25
|
+
- If GEMINI_API_KEY is not set, this tool will fail
|
|
20
26
|
|
|
21
27
|
## Requirements
|
|
22
|
-
- GEMINI_API_KEY environment variable
|
|
28
|
+
- GEMINI_API_KEY environment variable MUST be set
|
|
23
29
|
|
|
24
30
|
## Notes
|
|
25
31
|
- Deep Research is a premium feature that may incur costs
|
|
26
|
-
- Results are grounded in web sources with citations
|
|
27
|
-
- For notebook-specific queries, use ask_question instead`,
|
|
32
|
+
- Results are grounded in web sources with citations`,
|
|
28
33
|
inputSchema: {
|
|
29
34
|
type: "object",
|
|
30
35
|
properties: {
|
|
@@ -53,19 +58,24 @@ const geminiQueryTool = {
|
|
|
53
58
|
name: "gemini_query",
|
|
54
59
|
description: `Quick query to Gemini model with optional grounding tools.
|
|
55
60
|
|
|
56
|
-
|
|
61
|
+
> **⚠️ REQUIRES GEMINI_API_KEY** - Do NOT use this tool unless GEMINI_API_KEY is configured. For notebook queries, use ask_question instead (no API key needed).
|
|
62
|
+
|
|
63
|
+
Supports:
|
|
57
64
|
- Google Search grounding for current information
|
|
58
65
|
- Code execution for calculations
|
|
59
66
|
- URL analysis for web content
|
|
60
67
|
|
|
61
68
|
## Requirements
|
|
62
|
-
- GEMINI_API_KEY environment variable
|
|
69
|
+
- GEMINI_API_KEY environment variable MUST be set
|
|
63
70
|
|
|
64
|
-
## When to Use
|
|
65
|
-
- Quick factual questions
|
|
71
|
+
## When to Use (ONLY if API key is configured)
|
|
72
|
+
- Quick factual questions NOT in your notebooks
|
|
66
73
|
- Current events (with google_search tool)
|
|
67
74
|
- Code calculations (with code_execution tool)
|
|
68
|
-
- Web page analysis (with url_context tool)
|
|
75
|
+
- Web page analysis (with url_context tool)
|
|
76
|
+
|
|
77
|
+
## When NOT to Use
|
|
78
|
+
- **Use ask_question instead** for queries about your NotebookLM notebooks (no API key needed)`,
|
|
69
79
|
inputSchema: {
|
|
70
80
|
type: "object",
|
|
71
81
|
properties: {
|
|
@@ -134,6 +144,8 @@ const uploadDocumentTool = {
|
|
|
134
144
|
name: "upload_document",
|
|
135
145
|
description: `Upload a document (PDF, text, etc.) to Gemini for querying.
|
|
136
146
|
|
|
147
|
+
> **⚠️ REQUIRES GEMINI_API_KEY** - For adding documents to NotebookLM notebooks (no API key), use create_notebook or add_source instead.
|
|
148
|
+
|
|
137
149
|
## What This Does
|
|
138
150
|
- Uploads a local file to Gemini's Files API
|
|
139
151
|
- File is retained for 48 hours
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/tools/definitions/gemini.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,gBAAgB,GAAS;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/tools/definitions/gemini.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pan-sec/notebooklm-mcp",
|
|
3
|
-
"version": "2026.1.
|
|
3
|
+
"version": "2026.1.10",
|
|
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.
|
|
5
|
+
"version": "2026.1.10",
|
|
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.
|
|
14
|
+
"version": "2026.1.10",
|
|
15
15
|
"transport": {
|
|
16
16
|
"type": "stdio"
|
|
17
17
|
}
|