notebook-mcp-server
v1.0.1
Published
Professional MCP server to connect AI agents with Google NotebookLM
Maintainers
Readme
The Solution
The NotebookLM MCP Server brings the power of Google's NotebookLM directly into your AI-augmented workflow. Built natively in TypeScript using the Model Context Protocol, it allows agents to read, search, and manage your notebooks as if they were local files.
🚀 Installation
1. Global Installation (Recommended)
You can install the server directly from NPM:
npm install -g notebook-mcp-server2. Direct usage with NPX (Zero-Config)
If you don't want to install it globally, you can run it directly:
npx notebook-mcp-server auth # To log in
npx notebook-mcp-server start # To run the server🔑 Authentication
Before using the server, you must link it to your Google Account. This version uses a secure, persistent browser session:
- Run the authentication command:
notebook-mcp-server auth - A browser window will open. Log in with your Google account.
- Close the browser once you see your notebooks. Your session is now securely saved locally.
⚡ Quick Start
🤖 Claude Desktop
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"notebooklm": {
"command": "npx",
"args": ["-y", "notebook-mcp-server", "start"]
}
}
}💻 Visual Studio Code
Since VS Code does not support MCP natively yet, you must use an extension:
Option A: Using Cline (Recommended)
- Open Cline Settings in VS Code.
- Scroll to the MCP Servers section.
- Click Add New MCP Server.
- Use the following configuration:
- Name:
notebooklm - Command:
npx -y notebook-mcp-server start
- Name:
Option B: Using MCP Client
- Install the extension from the Marketplace.
- Open your VS Code
settings.json. - Add the server under
mcp.servers:"mcp.servers": { "notebooklm": { "command": "npx", "args": ["-y", "notebook-mcp-server", "start"] } }
🌌 Antigravity
- Open your
mcp.jsonconfiguration file. - Add the following entry to the
serversobject:"notebooklm": { "command": "npx", "args": ["-y", "notebook-mcp-server", "start"] }
💎 Gemini CLI
Run the following command in your terminal to add the notebooklm skill:
gemini mcp add notebooklm -- npx -y notebook-mcp-server start🤖 Claude Code Skill
Add it instantly to Claude Code:
claude skill add notebooklm -- "npx -y notebook-mcp-server start"📖 Documentation
| Tool | Description |
| :---------------- | :------------------------------------------------------ |
| list_notebooks | Lists all notebooks available in your account. |
| create_notebook | Creates a new notebook with an optional title. |
| get_notebook | Retrieves the full content and summaries of a notebook. |
| query_notebook | Asks a grounded question to a specific notebook. |
🛠️ Development
To contribute or build from source:
git clone https://github.com/moodRobotics/notebook-mcp-server.git
npm install
npm run build📄 License
MIT License. Developed with ❤️ by moodRobotics.
