@m4ykeldev/notebooklm-mcp 0.1.24 β†’ 0.1.26

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 (8) hide show
  1. package/README.md +76 -64
  2. package/dist/auth-IUSHPUET.js +28 -0
  3. package/dist/auth-IUSHPUET.js.map +1 -0
  4. package/dist/chunk-HXFXWC7Y.js +450 -0
  5. package/dist/chunk-HXFXWC7Y.js.map +1 -0
  6. package/dist/cli.js +246 -507
  7. package/dist/cli.js.map +1 -1
  8. package/package.json +6 -3
package/README.md CHANGED
@@ -1,63 +1,56 @@
1
1
  # 🧠 NotebookLM MCP Server
2
2
 
3
- ### Unlock the Power of Google NotebookLM Directly in Your AI Workflow
3
+ ### Bridge the Gap Between Google NotebookLM and Your AI Workspace
4
4
 
5
5
  [![NPM Version](https://img.shields.io/npm/v/@m4ykeldev/notebooklm-mcp)](https://www.npmjs.com/package/@m4ykeldev/notebooklm-mcp)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+ [![Build Status](https://github.com/m4yk3ldev/notebooklm-mcp/actions/workflows/publish.yml/badge.svg)](https://github.com/m4yk3ldev/notebooklm-mcp/actions)
7
8
 
8
- Stop switching tabs. Stop manual copy-pasting. **NotebookLM MCP** brings the full potential of [Google NotebookLM](https://notebooklm.google.com) to your terminal, IDE, and AI assistants (Claude, Cursor, VS Code).
9
+ Stop jumping between browser tabs. **NotebookLM MCP** brings the full analytical power of [Google NotebookLM](https://notebooklm.google.com) directly into your local terminal, IDE, and AI assistants like Claude, Cursor, and VS Code.
9
10
 
10
- With **32+ specialized tools**, you can now automate notebook management, source ingestion, deep research, and studio-quality content generationβ€”all without leaving your development environment.
11
+ Manage notebooks, ingest diverse sources, trigger deep research, and generate studio-quality contentβ€”all via a single, standardized Model Context Protocol (MCP) interface.
11
12
 
12
13
  ---
13
14
 
14
- ## ✨ Features that Empower You
15
+ ## πŸ”₯ Key Capabilities
15
16
 
16
- - πŸš€ **Smart Authentication**: Zero-friction login with automated cookie extraction.
17
- - πŸ”„ **Invisible Refresh**: Background session restoration keeps you connected without interruptions.
18
- - πŸ“š **Total Notebook Control**: Create, list, rename, and analyze notebooks programmatically.
19
- - 🌐 **Seamless Ingestion**: Add URLs, YouTube videos, Google Drive docs, or raw text as sources.
20
- - πŸ”¬ **Automated Research**: Trigger Deep Research tasks and import discovered insights instantly.
21
- - 🎨 **Studio Content**: Generate Audio Overviews, infographics, slide decks, and briefing docs on the fly.
17
+ - ⚑ **Seamless Authentication**: Log in once with `notebooklm-mcp auth`. Our automated CDP-based flow handles secure cookie extraction so you can focus on your data.
18
+ - πŸ”„ **Resilient Connectivity**: Built-in background session restoration. If your session expires, the server transparently reconnects without breaking your workflow.
19
+ - πŸ“‚ **Universal Ingestion**: Instantly add URLs, YouTube transcripts, Google Drive files, or raw text snippets to any notebook.
20
+ - πŸ•΅οΈ **Autonomous Research**: Harness Google's Deep Research engine. Start a task, poll its progress, and import structured insights directly into your project.
21
+ - 🎭 **Creative Studio**: Programmatically generate Audio Overviews (podcasts), Briefing Docs, Infographics, Slide Decks, and Quizzes from your sources.
22
22
 
23
23
  ---
24
24
 
25
- ## ⚑ Quick Start
25
+ ## πŸš€ Quick Start
26
26
 
27
- ### 1. Install & Run
27
+ ### 1. Installation
28
28
 
29
+ Run it instantly with `npx`:
29
30
  ```bash
30
31
  npx -y @m4ykeldev/notebooklm-mcp serve
31
32
  ```
32
33
 
33
- Or install globally:
34
-
34
+ Or install globally for better performance:
35
35
  ```bash
36
36
  npm install -g @m4ykeldev/notebooklm-mcp
37
- notebooklm-mcp serve
38
37
  ```
39
38
 
40
- ### 2. Smart Authentication (Zero Friction)
39
+ ### 2. The "One-Click" Login
41
40
 
42
- Authenticating is now a "magical" experience. No more manual cookie hunting.
41
+ Say goodbye to manual cookie hunting. Our smart auth flow does the heavy lifting for you.
43
42
 
44
43
  ```bash
45
44
  notebooklm-mcp auth
46
45
  ```
47
-
48
- - **How it works**: A dedicated, secure Chrome profile opens.
49
- - **Persistence**: Log in once, and the session is saved.
50
- - **Automation**: The server automatically detects your session and synchronizes cookies.
51
- - **Reliability**: If your session expires, the server **effortlessly restores it** in the background.
52
-
53
- *Prefer the old way? Use `notebooklm-mcp auth --manual` for traditional copy-paste extraction.*
46
+ *A secure Chrome window will open. Simply log into your Google account, and we'll handle the rest. Your session is stored locally and securely.*
54
47
 
55
48
  ---
56
49
 
57
- ## πŸ€– Integrate with Your Favorite Tools
50
+ ## πŸ€– AI Assistant Integration
58
51
 
59
52
  ### Claude Desktop / Claude Code
60
- Add this to your `mcpServers` configuration:
53
+ Add the following to your `mcpServers` configuration:
61
54
 
62
55
  ```json
63
56
  {
@@ -70,68 +63,87 @@ Add this to your `mcpServers` configuration:
70
63
  }
71
64
  ```
72
65
 
73
- ### Cursor / VS Code
74
- 1. Open **MCP Settings**.
66
+ ### Cursor / VS Code (Composer)
67
+ 1. Navigate to **MCP Settings**.
75
68
  2. Add a new server named `NotebookLM`.
76
- 3. Set type to `command` and use: `npx -y @m4ykeldev/notebooklm-mcp serve`.
69
+ 3. Set type to `command` and enter: `npx -y @m4ykeldev/notebooklm-mcp serve`.
77
70
 
78
71
  ---
79
72
 
80
- ## πŸ›  Available Tools (32)
73
+ ## πŸ›  Complete Tool Reference (32)
81
74
 
82
- ### πŸ“” Notebooks
75
+ Every tool is designed to work seamlessly within your AI's context window.
76
+
77
+ ### πŸ“” Notebook Management
83
78
  | Tool | Description |
84
79
  | :--- | :--- |
85
- | `notebook_list` | Overview of all your notebooks. |
86
- | `notebook_create` | Start a new project instantly. |
87
- | `notebook_get` | Dive deep into a specific notebook's metadata. |
88
- | `notebook_describe` | Get an AI-generated summary of your entire notebook. |
89
-
90
- ### πŸ“„ Sources
80
+ | `notebook_list` | Get an overview of all your notebooks, including titles, source counts, and ownership metadata. |
81
+ | `notebook_create` | Create a new NotebookLM project instantly from your terminal or AI assistant. |
82
+ | `notebook_get` | Retrieve deep metadata and a full list of sources for a specific notebook. |
83
+ | `notebook_describe` | Get a high-level, AI-generated summary of everything inside a notebook. |
84
+ | `notebook_rename` | Update the title of an existing notebook. |
85
+ | `notebook_delete` | Permanently remove a notebook (requires explicit confirmation). |
86
+
87
+ ### πŸ“„ Source Ingestion & Management
91
88
  | Tool | Description |
92
89
  | :--- | :--- |
93
- | `notebook_add_url` | Ingest web pages or YouTube transcripts. |
94
- | `notebook_add_drive` | Connect your Google Drive documents. |
95
- | `source_describe` | Instant AI analysis and keywords for any source. |
96
- | `source_get_content` | Extract raw text for downstream processing. |
97
-
98
- ### πŸ§ͺ Research & Query
90
+ | `notebook_add_url` | Add any website or YouTube video as a source. Transcripts are automatically handled. |
91
+ | `notebook_add_text` | Ingest raw text snippets or local file contents directly into your project. |
92
+ | `notebook_add_drive` | Connect and import documents, sheets, or slides from your Google Drive. |
93
+ | `source_describe` | Get detailed AI analysis, summaries, and key topics for any individual source. |
94
+ | `source_get_content` | Extract the full underlying text of a source for processing by other AI tools. |
95
+ | `source_list_drive` | List all Drive-based sources and check if they are up-to-date with the original files. |
96
+ | `source_sync_drive` | Sync selected Google Drive sources to pull the latest changes into NotebookLM. |
97
+ | `source_delete` | Remove a specific source from your notebook. |
98
+
99
+ ### πŸ”¬ Research & Deep Analysis
99
100
  | Tool | Description |
100
101
  | :--- | :--- |
101
- | `research_start` | Launch Web or Drive research tasks (Fast or Deep). |
102
- | `notebook_query` | Ask complex questions grounded in your sources. |
103
- | `research_import` | Bring research findings directly into your notebook. |
102
+ | `research_start` | Launch an autonomous research task using Google's engine (Web or Drive sources). |
103
+ | `research_status` | Track the progress of active research tasks and view discovered insights. |
104
+ | `research_import` | Instantly import the findings of a research task as new sources in your notebook. |
105
+ | `notebook_query` | Ask complex, grounded questions. Answers are cited directly from your sources. |
106
+ | `chat_configure` | Fine-tune your AI's behavior by setting specific goals or preferred response lengths. |
104
107
 
105
- ### 🎬 Studio (Content Generation)
108
+ ### 🎬 Studio (AI Content Generation)
106
109
  | Tool | Description |
107
110
  | :--- | :--- |
108
- | `audio_overview_create` | Turn sources into a professional podcast. |
109
- | `report_create` | Generate Briefing Docs, Study Guides, or Blog Posts. |
110
- | `slide_deck_create` | Create presenter-ready slides from your data. |
111
- | `infographic_create` | Visualize information automatically. |
111
+ | `audio_overview_create` | Transform your notebook's sources into a professional, podcast-style audio discussion. |
112
+ | `video_overview_create` | Generate a structured video explainer based on your project data. |
113
+ | `report_create` | Create professional Briefing Docs, Study Guides, or Blog Posts tailored to your sources. |
114
+ | `slide_deck_create` | Turn your research into a presenter-ready slide deck automatically. |
115
+ | `infographic_create` | Visualize complex data and relationships with an AI-generated infographic. |
116
+ | `flashcards_create` | Generate interactive study flashcards to master your notebook's content. |
117
+ | `quiz_create` | Create a comprehensive quiz to test knowledge grounded in your provided sources. |
118
+ | `data_table_create` | Extract and organize information into a structured, downloadable data table. |
119
+ | `mind_map_create` | Build a visual mind map connecting the core concepts of your notebook. |
120
+ | `studio_status` | Check the generation status of your Studio artifacts and get download links. |
121
+ | `studio_delete` | Clean up your workspace by deleting old Studio artifacts. |
122
+
123
+ ### πŸ”‘ Authentication Helpers
124
+ | Tool | Description |
125
+ | :--- | :--- |
126
+ | `refresh_auth` | Manually trigger a session refresh if you encounter connection issues. |
127
+ | `save_auth_tokens` | Manually save cookie data (legacy fallback method). |
112
128
 
113
129
  ---
114
130
 
115
- ## βš™οΈ Advanced Usage
131
+ ## πŸ’‘ Pro Tips
116
132
 
117
- ```bash
118
- # Set a custom query timeout
119
- notebooklm-mcp serve --query-timeout 60000
120
-
121
- # Manage authentication tokens
122
- notebooklm-mcp auth --show-tokens
123
- ```
133
+ - **Custom Timeouts**: Working with massive sources? Increase the timeout:
134
+ `notebooklm-mcp serve --query-timeout 120000`
135
+ - **Check Connections**: Use `auth --show-tokens` to verify your session validity.
124
136
 
125
137
  ---
126
138
 
127
- ## πŸ›‘ Disclaimer & Security
139
+ ## πŸ›‘ Security & Privacy
128
140
 
129
- - **Security First**: Your cookies are stored locally at `~/.notebooklm-mcp/auth.json` and never shared.
130
- - **Unofficial**: This project is not affiliated with Google. It utilizes internal RPC endpoints (`batchexecute`) and is subject to changes in NotebookLM's web API.
141
+ - **Local Storage**: Your authentication data is stored exclusively on your machine at `~/.notebooklm-mcp/auth.json`. It is never transmitted to any third-party server except Google.
142
+ - **Unofficial Tool**: This project is an independent community effort and is not affiliated with Google. It interfaces with internal endpoints and may be affected by changes to the NotebookLM web platform.
131
143
 
132
144
  ## πŸ“„ License
133
145
 
134
- Distributed under the [MIT License](LICENSE).
146
+ Open-source and available under the [MIT License](LICENSE).
135
147
 
136
148
  ---
137
- Built with ❀️ for the AI developer community using the [Model Context Protocol](https://modelcontextprotocol.io).
149
+ Crafted with precision for the AI-first developer. Part of the [Model Context Protocol](https://modelcontextprotocol.io) ecosystem.
package/dist/auth-IUSHPUET.js ADDED
@@ -0,0 +1,28 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ buildCookieHeader,
4
+ extractCsrfFromPage,
5
+ extractSessionIdFromPage,
6
+ loadTokens,
7
+ loadTokensFromCache,
8
+ loadTokensFromEnv,
9
+ runAuthFlow,
10
+ runFileImport,
11
+ saveTokens,
12
+ showTokens,
13
+ validateCookies
14
+ } from "./chunk-HXFXWC7Y.js";
15
+ export {
16
+ buildCookieHeader,
17
+ extractCsrfFromPage,
18
+ extractSessionIdFromPage,
19
+ loadTokens,
20
+ loadTokensFromCache,
21
+ loadTokensFromEnv,
22
+ runAuthFlow,
23
+ runFileImport,
24
+ saveTokens,
25
+ showTokens,
26
+ validateCookies
27
+ };
28
+ //# sourceMappingURL=auth-IUSHPUET.js.map
package/dist/auth-IUSHPUET.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}