
NotebookLM MCP server and CLI for Gemini Notebook (unofficial, by jacob-bd)
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.
The README covers it: run nlm setup, or add it with claude mcp add using the notebooklm-mcp command. GitHub
The README offers a one-click extension file, or nlm setup. Quit Claude Desktop fully before setup.
The README covers it: run nlm setup, or add the notebooklm-mcp command to Cursor's MCP file. GitHub
The README covers GitHub Copilot in VS Code through nlm setup or .vscode/mcp.json. GitHub
The README covers it: run nlm setup, or add the notebooklm-mcp command to Windsurf's MCP file. GitHub
The README covers it: nlm setup add codex, which the ChatGPT desktop app shares. GitHub
The README covers it: run nlm setup, or add it with gemini mcp add. GitHub
nlm setup finds Cline on your computer and adds the server. GitHub
nlm setup finds OpenCode on your computer and adds the server. GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install gemini-notebook-mcp-cli
Claude Code
- 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
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_listAsks 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_queryAsks 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_queryShows 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_getSummarizes 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_describeAdds 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_addSummarizes 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_describeShows 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_contentLists 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_driveRefreshes 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_driveRenames a source
Changes the name of a source inside a notebook.
Try: “Rename the PDF source to 'Q3 report'”
Write ·
source_renameCreates a new notebook
Creates a new, empty notebook with the name you give.
Try: “Create a notebook called Quantum Computing”
Write ·
notebook_createRenames a notebook
Changes a notebook's title.
Try: “Rename my Untitled notebook to Book Club”
Write ·
notebook_renameMakes a podcast, video, report, quiz, slides or other Studio item
Generates a Studio item from a notebook: audio overview, video overview, report, quiz, flashcards, mind map, slide deck, infographic or data table.
Try: “Make a short podcast from my Climate notebook”
Write ·
studio_createRevises slides in an existing slide deck
Asks Gemini Notebook to rework slides in a deck it already made, after you confirm.
Try: “Make the slides in my deck shorter and add a summary slide”
Write ·
studio_reviseReads or builds interactive reports from a notebook
Reads an interactive report and its suggested elements, or generates those elements after you approve the plan.
Try: “Show me the interactive report for my Biology notebook”
Write ·
reportDownloads a podcast, video, slides or other item to your computer
Saves one generated item, such as audio, video, slides, a report or a data table, to your download folder.
Try: “Download the podcast from my Climate notebook”
Files ·
download_artifactDownloads every finished item from a notebook or all notebooks
Saves every completed Studio item from one notebook, or from all notebooks, into a folder per notebook.
Try: “Download everything I've generated in my Thesis notebook”
Files ·
download_all_artifactsExports a report or table to Google Docs or Sheets
Sends a generated report to Google Docs or a data table to Google Sheets.
Try: “Export the briefing doc to Google Docs”
Write ·
export_artifactStarts a web or Drive search for new sources
Starts Gemini Notebook's research on the web or your Google Drive to find sources on a topic.
Try: “Research recent studies on sleep and memory for my Sleep notebook”
Network ·
research_startAdds the sources research found to a notebook
Imports the sources a research run discovered into the notebook, optionally only the cited ones.
Try: “Import the sources you found into my Sleep notebook”
Write ·
research_importLists past chats in a notebook
Lists the chat sessions saved in a notebook.
Try: “What chats have I had in my Thesis notebook?”
Network ·
chat_listShows the full transcript of a chat
Shows the whole transcript of one chat session, the latest by default.
Try: “Show me my last chat in the Thesis notebook”
Network ·
chat_getExports a chat as Markdown or JSON
Exports a chat transcript as a Markdown or JSON file.
Try: “Export my last Thesis chat as Markdown”
Files ·
chat_exportSaves a chat or one answer as a note
Saves a chat, or a single question and answer, as a note in the notebook.
Try: “Save that last answer as a note”
Write ·
chat_save_to_noteSets the chat's goal and answer length
Sets how the notebook chat behaves, such as its goal and how long answers should be.
Try: “Make answers in my Study notebook short and focused on exam prep”
Write ·
chat_configureLists, creates, edits or deletes notes
Manages the notes in a notebook: list them, create new ones, edit or delete them.
Try: “Add a note with today's key takeaways”
Delete ·
noteOrganizes sources under labels
Groups a notebook's sources under labels, including automatic labeling, renaming, moving sources and deleting labels.
Try: “Auto-label the sources in my Research notebook”
Write ·
labelTags notebooks and finds them by tag
Adds or removes tags on notebooks, lists tagged notebooks and finds notebooks that match a topic.
Try: “Tag my AI notebooks with 'research'”
Write ·
tagLists your notebook collections
Lists the collections that group notebooks on your home page.
Try: “What collections do I have?”
Network ·
collection_listCreates a collection of notebooks
Creates a home-page collection, optionally with notebooks in it.
Try: “Create a collection called Client work with my Acme notebook”
Write ·
collection_createRenames a collection or changes its notebooks
Renames a collection or replaces the list of notebooks in it.
Try: “Add my Beta notebook to the Client work collection”
Write ·
collection_editSets or clears a collection's emoji
Gives a collection an emoji, or removes it.
Try: “Give my Client work collection a folder emoji”
Write ·
collection_set_emojiRuns the same action on many notebooks at once
Runs one action across several notebooks: ask a question, add a source, create notebooks, delete them or generate Studio items.
Try: “Make a podcast for every notebook tagged research”
Delete ·
batchRuns or creates multi-step workflows
Lists, runs or creates multi-step workflows, such as adding a source and then making a podcast.
Try: “Run the ingest-and-podcast pipeline on this URL”
Write ·
pipelineShows who a notebook is shared with
Shows a notebook's sharing settings, including whether a public link is on.
Try: “Is my Thesis notebook shared with anyone?”
Network ·
notebook_share_statusTurns a notebook's public link on or off
Turns a public link on or off so anyone with the link can view the notebook.
Try: “Turn off the public link for my Thesis notebook”
Write ·
notebook_share_publicInvites someone to a notebook by email
Invites a collaborator to a notebook by their email address.
Try: “Invite sam@example.com to my Book Club notebook”
Write ·
notebook_share_inviteInvites several people to a notebook at once
Invites several collaborators to a notebook in one request.
Try: “Invite my three teammates to the Project notebook”
Write ·
notebook_share_batchDeletes a notebook
Permanently deletes a notebook, after an extra confirmation.
Try: “Delete my Old Drafts notebook”
Delete ·
notebook_deleteDeletes a source from a notebook
Removes a source from a notebook, after an extra confirmation.
Try: “Remove the outdated pricing PDF from my notebook”
Delete ·
source_deleteDeletes a generated Studio item
Deletes a generated item such as a podcast or slide deck, after an extra confirmation.
Try: “Delete the old podcast from my Climate notebook”
Delete ·
studio_deleteDeletes a collection, keeping its notebooks
Deletes a home-page collection; the notebooks in it are kept.
Try: “Delete the Archive collection”
Delete ·
collection_deleteShows how much of your plan's usage is left
Checks how much of your Gemini Notebook plan usage remains.
Try: “How much of my Gemini Notebook usage is left?”
Network ·
usage_getLists or switches between your Google accounts
Lists saved Google accounts, shows how each login is stored and switches the account the server uses.
Try: “Switch to my work Google account”
Network ·
profileSets short names for notebooks
Creates, lists or removes short names you can use instead of long notebook IDs.
Try: “Call my Thesis Research notebook 'thesis'”
Write ·
aliasUsed by the assistant behind the scenes
Starts a long question in the background
Starts a notebook question in the background for large notebooks or slow answers.
Network ·
notebook_query_startChecks on a background question
Checks whether a question started in the background has finished.
Network ·
notebook_query_statusChecks if a podcast, video or other item is ready
Checks the progress of a Studio item that is still being generated.
Network ·
studio_statusChecks on a research run
Checks the progress of a web or Drive research run.
Network ·
research_statusReloads or recovers your saved Google login
Checks and reloads the saved Google login, or recovers a saved session when it has expired.
Network ·
refresh_authSaves login cookies by hand
Saves Google login cookies you supply, as a fallback when automatic login fails.
Write ·
save_auth_tokensShows version, update and storage status
Reports the tool's version, whether an update is available, saved accounts and any problem with login storage.
Network ·
server_info
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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
4 known advisories, all fixed in a newer version.
- A download request could write files outside the download folder, such as startup or settings filesmedium · Fixed in 0.10.1 · GHSA-92q4-9x75-55rf
- On Windows WSL, the login setup left a port open to your local network that could control Chrome, and never removed itmedium · Fixed in 0.11.2 · GHSA-v558-4774-r6wq
- A debug page could briefly be readable by other users on the same computerlow · Fixed in 0.11.2 · GHSA-747w-q55c-m74m
- Debug logs could save responses that contain your notebook datalow · Fixed in 0.11.2 · GHSA-jhrc-qgxv-3c2g
Technical details
| Turning on read-only | Set NOTEBOOKLM_DISABLED_GROUPS=notebooks_manage,sources_manage,studio,research,sharing,notes in the server's environment. Changes apply after a restart. |
|---|---|
| Talks to | notebooklm.google.com / Gemini Notebook (Google's internal endpoints). Google Drive for Drive sources and exports to Docs or Sheets |
| Sign-in and keys | Google 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 |
|
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.
| Server | Official | Runs | Sign-in | Maintained | Tools | Stars |
|---|---|---|---|---|---|---|
| jacob-bd CLI + MCPThis page | Community | Local | Google login | Active | 53 | 6.4K |
| roomi-fields | Community | Local | Google login | Active | – | 217 |
| PleasePrompto | Community | Local | Google login | Archived | – | 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
SourceResearch 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
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 16Hide
- README: Gemini Notebook CLI & MCP Server · github.com
- MCP Guide · github.com
- NotebookLM is now Gemini Notebook · blog.google
- Create and manage notebooks (API) · docs.cloud.google.com
- Remote MCP Deployment · github.com
- Authentication Guide · github.com
- GHSA-92q4-9x75-55rf · github.com
- GHSA-v558-4774-r6wq · github.com
- GHSA-747w-q55c-m74m · github.com
- GHSA-jhrc-qgxv-3c2g · github.com
- Claude Desktop MSIX config path · github.com
- source_add/source_delete fail via MCP · github.com
- CSRF token extraction broken · github.com
- Saved browser profile relaunch gets session revoked · github.com
- roomi-fields/notebooklm-mcp README · github.com
- PleasePrompto/notebooklm-mcp README · github.com