notebooklm-mcp-cli
Provides programmatic access to Gemini Notebook (formerly Google NotebookLM), enabling management of notebooks, sources, queries, studio content, sharing, and downloads.
Allows adding Google Drive files as sources, syncing Drive sources, and using Drive content for research within Gemini Notebook.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@notebooklm-mcp-cli Create a new notebook and add my Google Doc as a source, then summarize it."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gemini Notebook (formerly Google NotebookLM) CLI & MCP Server

Programmatic access to Gemini Notebook — via command-line interface (CLI) or Model Context Protocol (MCP) server.
Note: Personal/consumer accounts are tested regularly. Gemini Notebook Enterprise support is experimental. The documented
notebook.cloud.google.comhost has been live-verified with a project-qualifiedglobaldeployment; other Enterprise host variants may require additional validation.
☕ If you find notebooklm-mcp-cli useful, consider buying me a coffee. It's free and built in my spare time — but testing every Gemini Notebook feature takes real time and resources. A coffee helps me cover it and keep shipping. Thank you! 🙏
📺 Watch the Demos
Latest
Codex Setup + Cinematic Video & Slides |
|
MCP Demos
General Overview | Claude Desktop | Perplexity Desktop | MCP Super Assistant |
|
|
|
|
CLI Demos
CLI Overview | CLI, MCP & Skills | Setup, Doctor & mcpb | Infographics Support |
|
|
|
|
Two Ways to Use
🖥️ Command-Line Interface (CLI)
Use nlm directly in your terminal for scripting, automation, or interactive use:
nlm notebook list # List all notebooks
nlm notebook create "Research Project" # Create a notebook
nlm source add <notebook> --url "https://..." # Add sources
nlm audio create <notebook> --confirm # Generate podcast
nlm download audio <notebook> --id <artifact-id> # Download audio file
nlm download all <notebook> -d ./exports # Download every artifact
nlm share public <notebook> # Enable public linkRun nlm --ai for comprehensive AI-assistant documentation.
🤖 MCP Server (for AI Agents)
Connect AI assistants (Claude, Gemini, Cursor, etc.) to Gemini Notebook:
# Automatic setup — picks the right config for each tool
nlm setup add claude-code
nlm setup add claude-desktop
nlm setup add gemini
nlm setup add github-copilot
nlm setup add cursor
nlm setup add cline
nlm setup add antigravity
# Generate JSON config for any other tool
nlm setup add jsonThen use natural language: "Create a notebook about quantum computing and generate a podcast"
Related MCP server: NotebookLM MCP Server
Features
Capability | CLI Command | MCP Tool |
List notebooks |
|
|
Create notebook |
|
|
Add Sources (URL, Text, Drive, File) |
|
|
Query notebook (persists to web UI) |
|
|
List/view/export chat sessions |
|
|
Create Studio Content (Audio, Video, etc.) |
|
|
Revise slide decks |
|
|
Download artifacts |
|
|
Download all artifacts (one or all notebooks) |
|
|
Web/Drive research |
|
|
Share notebook |
|
|
Sync Drive sources |
|
|
Batch operations |
|
|
Cross-notebook query |
|
|
Pipelines (multi-step workflows) |
|
|
Tag & smart select |
|
|
Configure AI tools |
| — |
Install AI Skills |
| — |
Diagnose issues |
| — |
Check remaining plan usage |
|
|
📚 More Documentation:
Getting Started — Install, login, agent setup, and migration from another Gemini Notebook MCP
CLI Guide — Complete command reference
MCP Guide — All 43 MCP tools with examples
Authentication — Setup and troubleshooting
Remote MCP — Web/mobile connector feasibility, security, and authentication limitations
API Reference — Internal API docs for contributors
Important Disclaimer
This MCP and CLI use internal APIs that:
Are undocumented and may change without notice
Require cookie extraction from your browser (I have a tool for that!)
Use at your own risk for personal/experimental purposes.
Installation
🆕 Claude Desktop users: Download the extension (
.mcpbfile) → double-click → done! One-click install, no config needed.
Install from PyPI. This single package includes both the CLI and MCP server:
Using uv (Recommended)
uv tool install notebooklm-mcp-cliUsing uvx (Run Without Install)
uvx --from notebooklm-mcp-cli nlm --help
uvx --from notebooklm-mcp-cli notebooklm-mcpUsing pip
pip install notebooklm-mcp-cliUsing pipx
pipx install notebooklm-mcp-cliAfter installation, you get:
nlm— Command-line interfacenotebooklm-mcp— Gemini Notebook MCP server for AI assistants
# Clone the repository
git clone https://github.com/jacob-bd/gemini-notebook-mcp-cli.git
cd notebooklm-mcp
# Install with uv
uv tool install .Upgrading
# Using uv
uv tool upgrade notebooklm-mcp-cli
# Using pip
pip install --upgrade notebooklm-mcp-cli
# Using pipx
pipx upgrade notebooklm-mcp-cliAfter upgrading, restart your AI tool to reconnect to the updated MCP server:
Claude Code: Restart the application, or use
/mcpto reconnectCursor: Restart the application
Gemini CLI: Restart the CLI session
Upgrading from Legacy Versions
If you previously installed the separate CLI and MCP packages, you need to migrate to the unified package.
Step 1: Check What You Have Installed
uv tool list | grep notebooklmLegacy packages to remove:
Package | What it was |
| Old CLI-only package |
| Old MCP-only package |
Step 2: Uninstall Legacy Packages
# Remove old CLI package (if installed)
uv tool uninstall notebooklm-cli
# Remove old MCP package (if installed)
uv tool uninstall notebooklm-mcp-serverStep 3: Reinstall the Unified Package
After removing legacy packages, reinstall to fix symlinks:
uv tool install --force notebooklm-mcp-cliWhy
--force? When multiple packages provide the same executable,uvcan leave broken symlinks after uninstalling. The--forceflag ensures clean symlinks.
Step 4: Verify Installation
uv tool list | grep notebooklmYou should see only:
notebooklm-mcp-cli v0.2.0
- nlm
- notebooklm-mcpStep 5: Re-authenticate
Your existing cookies should still work, but if you encounter auth issues:
nlm loginNote: The configured MCP server name is now
gemini-notebook-mcp. The executable remainsnotebooklm-mcpfor compatibility with existing installations.
Getting Started
If you are setting up the tool for the first time — or migrating from a browser-based Gemini Notebook MCP — see the Getting Started Guide. It covers install, login, agent registration, and a step-by-step migration path that avoids the "two Gemini Notebook servers registered" trap.
Uninstalling
To completely remove the MCP:
# Using uv
uv tool uninstall notebooklm-mcp-cli
# Using pip
pip uninstall notebooklm-mcp-cli
# Using pipx
pipx uninstall notebooklm-mcp-cli
# Remove cached auth tokens and data (optional)
rm -rf ~/.notebooklm-mcp-cliAlso remove from your AI tools:
nlm setup remove claude-code
nlm setup remove cursor
# ... or any configured toolAuthentication
Before using the CLI or MCP, you need to authenticate with Gemini Notebook:
CLI Authentication (Recommended)
# Auto mode: launches your browser, you log in, cookies extracted automatically
nlm login
# Check if already authenticated
nlm login --check
# Use a named profile (for multiple Google accounts)
nlm login --profile work
nlm login --profile personal
# Manual mode: import cookies from a file
nlm login --manual --file cookies.txt
# External CDP provider (e.g., OpenClaw-managed browser)
nlm login --provider openclaw --cdp-url http://127.0.0.1:18800Profile management:
nlm login --check # Show current auth status
nlm login switch <profile> # Switch the default profile
nlm login profile list # List all profiles with email addresses
nlm login profile delete <profile> # Delete a profile
nlm login profile rename <old> <new> # Rename a profileUnattended / scheduled refresh:
A live session self-heals — when Google's short-lived cookies age out, the client automatically runs a headless refresh. For unattended machines you can also refresh proactively from a scheduler so a session never lapses:
nlm auth refresh # Headless, no interaction; exits non-zero on failure
nlm auth refresh --profile work # Refresh a named profileRun it on a timer (cron/launchd). It needs a saved Chrome profile from a prior
nlm login, and does not apply when NOTEBOOKLM_COOKIES is set as an
environment variable (that value overrides saved credentials).
Enterprise Authentication (Gemini Notebook Enterprise)
For organizations using Gemini Notebook Enterprise via Google Cloud, ask your Enterprise administrator for the project ID or number, the deployment location/multi-region, and confirmation that your account has access. The current documented host is notebook.cloud.google.com; older deployments may use notebooklm.cloud.google.com or vertexaisearch.cloud.google.com.
Set Base URL, GCP Project ID & Location:
export NOTEBOOKLM_BASE_URL="https://notebook.cloud.google.com" # Required: your GCP project ID or project number from your administrator export NOTEBOOKLM_PROJECT_ID="your-gcp-project-id-or-number" # Optional: GCP location/multi-region from your administrator: global (default), us, or eu export NOTEBOOKLM_LOCATION="global"Save an Enterprise Auth Profile: This opens the configured Enterprise URL in an isolated browser profile. Sign in with your organization account:
nlm login --profile enterprise nlm login switch enterpriseYou can switch back to a personal profile at any time:
unset NOTEBOOKLM_BASE_URL NOTEBOOKLM_PROJECT_ID NOTEBOOKLM_LOCATION nlm login switch personalConfigure MCP Server with Enterprise Environment Variables: When adding the MCP server to AI assistants (Claude, Cursor, etc.), pass
NOTEBOOKLM_BASE_URL,NOTEBOOKLM_PROJECT_ID, and optionallyNOTEBOOKLM_LOCATION:{ "mcpServers": { "gemini-notebook-mcp": { "command": "notebooklm-mcp", "env": { "NOTEBOOKLM_BASE_URL": "https://notebook.cloud.google.com", "NOTEBOOKLM_PROJECT_ID": "your-gcp-project-id-or-number", "NOTEBOOKLM_LOCATION": "global" } } } }
Each profile gets its own isolated browser session, so you can be logged into multiple Google accounts simultaneously. Enterprise environment variables apply to the current process, so keep them in an Enterprise-only shell or MCP configuration when you also use a personal account.
Standalone Auth Tool
If you only need the MCP server (not the CLI):
nlm login # Auto mode (launches browser)
nlm login --manual # Manual file modeHow it works: Auto mode launches a dedicated browser profile (supports Chrome, Arc, Dia, Comet, Brave, Edge, Chromium, Firefox, and more), you log in to Google, and cookies are extracted automatically. Your login persists for future auth refreshes.
Prefer a specific browser? Set it with nlm config set auth.browser chromium (or comet, dia, brave, arc, edge, chrome, firefox, etc.). Falls back to auto-detection if the preferred named browser is not found. For any other Chromium-compatible browser, set its executable with nlm config set auth.browser_path /path/to/browser or NLM_BROWSER_PATH; an invalid explicit path fails closed instead of launching a different browser. When Chromium/CDP is unavailable, auto can fall back to Firefox.
For detailed instructions and troubleshooting, see docs/AUTHENTICATION.md.
MCP Configuration
⚠️ Context Window Warning: This MCP provides 43 tools. Disable it when not using Gemini Notebook to preserve context. In Claude Code:
@gemini-notebook-mcpto toggle. To keep it on but expose only a subset, see Selective tool exposure.
Automatic Setup (Recommended)
Use nlm setup to automatically configure the MCP server for your AI tools — no manual JSON editing required:
# Add to any supported tool
nlm setup add claude-code
nlm setup add claude-desktop
nlm setup add claude-desktop --profile 3p # Relay AI / Claude 3P
nlm setup add gemini
nlm setup add github-copilot
nlm setup add cursor
nlm setup add windsurf
# Generate JSON config for any other tool
nlm setup add json
# Check which tools are configured
nlm setup list
# Diagnose installation & auth issues
nlm doctorClaude Desktop setup only writes to profiles that are detected as present. If
both regular and Relay AI/3P profiles exist, the CLI asks whether to configure
regular, 3P, or both. For scripts, use --profile regular|3p|both. If no
Claude Desktop profile is detected, nothing is created or changed.
Removal uses the same profile selection, for example
nlm setup remove claude-desktop --profile regular.
Removal only offers detected profiles containing this MCP or a recognized
legacy entry; unrelated MCP servers are left untouched.
Before adding or removing the MCP, fully quit the selected Claude Desktop profile. The CLI detects running regular and Relay AI/3P instances and refuses to write while they are open, because Claude may rewrite the config and discard the change. Reopen Claude Desktop after setup completes.
Install AI Skills (Optional)
Install the Gemini Notebook expert guide for your AI assistant to help it use the tools effectively. Supported for Cline, Antigravity, OpenClaw, Codex, OpenCode, Claude Code, and Gemini CLI.
# Install skill files
nlm skill install cline
nlm skill install openclaw
nlm skill install codex
nlm skill install antigravity
# Update skills
nlm skill updateUser-level skill installation requires the target tool to be detected first;
the CLI will not create a missing tool directory or install anyway. Use
--level project when you intentionally want a project-local skill.
Remove from a tool
nlm setup remove claude-codeUsing uvx (No Install Required)
If you don't want to install the package, you can use uvx to run on-the-fly:
# Run CLI commands directly
uvx --from notebooklm-mcp-cli nlm setup add cursor
uvx --from notebooklm-mcp-cli nlm loginFor tools that use JSON config, point them to uvx:
{
"mcpServers": {
"gemini-notebook-mcp": {
"command": "uvx",
"args": ["--from", "notebooklm-mcp-cli", "notebooklm-mcp"]
}
}
}Tip: Run
nlm setup add jsonfor an interactive wizard that generates the right JSON snippet for your tool.
Claude Code / Gemini CLI support adding MCP servers via their own CLI:
claude mcp add --scope user gemini-notebook-mcp notebooklm-mcp
gemini mcp add --scope user gemini-notebook-mcp notebooklm-mcpCursor / Windsurf resolve commands from your PATH, so the command name is enough:
{
"mcpServers": {
"gemini-notebook-mcp": {
"command": "notebooklm-mcp"
}
}
}Tool | Config Location |
Cursor |
|
Windsurf |
|
GitHub Copilot (VS Code workspace) uses .vscode/mcp.json with a top-level servers key:
{
"servers": {
"gemini-notebook-mcp": {
"command": "notebooklm-mcp",
"args": []
}
}
}Claude Desktop may not resolve PATH — use the full path to the binary:
{
"mcpServers": {
"gemini-notebook-mcp": {
"command": "/full/path/to/notebooklm-mcp"
}
}
}Find your path with: which notebooklm-mcp
Tool | Config Location |
Claude Desktop (macOS current/3P) |
|
Claude Desktop (macOS legacy) |
|
Claude Desktop (Windows) |
|
Claude Desktop (Windows 3P) |
|
Claude Desktop (Linux) |
|
Claude Desktop (Linux 3P) |
|
GitHub Copilot |
|
📚 Full configuration details: MCP Guide — Server options, environment variables, HTTP transport, and context window management. For Claude web/mobile and public deployment, read Remote MCP Deployment first.
What You Can Do
Simply chat with your AI tool (Claude Code, Cursor, Gemini CLI) using natural language. Here are some examples:
Research & Discovery
"List all my Gemini Notebook notebooks"
"Create a new notebook called 'AI Strategy Research'"
"Start web research on 'enterprise AI ROI metrics' and show me what sources it finds"
"Do a deep research on 'cloud marketplace trends' and import the top 10 sources"
"Search my Google Drive for documents about 'product roadmap' and create a notebook"
Adding Content
"Add this URL to my notebook: https://example.com/article"
"Add this YouTube video about Kubernetes to the notebook"
"Add my meeting notes as a text source to this notebook"
"Import this Google Doc into my research notebook"
AI-Powered Analysis
"What are the key findings in this notebook?"
"Summarize the main arguments across all these sources"
"What does this source say about security best practices?"
"Get an AI summary of what this notebook is about"
"Configure the chat to use a learning guide style with longer responses"
(All queries sent from CLI or MCP automatically persist in your Gemini Notebook web UI chat history!)
Content Generation
"Create an audio podcast overview of this notebook in deep dive format"
"Generate a video explainer with classic visual style"
"Make a short vertical video overview of the key idea"
"Make a briefing doc from these sources"
"Create flashcards for studying, medium difficulty"
"Generate an infographic in landscape orientation with professional style"
"Build a mind map from my research sources"
"Create a slide deck presentation from this notebook"
Smart Management
"Check which Google Drive sources are out of date and sync them"
"Show me all the sources in this notebook with their freshness status"
"Delete this source from the notebook"
"Check the status of my audio overview generation"
"Check this specific artifact without listing every Studio item"
"List only the generated videos in this notebook"
Sharing & Collaboration
"Show me the sharing settings for this notebook"
"Make this notebook public so anyone with the link can view it"
"Disable public access to this notebook"
"Invite user@example.com as an editor to this notebook"
"Add a viewer to my research notebook"
Pro tip: After creating studio content (audio, video, reports, etc.), poll the status to get download URLs when generation completes.
Authentication Lifecycle
Component | Duration | Refresh |
Cookies | ~2-4 weeks | Auto-refresh via headless browser (if profile saved) |
CSRF Token | ~minutes | Auto-refreshed on every request failure |
Session ID | Per MCP session | Auto-extracted on MCP start |
v0.1.9+: The server now automatically handles token expiration:
Refreshes CSRF tokens immediately when expired
Reloads cookies from disk if updated externally
Runs headless browser auth if profile has saved login
You can also call refresh_auth() to explicitly reload tokens.
If automatic refresh fails (Google login fully expired), run nlm login again.
For suspected browser-bound auth replay failures, run nlm doctor auth-replay.
If the cdp_in_page probe succeeds while normal replay fails, see
Experimental browser-backed RPC transport.
Troubleshooting
uv tool upgrade Not Installing Latest Version
Symptoms:
Running
uv tool upgrade notebooklm-mcp-cliinstalls an older version (e.g., 0.1.5 instead of 0.1.9)uv cache cleandoesn't fix the issue
Why this happens: uv tool upgrade respects version constraints from your original installation. If you initially installed an older version or with a constraint, upgrade stays within those bounds by design.
Fix — Force reinstall:
uv tool install --force notebooklm-mcp-cliThis bypasses any cached constraints and installs the absolute latest version from PyPI.
Verify:
uv tool list | grep notebooklm
# Should show: notebooklm-mcp-cli v0.1.9 (or latest)Limitations
Rate limits: Chat and Studio usage is metered as compute against a rolling (~5h) window and a weekly cap, scaled by plan tier. Run
nlm usageto see what is left and when it resetsNo official support: API may change without notice
Cookie expiration: Need to re-extract cookies every few weeks
Contributing
See CLAUDE.md for detailed API documentation and how to add new features.
Vibe Coding Alert
Full transparency: this project was built by a non-developer using AI coding assistants. If you're an experienced Python developer, you might look at this codebase and wince. That's okay.
The goal here was to scratch an itch - programmatic access to Gemini Notebook - and learn along the way. The code works, but it's likely missing patterns, optimizations, or elegance that only years of experience can provide.
This is where you come in. If you see something that makes you cringe, please consider contributing rather than just closing the tab. This is open source specifically because human expertise is irreplaceable. Whether it's refactoring, better error handling, type hints, or architectural guidance - PRs and issues are welcome.
Think of it as a chance to mentor an AI-assisted developer through code review. We all benefit when experienced developers share their knowledge.
Credits
Special thanks to:
Le Anh Tuan (@latuannetnam) for contributing the HTTP transport, debug logging system, and performance optimizations.
David Szabo-Pele (@davidszp) for the
source_get_contenttool and Linux auth fixes.saitrogen (@saitrogen) for the research polling query fallback fix.
devnull03 (@devnull03) for multi-browser CDP authentication support (Arc, Brave, Edge, Chromium, Vivaldi, Opera).
VooDisss (@VooDisss) for multi-browser authentication improvements.
codepiano (@codepiano) for the configurable DevTools timeout for the auth CLI.
Tony Hansmann (@997unix) for contributing the
nlm setupandnlm doctorcommands and CLI Guide documentation.Fabiana Furtado (@fabianafurtadoff) for batch operations, cross-notebook query, pipelines, and smart select/tagging (PR #90).
Amy-Ra-lph (@Amy-Ra-lph) for security hardening: TOCTOU-safe credential storage, sensitive cookie redaction from debug logs, and pinning all CI actions to full commit SHAs (PRs #205–207).
Kyle Brodeur (@kylebrodeur) for WSL2 authentication support with Windows Chrome integration (PR #138).
Robiton (@Robiton) for enterprise Gemini Notebook support via configurable base URL (PR #114).
pjeby (@pjeby) for connection pooling and fast startup improvements (PR #54).
beausea (@beausea) for making the interface language configurable via the
NOTEBOOKLM_HLenvironment variable (PR #59).JumpLao (@JumpLao) for extended audio, video, and image format support (PR #82).
cbruyndoncx (@cbruyndoncx) for including
cited_textpassages in query output (PR #81).zxyasfas (@zxyasfas) for cited-only research import (PR #188).
Serdar Akın (@SERDAR-AKIN) for the multi-probe
AuthHealthCheckerthat fixes false"stale"reports for semi-stale cookies (PR #219).
Star History
License
Available Tools
49 toolsbatchBatchA
Perform batch operations across multiple notebooks.
Actions:
query: Query multiple notebooks with the same question
add_source: Add the same source URL to multiple notebooks
create: Create multiple notebooks at once
delete: Delete multiple notebooks (IRREVERSIBLE, requires confirm=True)
studio: Generate studio artifacts across multiple notebooks
Inputs: action (required), all, tags, query, +5 more. Returns: object
chat_configureChat ConfigureC
Configure notebook chat settings.
Inputs: notebook_id (required), goal, custom_prompt, response_length. Returns: object
chat_exportChat ExportC
Export a chat transcript to Markdown or JSON.
Inputs: notebook_id (required), format, conversation_id. Returns: object
chat_getChat GetB
Get full transcript of a specific chat session.
Inputs: notebook_id (required), conversation_id. Returns: object
chat_listChat ListA
List chat sessions for a notebook.
Inputs: notebook_id (required), limit. Returns: object
collection_createCollection CreateC
Create a new collection.
Inputs: name (required), notebook_ids. Returns: object
collection_deleteCollection DeleteA
Delete a collection permanently. Notebooks inside the collection are NOT deleted.
Inputs: collection_id (required), confirm. Returns: object
collection_editCollection EditA
Edit an existing collection's name and/or list of notebooks.
Inputs: collection_id (required), name, notebook_ids. Returns: object
collection_listCollection ListA
List all native collections.
Inputs: no named parameters. Returns: object
collection_set_emojiCollection Set EmojiA
Set or clear the emoji marker on a collection.
Inputs: emoji (required), collection_id (required). Returns: object
cross_notebook_queryCross Notebook QueryA
Query multiple notebooks and get aggregated answers with per-notebook citations.
Specify notebooks by name, by tags, or use all=True for all notebooks.
Inputs: query (required), all, tags, notebook_names. Returns: object
download_all_artifactsDownload All ArtifactsA
Download all completed studio artifacts of one notebook — or every notebook.
Creates a subdirectory of output_dir named after each notebook title and saves every completed artifact there, named after its title with the type's default extension (report → .md, mind_map → .json, video → .mp4, slide_deck → .pdf/.pptx, ...). Artifacts that are still generating or failed are skipped and listed in the result. A failure on one artifact (or one notebook in a sweep) does not stop the others.
Inputs: output_dir, notebook_id, all_notebooks, output_format, +3 more. Returns: object
download_artifactDownload ArtifactB
Download any NotebookLM artifact to a file.
Unified download tool replacing 9 separate download tools. Supports all artifact types: audio, video, report, mind_map, slide_deck, infographic, data_table, file, quiz, flashcards.
Inputs: notebook_id (required), output_path (required), artifact_type (required), wait, +5 more. Returns: object
export_artifactExport ArtifactA
Export a NotebookLM artifact to Google Docs or Sheets.
Supports:
Data Tables → Google Sheets
Reports (Briefing Doc, Study Guide, Blog Post) → Google Docs
Inputs: artifact_id (required), export_type (required), notebook_id (required), title. Returns: object
labelLabelA
Manage source labels in a notebook. Unified tool for all label operations.
Labels let you organize sources into thematic categories. Requires 5+ sources for auto-labeling. Sources can belong to multiple labels simultaneously.
Supports: auto, list, reorganize, create, rename, set_emoji, move_source, delete
Inputs: action (required), notebook_id (required), name, emoji, +5 more. Returns: object
noteNoteB
Manage notes in a notebook. Unified tool for all note operations.
Supports: create, list, update, delete
Inputs: action (required), notebook_id (required), title, confirm, +2 more. Returns: object
notebook_createNotebook CreateB
Create a new notebook.
Inputs: title. Returns: object
notebook_deleteNotebook DeleteA
Delete notebook permanently. IRREVERSIBLE. Requires confirm=True.
Inputs: notebook_id (required), confirm. Returns: object
notebook_describeNotebook DescribeA
Get AI-generated notebook summary with suggested topics.
Inputs: notebook_id (required). Returns: object
notebook_getNotebook GetC
Get notebook details with sources.
Inputs: notebook_id (required). Returns: object
notebook_listNotebook ListC
List all notebooks.
Inputs: max_results. Returns: object
notebook_queryNotebook QueryA
Ask AI about EXISTING sources already in notebook. NOT for finding new sources.
Use research_start instead for: deep research, web search, find new sources, Drive search.
Inputs: query (required), notebook_id (required), timeout, source_ids, +2 more. Returns: object
notebook_query_startNotebook Query StartA
Start a notebook query asynchronously for source-heavy notebooks or long questions.
Use this instead of notebook_query when the response may take longer than the default 120-second budget. A timeout around 180 seconds is a useful starting point for source-heavy notebooks. Returns immediately with a query_id. Poll notebook_query_status with the query_id to get the result.
Workflow: notebook_query_start -> poll notebook_query_status until completed.
Inputs: query (required), notebook_id (required), timeout, source_ids, +2 more. Returns: object
notebook_query_statusNotebook Query StatusA
Check the status of an async notebook query started with notebook_query_start.
Returns the query result when completed, or current status if still in progress. Poll this tool every few seconds until status is 'completed' or 'error'.
Inputs: query_id (required). Returns: object
notebook_renameNotebook RenameC
Rename a notebook.
Inputs: new_title (required), notebook_id (required). Returns: object
pipelinePipelineB
Manage and execute multi-step notebook pipelines.
Actions:
run: Execute a pipeline on a notebook
list: List all available pipelines (builtin and user-defined)
Inputs: action (required), input_url, notebook_id, pipeline_name. Returns: object
refresh_authRefresh AuthA
Reload auth tokens from disk or run headless re-authentication.
Call this after running nlm login to pick up new tokens,
or to attempt automatic re-authentication if Chrome profile has saved login.
Returns status indicating if tokens were refreshed successfully.
Inputs: no named parameters. Returns: object
research_importResearch ImportA
Import discovered sources into notebook.
Call after research_status shows status="completed".
Inputs: task_id (required), notebook_id (required), timeout, cited_only, +1 more. Returns: object
research_startResearch StartA
Deep research / fast research: Search web or Google Drive to FIND NEW sources.
Use this for: "deep research on X", "find sources about Y", "search web for Z", "search Drive". Workflow: research_start -> poll research_status -> research_import.
Inputs: query (required), mode, title, source, +1 more. Returns: object
research_statusResearch StatusA
Poll research progress. Blocks until complete or timeout.
Inputs: notebook_id (required), query, compact, task_id, +3 more. Returns: object
save_auth_tokensSave Auth TokensA
Save NotebookLM cookies (FALLBACK method - try nlm login first!).
IMPORTANT FOR AI ASSISTANTS:
First, run
nlm loginvia Bash/terminal (automated, preferred)Only use this tool if the automated CLI fails
Inputs: cookies (required), csrf_token, session_id, request_url, +1 more. Returns: object
server_infoServer InfoA
Get version, auth status, and conservative MCP capability visibility.
AI assistants: If update_available is True, inform the user that a new version is available and suggest updating with the provided command.
auth_status is the result of an AuthHealthChecker probe. The checker
runs a multi-probe strategy (homepage fetch + API fallback) with
30-second TTL caching and mtime-based bypass on auth-file changes.
The reported value may therefore be up to 30 seconds old, and an
external nlm login is picked up within one check cycle without
waiting for the TTL to expire.
auth_status meanings:
"configured" — homepage (or API fallback) check passed; credentials are good. Cached credentials may be reported as configured for up to 30 seconds.
"not_configured" — no credentials are stored (first-time setup).
"stale" — credentials are known-bad (expired or past the 7-day heuristic). Operations will fail; ask the user to run
nlm loginto refresh."unverified" — the check could not be completed (network error, timeout, non-200 response). Cached credentials may still work for actual API calls, so do not assume the user needs to re-auth.
"error" — unexpected exception inside the check itself.
Returns: dict with version info: - version: Current installed version - latest_version: Latest version on PyPI (or None if check failed) - update_available: True if a newer version is available - auth_status: configured | stale | unverified | not_configured | error - update_command: Command to run to update - mcp_capabilities: Built-in tool groups visible in this server process - provider_capabilities: Explicitly unprobed provider/account capabilities
Inputs: no named parameters. Returns: object
source_addSource AddA
Add a source to a notebook. Unified tool for all source types.
Supports: url, text, drive, file
Inputs: notebook_id (required), source_type (required), url, text, +7 more. Returns: object
source_deleteSource DeleteA
Delete source(s) permanently. IRREVERSIBLE. Requires confirm=True.
Inputs: confirm, source_id, source_ids. Returns: object
source_describeSource DescribeB
Get AI-generated source summary with keyword chips.
Inputs: source_id (required). Returns: object
source_get_contentSource Get ContentA
Get raw text content of a source (no AI processing).
Returns the original indexed text from PDFs, web pages, pasted text, or YouTube transcripts. Much faster than notebook_query for content export.
Inputs: source_id (required), wait, wait_timeout, poll_interval. Returns: object
source_list_driveSource List DriveA
List sources with types and Drive freshness status.
Use before source_sync_drive to identify stale sources.
Inputs: notebook_id (required), skip_freshness. Returns: object
source_renameSource RenameB
Rename a source in a notebook.
Inputs: new_title (required), source_id (required), notebook_id (required). Returns: object
source_sync_driveSource Sync DriveA
Sync Drive sources with latest content. Requires confirm=True.
Call source_list_drive first to identify stale sources.
Inputs: source_ids (required), confirm. Returns: object
studio_createStudio CreateC
Create any NotebookLM studio artifact. Unified creation tool.
Supports: audio, video, infographic, slide_deck, report, flashcards, quiz, data_table, mind_map
Inputs: notebook_id (required), artifact_type (required), title, confirm, +18 more. Returns: object
studio_deleteStudio DeleteA
Delete studio artifact. IRREVERSIBLE. Requires confirm=True.
Inputs: artifact_id (required), notebook_id (required), confirm. Returns: object
studio_reviseStudio ReviseA
Revise individual slides in an existing slide deck. Creates a NEW artifact.
Only slide decks support revision. The original artifact is not modified. Poll studio_status after calling to check when the new deck is ready.
Inputs: artifact_id (required), notebook_id (required), slide_instructions (required), confirm. Returns: object
studio_statusStudio StatusC
Check studio content generation status and get URLs, or rename an artifact.
Inputs: notebook_id (required), limit, action, offset, +3 more. Returns: object
tagTagA
Manage notebook tags and find relevant notebooks by tag matching.
Actions:
add: Add tags to a notebook for smart selection
remove: Remove tags from a notebook
list: List all tagged notebooks with their tags
select: Find notebooks relevant to a query using tag matching
Inputs: action (required), tags, query, notebook_id, +1 more. Returns: object
usage_getUsage GetA
Show how much of the plan's usage allowance is left, and when it resets.
Gemini Notebook meters usage as compute against two windows at once: a short rolling window and a weekly one. Both are reported, each with the percentage used, the percentage remaining and the reset time in UTC.
Inputs: profile. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 49 tools
Most tools have clearly distinct purposes (e.g., chat_list vs chat_get vs chat_export). Some potential confusion exists between notebook_query and research_start, but descriptions provide clear guidance. Unified tools like note, label, and tag manage different entity types, reducing ambiguity.
The majority of tool names follow a consistent verb_noun snake_case pattern (e.g., collection_create, source_delete, studio_revise). However, unified tools like 'note', 'label', 'tag', 'pipeline', and 'batch' deviate from this pattern by using single nouns, creating minor inconsistency.
With 49 tools, the server exceeds the 25+ threshold for being 'too many'. While the domain is broad, the number feels excessive and overwhelming, and some tools could have been consolidated further (e.g., download_artifact and download_all_artifacts could overlap). The count is appropriate for full coverage but leans heavy.
The tool set comprehensively covers the NotebookLM domain: notebook CRUD, source management, research workflows, chat, collections, studio artifacts, sharing, tags/labels, auth, usage, and batch operations. There are no obvious dead ends—every major workflow has associated tools for each lifecycle step.
Maintenance
Related MCP Connectors
Google NotebookLM via natural language: create notebooks, add sources (PDF, URL, YouTube) and ask gr
Google Gemini Notebook (NotebookLM): notebooks, sources, cited chat, podcasts, video, slides
Create, search and manage Knowtis collaborative notes from AI assistants.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceEnables interaction with Google's NotebookLM through natural language, allowing users to create and manage notebooks, add sources from URLs/YouTube/Google Drive, query AI for insights, generate audio podcasts and other studio content, and perform AI-powered research and analysis.323MIT
- FlicenseAqualityDmaintenanceEnables AI agents to query and interact with Google NotebookLM notebooks to retrieve citation-backed information. It provides tools for listing notebooks, accessing source data, and asking natural language questions.11-
- AlicenseBqualityAmaintenanceEnables AI assistants to programmatically interact with Google NotebookLM, allowing them to create and manage notebooks, add sources, query content, generate audio/video, and perform research tasks through natural language commands.5518,759 PyPI6,540MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to programmatically access and control Google NotebookLM, supporting operations like notebook management, source addition, audio generation, and more via natural language.39MIT








