notebooklm-server

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 notebooklm-mcp-server

[!NOTE] Auto-update: The server automatically checks for new versions at startup. If an update exists, it will install itself and ask you to restart to ensure you always have the latest Google fixes.

2. Direct usage with NPX (Zero-Config)

If you don't want to install it globally, you can run it directly:

npx notebooklm-mcp-server auth   # To log in
npx notebooklm-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:

1. Run the authentication command:

   npx notebooklm-mcp-server auth
   

2. A browser window will open. Log in with your Google account.
3. Close the browser once you see your notebooks. Your session is now securely saved locally.

[!TIP] Session Expired? If your agent receives authentication errors, simply ask it to run the command npx notebooklm-mcp-server refresh_auth. It will automatically open the browser for you to renew the session without leaving your chat.

⚡ Quick Start

🤖 Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-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)

1. Open Cline Settings in VS Code.
2. Scroll to the MCP Servers section.
3. Click Add New MCP Server.
4. Use the following configuration:
   • Name: notebooklm
   • Command: npx -y notebooklm-mcp-server start

Option B: Using MCP Client

1. Install the extension from the Marketplace.
2. Open your VS Code settings.json.
3. Add the server under mcp.servers:

   "mcp.servers": {
     "notebooklm": {
       "command": "npx",
       "args": ["-y", "notebooklm-mcp-server", "start"]
     }
   }
   

🌌 Antigravity

Antigravity supports MCP natively. You can add the server by editing your global configuration file:

1. Locate your mcp.json:

   • Windows: %APPDATA%\antigravity\mcp.json
   • macOS: ~/Library/Application Support/antigravity/mcp.json
   • Linux: ~/.config/antigravity/mcp.json

2. Add the server to the mcpServers object:

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["-y", "notebooklm-mcp-server", "start"]
    }
  }
}

1. Restart Antigravity: The new tools will appear in your sidebar instantly.

💎 Gemini CLI

Run the following command in your terminal to add the notebooklm skill:

gemini mcp add notebooklm --scope user -- npx -y notebooklm-mcp-server start

🤖 Claude Code Skill

Add it instantly to Claude Code:

claude skill add notebooklm -- "npx -y notebooklm-mcp-server start"

📖 Documentation

The following tools are available through this MCP server:

📒 Notebook Management

🖇️ Source Management

🔍 Research & Query

🎨 Studio & Generation

⚙️ System

🛠️ Development

To contribute or build from source:

git clone https://github.com/moodRobotics/notebook-mcp-server.git
npm install
npm run build

🌐 Localization

This project is available in multiple languages:

• English (Source)
• Español
• Français
• Português
• Deutsch

If you update the English README.md, please ensure the translations are updated accordingly to keep the documentation synchronized.

📄 License

MIT License. Developed with ❤️ by moodRobotics.