[!WARNING] This project is no longer maintained. As of September 2026 the repository is archived: no updates, bug fixes or support. The npm package will not receive further releases. It may stop working when the upstream services change. Feel free to fork.

NotebookLM MCP Server

MCP server for Google NotebookLM. It drives a real Chrome via Patchright (stealth + persistent fingerprint) so an agent can chat against a notebook, ingest sources, generate audio overviews, and read DOM-level citations. Two transports are supported: stdio (default) and Streamable-HTTP. v2.0.0 is the current line; v1 is no longer supported.

• Requirements
• Install
• Connect — Claude Code, Cursor, Codex, generic MCP
• Authentication
• Transports
• Multi-account
• Tools
• Profiles
• Citations
• Provenance & AI marker
• Configuration reference
• Development
• Migration from v1

Requirements & Platform Support

• Node.js ≥ 18.
• Chrome (stable channel) preferred. The bundled Patchright Chromium is used as a fallback when Chrome refuses to launch — set BROWSER_CHANNEL=chromium to force it.
• Linux / macOS / Windows.
• WSL2 + WSLg (Windows 11+) is fully supported. WSL1 cannot launch a Chromium and is not supported — upgrade to WSL2.
• Headless Linux servers: the one-time setup_auth needs a display because the login flow opens a visible window. Run it once under xvfb-run (xvfb-run -a npx notebooklm-mcp). After login, the persistent Chrome profile lets every subsequent run go fully headless.

Install

Published package

npx notebooklm-mcp@latest

This is the recommended path for end users. npx keeps the binary cached and self-updates on @latest.

From source

git clone https://github.com/PleasePrompto/notebooklm-mcp
cd notebooklm-mcp
npm install
npm run build
node dist/index.js

The prepare script also runs npm run build, so a fresh npm install produces a runnable dist/index.js.

Connect to Claude Code

CLI form:

claude mcp add notebooklm -- npx notebooklm-mcp@latest
# or, from a local clone:
claude mcp add notebooklm -- node /absolute/path/to/notebooklm-mcp/dist/index.js

Manual form — drop into ~/.claude.json:

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

For a local build, replace command/args with "command": "node", "args": ["/absolute/path/to/dist/index.js"].

Connect to other clients

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "notebooklm": {
      "command": "npx",
      "args": ["notebooklm-mcp@latest"]
    }
  }
}

Codex CLI

codex mcp add notebooklm npx notebooklm-mcp@latest

Generic MCP client (stdio)

Any client that can spawn an MCP server over stdio can use the same npx notebooklm-mcp@latest invocation. The server speaks MCP 2025 + the SDK's Server capability set (tools, resources, prompts, completions, logging).

HTTP-only clients (n8n, Zapier, Make, hosted agents)

Run the server in HTTP mode (see Transports) and POST JSON-RPC against http://host:port/mcp. A short curl example lives in docs/usage-guide.md.

Authentication

setup_auth opens a visible Chrome, you log in to your Google account once, and the cookies are persisted in the per-user Chrome profile. Subsequent runs reuse that profile and do not need to log in again.

Profile location (env-paths):

Auth tools:

• setup_auth — first-time login. Pass show_browser=true (default for setup) to see the window. Returns immediately after launching the window; you have up to 10 min to complete the login.
• re_auth — wipe stored auth and start over. Use when switching Google accounts or when authentication is broken.
• cleanup_data — full cleanup with categorised preview. Pass preserve_library=true to keep library.json while wiping browser state.

To force a visible browser for any browser-driven tool, pass show_browser=true or browser_options.show=true on the tool call.

Transports

The server speaks MCP over either stdio or Streamable-HTTP.

stdio (default)

npx notebooklm-mcp@latest

Streamable-HTTP

npx notebooklm-mcp@latest --transport http --port 3000
# bind to all interfaces:
npx notebooklm-mcp@latest --transport http --port 3000 --host 0.0.0.0

Equivalent env vars: NOTEBOOKLM_TRANSPORT=http, NOTEBOOKLM_PORT=3000, NOTEBOOKLM_HOST=0.0.0.0.

Routes:

The server uses the MCP SDK's StreamableHTTPServerTransport, which manages session lifecycle through the Mcp-Session-Id response/request header. A new session is created when the first POST /mcp body is an initialize request; from then on the client must echo the returned Mcp-Session-Id on every request.

Default host is 127.0.0.1. Bind to 0.0.0.0 only when the server is reachable on a trusted network.

Multi-account

Run distinct Chrome profiles for different Google accounts:

npx notebooklm-mcp@latest --account work
npx notebooklm-mcp@latest --account personal
# or via env:
NOTEBOOKLM_ACCOUNT=work npx notebooklm-mcp@latest

Each account gets its own subtree under <dataDir>/accounts/<name>/ — separate cookies, separate chrome_profile, separate auth state. Account names must match [a-z0-9][a-z0-9-_]{0,30}. The first run for a new account requires its own setup_auth.

There is no encrypted credential store — isolation is purely by Chrome profile directory.

Tools

All tools below are registered in v2.0.0 and visible under the full profile. See Profiles for the trimmed sets.

Q&A

Sources & Studio

Library

Sessions

System

Resources (read-only): notebooklm://library, notebooklm://library/{id}, notebooklm://metadata (deprecated, kept for backward compat).

Full per-tool schema and example invocations: docs/tools.md.

Tool profiles

Profiles trim the tool list to keep host-agent context budgets in check.