@m4ykeldev/notebooklm-mcp 0.1.1 → 0.1.19

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 (5) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +89 -43
  3. package/dist/cli.js +489 -554
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +32 -14
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 m4ykeldev
3
+ Copyright (c) 2026 m4yk3ldev
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -35,9 +35,15 @@ Tokens are cached at `~/.notebooklm-mcp/auth.json`.
35
35
  export NOTEBOOKLM_COOKIES="SID=xxx; HSID=xxx; SSID=xxx; APISID=xxx; SAPISID=xxx"
36
36
  ```
37
37
 
38
- ### 3. Add to Your MCP Client
38
+ ## Usage Examples
39
39
 
40
- **Claude Code:**
40
+ Integrate NotebookLM directly into your AI development workflow.
41
+
42
+ ### 🤖 AI Editors & IDEs
43
+
44
+ #### **Claude Desktop / Claude Code**
45
+
46
+ Add this to your `claude_desktop_config.json` or MCP configuration:
41
47
 
42
48
  ```json
43
49
  {
@@ -50,70 +56,110 @@ export NOTEBOOKLM_COOKIES="SID=xxx; HSID=xxx; SSID=xxx; APISID=xxx; SAPISID=xxx"
50
56
  }
51
57
  ```
52
58
 
53
- **Cursor / other MCP clients:** use the same command configuration.
59
+ #### **Cursor**
60
+
61
+ 1. Go to **Settings** > **Features** > **MCP**.
62
+ 2. Click **+ Add New MCP Server**.
63
+ 3. **Name**: `NotebookLM`
64
+ 4. **Type**: `command`
65
+ 5. **Command**: `npx -y @m4ykeldev/notebooklm-mcp serve`
66
+
67
+ #### **VS Code (MCP Client)**
68
+
69
+ If you use the [MCP Client](https://marketplace.visualstudio.com/items?itemName=mcp-client.mcp-client) extension:
70
+
71
+ 1. Open your `settings.json`.
72
+ 2. Add the server configuration:
73
+
74
+ ```json
75
+ "mcp.servers": {
76
+ "notebooklm": {
77
+ "command": "npx",
78
+ "args": ["-y", "@m4ykeldev/notebooklm-mcp", "serve"]
79
+ }
80
+ }
81
+ ```
82
+
83
+ ### 💻 Command Line Interface
84
+
85
+ Once authenticated, you can use the CLI for quick operations:
86
+
87
+ ```bash
88
+ # Start the server with a custom timeout
89
+ npx @m4ykeldev/notebooklm-mcp serve --query-timeout 60000
90
+
91
+ # Manage authentication
92
+ npx @m4ykeldev/notebooklm-mcp auth --show-tokens
93
+ ```
54
94
 
55
95
  ## Tools (32)
56
96
 
57
97
  ### Notebooks
58
98
 
59
- | Tool | Description |
60
- |------|-------------|
61
- | `notebook_list` | List all notebooks with metadata |
62
- | `notebook_create` | Create a new notebook |
63
- | `notebook_get` | Get details of a specific notebook |
99
+ | Tool | Description |
100
+ | ------------------- | ----------------------------------------- |
101
+ | `notebook_list` | List all notebooks with metadata |
102
+ | `notebook_create` | Create a new notebook |
103
+ | `notebook_get` | Get details of a specific notebook |
64
104
  | `notebook_describe` | AI-generated summary of notebook contents |
65
- | `notebook_rename` | Rename a notebook |
66
- | `notebook_delete` | Delete a notebook (requires confirmation) |
105
+ | `notebook_rename` | Rename a notebook |
106
+ | `notebook_delete` | Delete a notebook (requires confirmation) |
67
107
 
68
108
  ### Sources
69
109
 
70
- | Tool | Description |
71
- |------|-------------|
72
- | `notebook_add_url` | Add a URL or YouTube video as a source |
73
- | `notebook_add_text` | Add pasted text as a source |
74
- | `notebook_add_drive` | Add a Google Drive document as a source |
75
- | `source_describe` | AI summary and keywords for a source |
76
- | `source_get_content` | Raw text content of a source |
77
- | `source_list_drive` | List sources with Drive freshness status |
78
- | `source_sync_drive` | Sync stale Drive sources (requires confirmation) |
79
- | `source_delete` | Delete a source (requires confirmation) |
110
+ | Tool | Description |
111
+ | -------------------- | ------------------------------------------------ |
112
+ | `notebook_add_url` | Add a URL or YouTube video as a source |
113
+ | `notebook_add_text` | Add pasted text as a source |
114
+ | `notebook_add_drive` | Add a Google Drive document as a source |
115
+ | `source_describe` | AI summary and keywords for a source |
116
+ | `source_get_content` | Raw text content of a source |
117
+ | `source_list_drive` | List sources with Drive freshness status |
118
+ | `source_sync_drive` | Sync stale Drive sources (requires confirmation) |
119
+ | `source_delete` | Delete a source (requires confirmation) |
80
120
 
81
121
  ### Query & Chat
82
122
 
83
- | Tool | Description |
84
- |------|-------------|
123
+ | Tool | Description |
124
+ | ---------------- | ------------------------------------ |
85
125
  | `notebook_query` | Ask questions about notebook sources |
86
- | `chat_configure` | Set chat goal and response length |
126
+ | `chat_configure` | Set chat goal and response length |
87
127
 
88
128
  ### Research
89
129
 
90
- | Tool | Description |
91
- |------|-------------|
92
- | `research_start` | Start a web or Drive research task |
93
- | `research_status` | Check research task progress |
130
+ | Tool | Description |
131
+ | ----------------- | --------------------------------------- |
132
+ | `research_start` | Start a web or Drive research task |
133
+ | `research_status` | Check research task progress |
94
134
  | `research_import` | Import discovered sources from research |
95
135
 
96
136
  ### Studio — Content Generation
97
137
 
98
- | Tool | Description |
99
- |------|-------------|
100
- | `audio_overview_create` | Generate an audio podcast |
101
- | `video_overview_create` | Generate a video summary |
102
- | `infographic_create` | Generate an infographic |
103
- | `slide_deck_create` | Generate a slide presentation |
104
- | `report_create` | Generate a report (briefing, study guide, blog post) |
105
- | `flashcards_create` | Generate study flashcards |
106
- | `quiz_create` | Generate a quiz |
107
- | `data_table_create` | Generate a data table |
108
- | `mind_map_create` | Generate and save a mind map |
109
- | `studio_status` | Check generation status and download URLs |
110
- | `studio_delete` | Delete a studio artifact (requires confirmation) |
138
+ | Tool | Description |
139
+ | ----------------------- | ---------------------------------------------------- |
140
+ | `audio_overview_create` | Generate an audio podcast |
141
+ | `video_overview_create` | Generate a video summary |
142
+ | `infographic_create` | Generate an infographic |
143
+ | `slide_deck_create` | Generate a slide presentation |
144
+ | `report_create` | Generate a report (briefing, study guide, blog post) |
145
+ | `flashcards_create` | Generate study flashcards |
146
+ | `quiz_create` | Generate a quiz |
147
+ | `data_table_create` | Generate a data table |
148
+ | `mind_map_create` | Generate and save a mind map |
149
+ | `studio_status` | Check generation status and download URLs |
150
+ | `studio_delete` | Delete a studio artifact (requires confirmation) |
151
+
152
+ ### Authentication
153
+
154
+ | Tool | Description |
155
+ | -------------- | -------------------------------------------------- |
156
+ | `refresh_auth` | Reload authentication tokens equires confirmation) |
111
157
 
112
158
  ### Authentication
113
159
 
114
- | Tool | Description |
115
- |------|-------------|
116
- | `refresh_auth` | Reload authentication tokens |
160
+ | Tool | Description |
161
+ | ------------------ | ------------------------------------ |
162
+ | `refresh_auth` | Reload authentication tokens |
117
163
  | `save_auth_tokens` | Manually save authentication cookies |
118
164
 
119
165
  ## CLI Reference