notebooklm-mcp-server

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

notebooklm-mcp-server

★ 22 Open GitHub ↗

Universal installer and configuration guide for NotebookLM MCP server.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">NotebookLM MCP Server</h1>

Let your AI agents chat directly with Google NotebookLM for zero-hallucination answers.

English • 
 <a href="README.es.md">Español</a> • 
 <a href="README.fr.md">Français</a> • 
 <a href="README.pt.md">Português</a> • 
 <a href="README.de.md">Deutsch</a>

<a href="#installation">Installation</a> • 
 <a href="#authentication">Authentication</a> • 
 <a href="#quick-start-claude-desktop">Quick Start</a> • 
 <a href="#claude-code-skill">Claude Code</a> • 
 <a href="#documentation">Documentation</a> •
 <a href="#development">Development</a>

## 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:

```bash
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:

```bash
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:
   ```bash
   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`:

```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](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) (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](https://marketplace.visualstudio.com/items?itemName=stefan-mcp.mcp-client)

1. Install the extension from the Marketplace.
2. Open your VS Code `settings.json`.
3. Add the server under `mcp.servers`:
   ```json
   "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:

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

3. **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:

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

---

## 🤖 Claude Code Skill

Add it instantly to Claude Code:

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

---

## 📖 Documentation

The following tools are available through this MCP server:

---

## 🛠️ Development

To contribute or build from source:

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

## 🌐 Localization

This project is available in multiple languages:
- [English](README.md) (Source)
- [Español](README.es.md)
- [Français](README.fr.md)
- [Português](README.pt.md)
- [Deutsch](README.de.md)

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](https://github.com/moodRobotics).

notebooklm-mcp-server

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README