PlugWiki
gemini-notebook-mcp-cli logo

NotebookLM MCP server and CLI for Gemini Notebook (unofficial, by jacob-bd)

CommunityLocal
GetPyPInotebooklm-mcp-clijacob-bd/gemini-notebook-mcp-cliDocs

Lets Claude, Cursor or Codex query your Gemini Notebook (NotebookLM) notebooks and make podcasts and slides. Unofficial, runs on your computer.

This is the most popular community tool for connecting your AI assistant to Gemini Notebook, the Google product formerly called NotebookLM. It lets Claude, Cursor or Codex create notebooks, add sources, ask questions about them and make audio overviews, slides and reports. Google has no public API for it, so the tool signs in with your Google login cookies and calls Google's internal endpoints, which can break when Google changes things and may not fit Google's terms. It runs on your own computer, not as a web connector.

Good for

  • Students and researchers who keep sources in Gemini Notebook and want answers inside Claude or Cursor
  • Creators who want an assistant to turn sources into audio overviews, videos, slides or quizzes
  • Developers who script notebook work from the terminal with the nlm command
  • People comfortable using a personal Google account with an unofficial tool

Works in

9 supported · 3 should work

Tap an app to see how to set it up and any known problems.

Install gemini-notebook-mcp-cli

Claude Code

  1. 1

    Copy this prompt.

    Add the gemini-notebook-mcp-cli server to Claude Code. Run this command:
    
    uv tool install notebooklm-mcp-cli
    nlm login
    nlm setup add claude-code
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Python 3.11 or newer, uv (or pip/pipx), Google account signed in with nlm login.

Read-only mode: Hide the tools that change things: add NOTEBOOKLM_DISABLED_GROUPS=notebooks_manage,sources_manage,studio,research,sharing,notes to the server's environment, then restart the app.

Install once with uv tool install notebooklm-mcp-cli, then run nlm login and sign in to Google in the browser window that opens. The wizard backs up each file it changes. With 53 tools it uses a lot of context, so type @gemini-notebook-mcp in Claude Code to switch it off when you don't need it.

From the project README. Source.

Tools

  • Lists all your notebooks

    Lists every notebook in your Gemini Notebook account.

    Try: “Show me all my notebooks”

    Network · notebook_list

  • Asks a question about a notebook's sources

    Asks Gemini Notebook a question answered from a notebook's sources; the chat also shows up in the Gemini Notebook website.

    Try: “What does my Thesis notebook say about sample size?”

    Network · notebook_query

  • Asks one question across several notebooks

    Asks the same question of several notebooks, picked by name, tag or all of them, and returns combined answers with citations per notebook.

    Try: “Across my research notebooks, compare the approaches to evaluation”

    Network · cross_notebook_query

  • Shows a notebook's details and its sources

    Shows one notebook's details along with the list of its sources.

    Try: “What sources are in my Marketing notebook?”

    Network · notebook_get

  • Summarizes a notebook and suggests topics

    Gets Gemini Notebook's AI summary of a notebook plus suggested topics to explore.

    Try: “Give me a summary of my Climate notebook”

    Network · notebook_describe

  • Adds a web page, text, file or Drive doc as a source

    Adds a source to a notebook from a URL, pasted text, a file on your computer or a Google Drive document, and can wait until it is processed.

    Try: “Add this article to my Research notebook: https://example.com/post”

    Write · source_add

  • Summarizes one source with keywords

    Gets an AI summary and keywords for a single source in a notebook.

    Try: “Summarize the second source in my History notebook”

    Network · source_describe

  • Shows the raw text of a source

    Returns the full raw text that Gemini Notebook holds for one source.

    Try: “Show me the full text of the interview transcript source”

    Network · source_get_content

  • Lists sources and whether Drive copies are out of date

    Lists a notebook's sources and flags Google Drive sources whose original has changed since import.

    Try: “Which Drive sources in my Project notebook are out of date?”

    Network · source_list_drive

  • Refreshes Drive sources that changed

    Re-imports Google Drive sources whose original documents have changed.

    Try: “Sync the out-of-date Drive sources in my Project notebook”

    Write · source_sync_drive

  • Renames a source

    Changes the name of a source inside a notebook.

    Try: “Rename the PDF source to 'Q3 report'”

    Write · source_rename

  • Creates a new notebook

    Creates a new, empty notebook with the name you give.

    Try: “Create a notebook called Quantum Computing”

    Write · notebook_create

Read from the source code

Pros and cons

Good

  • The most-starred Gemini Notebook server, with frequent releases
  • Covers notebooks, sources, chat, research, sharing and every Studio format
  • A setup wizard connects detected AI apps and backs up each file it changes
  • You can hide tool groups for a question-only setup
  • Several Google accounts through named profiles
  • Also a full command-line tool for scripts

Watch out

  • Unofficial: built on internal Google endpoints that can change without notice
  • Needs your Google login cookies, which can expire or be revoked
  • May not fit Google's terms of service, per the author
  • Runs only on your computer; not for claude.ai on the web or phone
  • 53 tools use a lot of context
  • Enterprise accounts are experimental

Permissions

medium risk · 5 things to watch · 4 advisories

Medium risk

It acts as your Google account, so it can delete notebooks, make them public and invite people, and Google could treat the unofficial access as a terms problem. Hide the tool groups that change things if you only need answers, and turn on protected storage for your saved login.

What it can do

