Skip to main content
Glama
simonelsstnfs-afk

gemini-notebook-mcp

README.md
# Gemini Notebook MCP Server

This is a patched and fully functional version of the original `notebooklm-mcp-server`.
It has been updated to reflect Google's recent rebranding and URL changes from NotebookLM to **Gemini Notebook** (`notebook.google.com`).

## Enhancements in this Fork
1. **URL Update:** Full support for `notebook.google.com` (previous versions pointed to the deprecated `notebooklm.google.com` which caused auth loops and expired sessions).
2. **UTF-8 Support:** Fixed the `'ascii' codec can't encode characters` bug when retrieving notebooks with Spanish titles, emojis, or special characters.
3. **Robust Cookie Extraction:** Added dependencies and logic improvements for Chromium cookie extraction on Windows (using `pycryptodome` for AES-GCM and DPAPI).

## Installation

```bash
uv pip install -U git+https://github.com/USER/gemini-notebook-mcp.git
```
*(Replace `USER` with your github username)*

## Usage

1. Authenticate with your Chrome session:
```bash
gemini-notebook-mcp-auth
```

2. Add to your MCP client (Claude, Antigravity, Cursor, etc.):
```json
{
  "mcpServers": {
    "gemini-notebook": {
      "command": "python",
      "args": ["-X", "utf8", "-m", "notebooklm_mcp"],
      "env": {
        "PYTHONUTF8": "1",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}
```
*Note: We highly recommend using `python -X utf8 -m notebooklm_mcp` as the command to force UTF-8 at the interpreter level, avoiding encoding crashes.*