Registry / llm-agents / notebooklm-mcp-server

notebooklm-mcp-server

JSON →
library0.1.15jsnpmunverified

The `notebooklm-mcp-server` package, currently at version 3.0.7, provides a robust Node.js-based server that enables AI agents to interact directly with Google's NotebookLM. Built with TypeScript and leveraging the Model Context Protocol (MCP), this server allows AI agents to securely read, search, and manage NotebookLM notebooks as if they were local files. This direct integration is designed to provide grounded context to AI models, significantly reducing hallucinations. It supports both global installation via npm and zero-configuration execution via npx, making it highly accessible for integration into various AI-augmented workflows. The project maintains an active release cadence, featuring an auto-update mechanism that ensures the server always runs the latest version with critical fixes and enhancements upon startup. Its core differentiation lies in offering a dedicated, protocol-driven solution for real-time context retrieval directly from NotebookLM for AI applications.

npm install notebooklm-mcp-server
INSTALL
IMPORT
SIG · NOTEBOOKLM-MCP-SER
N
notebooklm-mcp-server
llm-agentsjavascriptv0.1.15
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

createServer
✓ import { createServer } from 'notebooklm-mcp-server';
✗ const { createServer } = require('notebooklm-mcp-server');
Primarily a CLI tool; `createServer` is for advanced programmatic integration. ESM is preferred for Node.js >=18.
MCPConfig
✓ import type { MCPConfig } from 'notebooklm-mcp-server';
✗ import { MCPConfig } from 'notebooklm-mcp-server';
Import `MCPConfig` as a type for configuration objects when using `createServer` programmatically.
CLI usage
✓ npx notebooklm-mcp-server <command>
✗ node node_modules/notebooklm-mcp-server/dist/cli.js <command>
The primary way to interact with the server is via the command-line interface using `npx` or a global installation. Direct programmatic import of the CLI entry point is not typical.

Demonstrates the essential steps to authenticate with Google NotebookLM and then start the MCP server using npx.

import { Console } from 'console'; import { exec } from 'child_process'; const logger = new Console({ stdout: process.stdout, stderr: process.stderr }); async function setupAndStartServer() { logger.log('1. Authenticating with Google NotebookLM...'); // This command will open a browser for Google login. // It's a one-time setup to establish a persistent session. // User needs to manually close the browser after successful login. const authProcess = exec('npx notebooklm-mcp-server auth'); authProcess.stdout?.on('data', (data) => logger.log(`Auth Output: ${data}`)); authProcess.stderr?.on('data', (data) => logger.error(`Auth Error: ${data}`)); await new Promise(resolve => { authProcess.on('exit', (code) => { if (code === 0) { logger.log('Authentication command finished. Please ensure you logged in via the browser and closed it.'); resolve(null); // Resolve to proceed even if auth browser is still open momentarily } else { logger.error(`Authentication failed with code ${code}. Please try again.`); process.exit(1); } }); }); logger.log('\n2. Starting the NotebookLM MCP Server...'); // This command starts the server process. // It will run until manually stopped (e.g., Ctrl+C in terminal where it's running). const serverProcess = exec('npx notebooklm-mcp-server start'); serverProcess.stdout?.on('data', (data) => logger.log(`Server Output: ${data}`)); serverProcess.stderr?.on('data', (data) => logger.error(`Server Error: ${data}`)); logger.log('Server started in background. Check terminal output for status.'); logger.log('To stop the server, you would typically kill the process running `npx notebooklm-mcp-server start`.'); logger.log('Or if running in foreground in a dedicated terminal, press Ctrl+C.'); } setupAndStartServer().catch(console.error);
Debug
Known issues
gotchaThe server includes an auto-update feature. Upon startup, it checks for new versions and installs them automatically. A manual restart is required to apply the updates and ensure you're running the latest version.
fix
After an auto-update notification, manually restart the server process to use the newly installed version.
affects: >=3.0.0
gotchaAuthentication sessions with Google NotebookLM can expire. If your AI agent encounters authentication errors, it's typically due to an expired session.
fix
Re-run the authentication command: `npx notebooklm-mcp-server auth`. A browser window will open for re-login. After successful login, close the browser.
affects: >=3.0.0
breakingThe package requires Node.js version 18.0.0 or higher. Running it on older Node.js versions will result in execution errors.
fix
Upgrade your Node.js installation to version 18.0.0 or newer. Use a version manager like `nvm` to easily switch Node.js versions (`nvm install 18 && nvm use 18`).
affects: >=3.0.0
Errors
Common errors & fixes
Error: Auth: Session expired or invalid. Please re-authenticate.
The cached Google authentication token has become invalid, often due to inactivity or a change in account security.
fix
Run `npx notebooklm-mcp-server auth` and follow the browser prompts to log in to your Google account again.
Error [ERR_REQUIRE_ESM]: require() of ES module .../notebooklm-mcp-server/dist/cli.js from ... not supported.
Attempting to use CommonJS `require()` syntax to load a module that is explicitly an ES Module.
fix
Ensure your project uses ES Modules (add `"type": "module"` to `package.json`) or use dynamic `import()` for ESM-only dependencies. The primary intended usage is via `npx`, which handles module resolution.
Upgrade
Version history
0.1.15latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
21 hits · last 30 days
node
18
OpenAI (training)
1
Resources
notebooklm-mcp-server — npm install notebooklm-mcp-server · libregistry