NotebookLM MCP for Claude Desktop

Gives Claude Desktop full control over Google NotebookLM via 56 MCP tools — manage notebooks, sources, chat, artifacts, notes, sharing, research, and export.

Prerequisites

• Python 3.10 or higher

• A Google account with NotebookLM access (notebooklm.google.com)

• Git (optional — you can also download a ZIP)

Related MCP server: NotebookLM MCP Server

Setup

1. Get the code

git clone https://github.com/sprmdta/Experiment_NotebookM_MCP.git
cd Experiment_NotebookM_MCP

Or download and extract the ZIP, then open a terminal in the extracted folder.

2. Create a virtual environment

python -m venv .venv

3. Install dependencies

Windows:

.venv\Scripts\pip install -r requirements.txt

Mac/Linux:

.venv/bin/pip install -r requirements.txt

4. Install the Playwright browser

Windows:

.venv\Scripts\playwright install chromium

Mac/Linux:

.venv/bin/playwright install chromium

5. Log in to Google

Run the login command from inside the project folder:

Windows (PowerShell or Command Prompt):

cd "C:\YOUR_PATH_TO_REPO\Experiment_NotebookM_MCP"
.venv\Scripts\python -m notebooklm login

Mac/Linux:

cd /YOUR_PATH_TO_REPO/Experiment_NotebookM_MCP
.venv/bin/python -m notebooklm login

What happens during login

The login command is interactive — it opens a browser and waits for you to confirm before saving anything. Follow these steps exactly:

1. A Chromium browser window opens automatically and navigates to NotebookLM

2. Sign in with the Google account linked to your NotebookLM account

3. Complete any 2-factor authentication if prompted

4. Wait until you can see the NotebookLM homepage (your list of notebooks)

5. Switch back to your terminal window

6. Press ENTER in the terminal to save the session

Critical: Do NOT close the browser window before pressing ENTER. Closing the browser exits the process without saving. The session cookies are only written to disk when you press ENTER in the terminal.

What success looks like

After pressing ENTER, the terminal will print:

Authentication saved to: C:\Users\YOUR_USERNAME\.notebooklm\storage_state.json

This file (storage_state.json) contains your Google session cookies. The MCP server reads this file every time it makes a request to NotebookLM.

Verify the login worked

You can confirm the file was created:

Windows:

dir "%USERPROFILE%\.notebooklm\storage_state.json"

Mac/Linux:

ls ~/.notebooklm/storage_state.json

If the file exists, login succeeded. If it does not exist, the login was not completed — re-run the command and make sure to press ENTER in the terminal.

6. Configure Claude Desktop

Open (or create) the Claude Desktop config file:

• Windows: C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Windows (replace YOUR_PATH_TO_REPO with the actual path where you cloned the repo):

{
  "mcpServers": {
    "notebooklm": {
      "command": "C:\\YOUR_PATH_TO_REPO\\Experiment_NotebookM_MCP\\.venv\\Scripts\\python.exe",
      "args": ["C:\\YOUR_PATH_TO_REPO\\Experiment_NotebookM_MCP\\notebooklm_mcp.py"],
      "env": {
        "NOTEBOOKLM_STORAGE_PATH": "C:\\Users\\YOUR_USERNAME\\.notebooklm"
      }
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "notebooklm": {
      "command": "/YOUR_PATH_TO_REPO/Experiment_NotebookM_MCP/.venv/bin/python",
      "args": ["/YOUR_PATH_TO_REPO/Experiment_NotebookM_MCP/notebooklm_mcp.py"],
      "env": {
        "NOTEBOOKLM_STORAGE_PATH": "/Users/YOUR_USERNAME/.notebooklm"
      }
    }
  }
}

7. Restart Claude Desktop

Fully quit Claude Desktop — closing the window is not enough. Right-click the Claude icon in the system tray (bottom-right taskbar on Windows, menu bar on Mac) and choose Quit, then reopen it.

Claude Desktop reads the config only at startup. If you edit the config while it is running, the changes will not take effect until you fully restart it.

The NotebookLM tools appear in the tools panel (hammer icon) once connected.

8. Test

Ask Claude: List my NotebookLM notebooks

Claude will call notebooklm_list_notebooks and return your notebooks.

Re-authentication

Session cookies expire periodically (typically every few weeks). If Claude Desktop reports authentication errors, re-run the same login command from inside the project folder:

Windows:

cd "C:\YOUR_PATH_TO_REPO\Experiment_NotebookM_MCP"
.venv\Scripts\python -m notebooklm login

Mac/Linux:

cd /YOUR_PATH_TO_REPO/Experiment_NotebookM_MCP
.venv/bin/python -m notebooklm login

Follow the same steps as the initial login:

1. Sign in to Google in the browser that opens

2. Wait for the NotebookLM homepage to load

3. Press ENTER in the terminal to save

The storage_state.json file is overwritten with fresh cookies. You do not need to change any config or restart Claude Desktop — the updated cookies are picked up automatically on the next request.

Troubleshooting

Tool Reference

All 56 tools follow the naming convention notebooklm_{action}_{resource}.

Notes

• Uses the unofficial notebooklm-py library which reverse-engineers NotebookLM's internal APIs. Google may change these APIs at any time.

• Not affiliated with or endorsed by Google.

• Session cookies expire periodically and require re-login via notebooklm login.

• Rate limits apply — the server returns error messages if you hit them.