Watch out for

  • Uses your Google login, not an official API

    It signs in with your browser cookies and calls internal endpoints, which the author says may not fit Google's terms. Use an account you are willing to risk. github.com

  • It can delete notebooks or make them public

    Tools can delete notebooks and sources, turn on public links and invite people by email. Hide those tool groups if you only want answers. github.com

  • Your saved login is a plain file by default

    Turn on protected storage so the saved Google login is encrypted with a key kept in your keychain. github.com

  • Keep downloads in one folder

    An older version let downloads land anywhere on disk. Stay on a current version; downloads now stay in one folder by default. github.com

  • Never put the web mode on the internet

    Its optional HTTP mode has no password or sign-in. Keep the default local setup. github.com

Security advisories

Technical details
Turning on read-onlySet NOTEBOOKLM_DISABLED_GROUPS=notebooks_manage,sources_manage,studio,research,sharing,notes in the server's environment. Changes apply after a restart.
Talks tonotebooklm.google.com / Gemini Notebook (Google's internal endpoints). Google Drive for Drive sources and exports to Docs or Sheets
Sign-in and keysGoogle login cookies saved under ~/.notebooklm-mcp-cli (one folder per profile). Optional protected mode encrypts them with a key in the OS keychain: nlm auth storage set protected.
Scopes
  • Your full Gemini Notebook account through saved Google login cookies (no official scopes)

Alternatives

Use this server for the widest coverage and active upkeep. Pick roomi-fields if you also want a REST API for n8n or Zapier, and avoid PleasePrompto's, which is archived.

ServerOfficialRunsSign-inMaintainedToolsStars
jacob-bd CLI + MCPThis pageCommunityLocalGoogle loginActive536.4K
roomi-fieldsCommunityLocalGoogle loginActive–217
PleasePromptoCommunityLocalGoogle loginArchived–3.4K

What people say

People like getting notebook features inside their assistant and dislike how often Google-side changes break the sign-in, though fixes usually land within days.

What people like

  • Brings notebook questions, sources and audio or video overviews into Claude, Cursor or Codex
  • Bugs reported on GitHub, including Google-side breakages, were fixed within days
  • A setup wizard connects detected AI apps without editing config files

Common complaints

  • Sign-in uses browser cookies and breaks when Google changes its pages or revokes the session
  • 53 tools take up a lot of the assistant's memory for each chat
  • Relies on internal Google endpoints that the author says may not fit Google's terms

In their words

Questions

Is there an official NotebookLM MCP server?

No. Google has no public API for the consumer product, so every NotebookLM or Gemini Notebook server is a community project. Google offers a notebooks API only for Gemini Notebook Enterprise on Google Cloud.

Is NotebookLM now called Gemini Notebook?

Yes. Google renamed it on July 16, 2026, and it is the same product. This tool's package still uses the notebooklm name.

Is it free?

Yes. The tool is free and open source under the MIT license. What you can generate still depends on your Gemini Notebook plan limits.

Is it safe to use?

It acts as your Google account through saved login cookies and uses unofficial endpoints, which the author says may not fit Google's terms. Use a current version, turn on protected login storage, and hide the tools that change things if you only need answers.

Can it delete my notebooks?

Yes. It can delete notebooks, sources and generated items, though deletes need an extra confirmation from the assistant. It can also make a notebook public or invite people.

Can I make it read-only?

Yes. Set the server's NOTEBOOKLM_DISABLED_GROUPS setting to hide the groups that create, change, share or delete, then restart your AI app.

Why does it keep asking me to log in again?

Google's login cookies expire or get revoked, and Google page changes can break sign-in. Run nlm login again and update to the latest version, which renews short-lived cookies on its own.

Can I use it in claude.ai or on my phone?

No. It runs on your own computer, and its web mode has no sign-in of its own, so the author warns against putting it online.

Does it work with Gemini Notebook Enterprise?

Partly. The author marks Enterprise support as experimental and you need your Google Cloud project ID and location from your admin.

How do I add it to Claude?

Use the install box above. For Claude Desktop, the one-click extension file is the simplest route.

Examples

  • Create a notebook and turn it into a podcast

    Create a notebook about quantum computing and generate a podcast

    Source
  • Research a topic on the web and import the best sources into a notebook

    Research recent studies on sleep and memory, then add the sources you find to my Sleep notebook

  • Ask one question across several notebooks

    Across my notebooks tagged thesis, what do the sources say about sample size?

Information

updated Nov 2, 2026

Publisher
Community
Package
notebooklm-mcp-cli
Registry
PyPI
Version
0.15.8
License
MIT
Last commit
Oct 27, 2026
Open issues
0

MCP GuideGitHubPyPIChangelogIssues

Other NotebookLM MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 16
  1. README: Gemini Notebook CLI & MCP Server · github.com
  2. MCP Guide · github.com
  3. NotebookLM is now Gemini Notebook · blog.google
  4. Create and manage notebooks (API) · docs.cloud.google.com
  5. Remote MCP Deployment · github.com
  6. Authentication Guide · github.com
  7. GHSA-92q4-9x75-55rf · github.com
  8. GHSA-v558-4774-r6wq · github.com
  9. GHSA-747w-q55c-m74m · github.com
  10. GHSA-jhrc-qgxv-3c2g · github.com
  11. Claude Desktop MSIX config path · github.com
  12. source_add/source_delete fail via MCP · github.com
  13. CSRF token extraction broken · github.com
  14. Saved browser profile relaunch gets session revoked · github.com
  15. roomi-fields/notebooklm-mcp README · github.com
  16. PleasePrompto/notebooklm-mcp README · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.