NotebookLM MCP Server

Give your AI agents full control of Google Gemini Notebook (formerly NotebookLM): grounded answers, deep research, podcasts, quizzes, and more — 47 tools, zero hallucinations.

English • Español • Français • Português • Deutsch

Installation • Authentication • Connect Your AI Client • Tool Reference • Recipes • Development

--- ## 💡 What is this? Google's **Gemini Notebook** (renamed from NotebookLM in July 2026) is the best grounded-answer engine on the market: it only answers from the sources you give it, with citations. This MCP server hands that power to your AI agents — Claude, Gemini, Antigravity, Cursor and any other MCP client — so they can build notebooks, run Deep Research, generate podcasts, videos, quizzes, flashcards, reports and mind maps, take notes, and share the results with your team. **All programmatically, with zero hallucinations.** > [!NOTE] > **NotebookLM is now Gemini Notebook.** Google renamed the product on July 16, 2026 (see [notebook.google](https://notebook.google/)). Same product, same notebooks, same API surface — this server keeps working unchanged, and the npm package keeps its `notebooklm-mcp-server` name. ## 🚀 Installation ### Option 1 — Global install (recommended) ```bash npm install -g notebooklm-mcp-server ``` > [!NOTE] > The server checks for updates on startup and keeps itself current automatically. ### Option 2 — Zero-install with NPX ```bash npx -y notebooklm-mcp-server auth # authenticate npx -y notebooklm-mcp-server start # run the server ``` ## 🔑 Authentication 1. Run the interactive login (opens a Chromium window): ```bash npx notebooklm-mcp-server auth ``` 2. Sign in with your Google account. When the notebook list appears, the session cookies (including Google's rotating `__Secure-1PSIDTS` token) are captured and saved to `~/.notebooklm-mcp/auth.json`. 3. Done — the server loads the session automatically and refreshes the rotating token by itself. > [!TIP] > If the session ever expires, run `npx notebooklm-mcp-server auth` again in a terminal, then call the `refresh_auth` MCP tool (or just restart your client) to pick up the new cookies without reconfiguring anything. ## ⚡ Connect Your AI Client ### 🤖 Claude Code ```bash claude mcp add notebooklm -- npx -y notebooklm-mcp-server start ``` ### 💬 Claude Desktop Add to `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "notebooklm": { "command": "npx", "args": ["-y", "notebooklm-mcp-server", "start"] } } } ``` ### 🌌 Antigravity CLI Antigravity's CLI manages MCP servers through a JSON config file: - **Global:** `~/.gemini/config/mcp_config.json` - **Per-workspace:** `.agents/mcp_config.json` in your project ```json { "mcpServers": { "notebooklm": { "command": "npx", "args": ["-y", "notebooklm-mcp-server", "start"] } } } ``` Then type `/mcp` in the Antigravity prompt panel to open the **MCP Manager**: check the connection status ring, reload the config, or inspect logs — no restart needed. Your agents can now cite real sources in every mission. ### 🖥️ Antigravity IDE The IDE reads the same config files as the CLI (`~/.gemini/config/mcp_config.json` or `.agents/mcp_config.json`). Alternatively, open the **MCP Store** panel, choose *Add custom server*, and paste the same JSON snippet. Reload the server list and the NotebookLM tools appear in the agent's toolbox. ### 💎 Gemini CLI ```bash gemini mcp add notebooklm --scope user -- npx -y notebooklm-mcp-server start ``` ### ⌨️ Cursor Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally): ```json { "mcpServers": { "notebooklm": { "command": "npx", "args": ["-y", "notebooklm-mcp-server", "start"] } } } ``` ### 🏄 Windsurf Add the same `mcpServers` block to `~/.codeium/windsurf/mcp_config.json`. ### 🧩 VS Code (Cline) In Cline: **MCP Servers → Configure** and add the same `mcpServers` block shown above. ## 📖 Tool Reference 47 tools, grouped by what they do. Full parameter signatures live in [docs/TOOLS.md](./docs/TOOLS.md). ### 📒 Notebooks | Tool | Description | |------|-------------| | `notebook_list` | List all notebooks with sources and metadata | | `notebook_create` | Create a new notebook | | `notebook_get` | Get one notebook's details and source IDs | | `notebook_rename` | Rename a notebook | | `notebook_delete` | Delete a notebook (requires `confirm`) | | `notebook_summarize` | AI notebook guide: summary + suggested questions | | `prompts_suggest` | AI-suggested prompts to ask about the sources | ### 🔗 Sharing | Tool | Description | |------|-------------| | `notebook_share` | Toggle public link and/or manage collaborators by email | | `notebook_share_status` | Read the current sharing configuration | ### 🖇️ Sources | Tool | Description | |------|-------------| | `notebook_add_url` | Add a website or YouTube video as a source | | `notebook_add_text` | Add pasted text as a source | | `notebook_add_drive` | Add a Google Drive document as a source | | `notebook_add_local_file` | Upload a local PDF / TXT / Markdown file | | `source_get_guide` | AI guide for one source: summary + key topics | | `source_rename` | Rename a source | | `source_check_freshness` | Check if a URL/Drive source has newer content | | `source_sync` | Re-sync a Drive source to the latest content | | `source_delete` | Delete a source (requires `confirm`) | ### 💬 Chat | Tool | Description | |------|-------------| | `notebook_query` | Ask questions about the sources, with citations | | `chat_history_get` | Read the latest conversation's Q&A turns | | `chat_history_delete` | Clear the chat history (requires `confirm`) | | `chat_configure` | Set the chat persona (default / learning guide / custom) and response length | ### 🔍 Research | Tool | Description | |------|-------------| | `research_start` | Launch web or Drive research (fast ≈30s / deep ≈5min) | | `research_poll` | Check research progress and discovered sources | | `research_import` | Import the discovered sources into the notebook | ### 🎨 Studio | Tool | Description | |------|-------------| | `audio_overview_create` | Podcast-style Audio Overview (formats: deep dive, brief, critique, debate) | | `video_overview_create` | Video Overview (9 visual styles, from whiteboard to anime) | | `report_create` | Written report from the sources | | `flashcards_create` | Flashcards (quantity and difficulty options) | | `quiz_create` | Interactive quiz (quantity and difficulty options) | | `infographic_create` | Infographic (landscape / portrait / square) | | `slide_deck_create` | Slide deck | | `data_table_create` | Structured data table | | `studio_poll` | Check generation status of all artifacts | | `studio_delete` | Delete a studio artifact | ### 📦 Artifacts | Tool | Description | |------|-------------| | `artifact_content_get` | Fetch generated content (quiz/flashcards HTML, mind map JSON) | | `artifact_rename` | Rename an artifact | | `artifact_export` | Export an artifact to Google Drive (Docs or Sheets) | ### 📝 Notes & Mind Maps | Tool | Description | |------|-------------| | `note_create` | Create a note | | `note_list` | List all notes | | `note_update` | Update a note's content/title | | `note_delete` | Delete a note (requires `confirm`) | | `mind_map_generate` | Generate a mind map JSON from sources | | `mind_map_save` | Save a mind map to the notebook | | `mind_map_list` | List saved mind maps | | `mind_map_delete` | Delete a mind map | ### ⚙️ System | Tool | Description | |------|-------------| | `refresh_auth` | Reload session cookies from disk after re-running `auth` | ## 🧪 Recipes Real prompts you can paste into any connected agent — it picks the right tools by itself. ### 🎙️ From research question to podcast > *"Research the latest on solid-state batteries with deep research, build a notebook called 'Solid State 2026' with the best sources, and generate a brief audio overview in English. Give me the link when it's done."* The agent chains `notebook_create` → `research_start(mode: deep)` → `research_poll` → `research_import` → `audio_overview_create(format: brief)` → `studio_poll`, and returns the notebook URL with the finished podcast. ### 🎓 Study kit from your PDFs > *"Take the three PDFs in ./lectures, put them in a new notebook, and make me a hard quiz plus flashcards on the key concepts. Show me the quiz questions here."* The agent runs `notebook_add_local_file` per PDF, then `quiz_create(difficulty: hard)` + `flashcards_create`, polls with `studio_poll`, and pulls the questions out with `artifact_content_get`. ### 👥 Team briefing, shared > *"Build a briefing notebook from these five links about our competitor, write a report, export it to Google Docs, and share the notebook with ana@example.com as a viewer."* The agent chains `notebook_add_url` ×5 → `report_create` → `studio_poll` → `artifact_export(format: docs)` → `notebook_share(user_email, user_role: viewer)` — and your teammate finds the notebook and the Doc waiting. ## 🛠️ Troubleshooting | Symptom | Fix | |---------|-----| | `auth` warns the API rejected your cookies right after login | Your Google account enforces **Device Bound Session Credentials (DBSC)** — default-on for Workspace and most personal accounts. DBSC ties the session to a device-held key, so cookies exported from the browser are refused by the API. Cookie-extraction clients cannot bypass this; use a Google account without DBSC enforcement. | | `Authentication expired` right after logging in | Update to ≥ 3.0.8 — older versions missed Google's rotating `__Secure-1PSIDTS` token. The server now captures and auto-refreshes it. | | `Authentication failed` after weeks of use | Google sessions eventually expire. Run `npx notebooklm-mcp-server auth`, then call the `refresh_auth` tool. | | Studio generation stuck on `pending` | Long sources take a while — keep polling `studio_poll`; audio/video can take several minutes. | | RPC errors after a Google update | Google occasionally rotates internal build labels. Update the package; if it persists, open an issue. | ## 🧑‍💻 Development ```bash git clone https://github.com/moodRobotics/notebooklm-mcp-server.git cd notebooklm-mcp-server npm install npm run build npm run typecheck ``` Architecture notes live in [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md), the roadmap in [docs/ROADMAP.md](./docs/ROADMAP.md). ## 🌐 Localization This README is available in [English](./README.md), [Español](./README.es.md), [Français](./README.fr.md), [Português](./README.pt.md) and [Deutsch](./README.de.md). If you edit one, please keep the others in sync (`npm run docs:check`). ## 📄 License MIT — Developed with ❤️ by [moodRobotics](https://github.com/moodRobotics). > [!IMPORTANT] > This is an unofficial community project. It is not affiliated with or endorsed by Google. It relies on reverse-engineered internal APIs that may change without notice; use it with a Google account you are comfortable automating.