Gemini Notebook API (NotebookLM API) examples

Runnable Node.js, Python and bash examples, an agent skill, a Colab notebook and n8n workflows for the Gemini Notebook API (NotebookLM API): the Gemini Notebook API by useapi.net, a third-party REST API that drives Google Gemini Notebook (formerly NotebookLM) on your Google AI subscription: Free, Plus $4.99, Pro $19.99, Ultra $99.99 or Ultra $199.99 a month (as of October 2026). Create notebooks, add web pages, YouTube videos, Drive files and uploads as sources, chat with citations, run Deep Research, and generate Audio Overviews (the Gemini Notebook podcast), Video Overviews, slide decks, infographics, reports, quizzes, flashcards and mind maps.

Google offers no Gemini Notebook API for regular Google accounts, and this one works on the free plan too. useapi.net is not affiliated with Google.

It runs unattended. Connect several Google accounts and each new job goes to one that is healthy and still has usage left, jobs are tracked server-side (poll or get a replyUrl webhook), and when every account is out of usage the 429 carries the reset time. Your code decides what to do with the load (wait, route to another account, slow down), so nobody has to watch Gemini Notebook's limits or start the next batch by hand.

| Example | What it does | Tutorial | Tutorial date | |---|---|---|---| | podcast/ | Turn web pages and YouTube videos into a Gemini Notebook Audio Overview and download the .m4a | How to automate Gemini Notebook | September 29, 2026 | | deep-research/ | Run Deep Research on a question and save the report as Markdown with its cited sources | How to automate Gemini Notebook | September 29, 2026 | | tutorial-demo/ | The tutorial's two bash scripts: every step from creating a notebook to a Video Overview and a revised slide deck | How to automate Gemini Notebook | September 29, 2026 | | skills/notebooklm-podcast/ | An agent skill for Claude Code, Codex and other agents: links, text and files → Audio Overview .m4a or Video Overview .mp4 (bash and curl) | Skill README | October 4, 2026 | | notebooks/ | A Google Colab notebook: paste your token, list your links, play the podcast inline and download it | Open in Colab | October 4, 2026 | | n8n/ | n8n workflows: the Gemini Notebook (NotebookLM) Podcast App (a form and a weekly RSS feed, with an in-browser player), plus minimal links → podcast and RSS → podcast versions | n8n README | October 5, 2026 | | dify-plugin/ | A Dify tool plugin: 56 Gemini Notebook tools for Dify workflows, chatflows and agents (notebooks, sources, cited chat, Deep Research, Audio and Video Overviews, slides, reports, quizzes, mind maps), with files returned to Dify and a UI in English, Chinese, Japanese and Portuguese | Plugin README | October 18, 2026 |

Quick start

You need Node.js 21 or newer, or Python 3.8 or newer (no dependencies to install), a useapi.net API token, and a Google account connected with the Gemini Notebook setup. One $15/month subscription covers every useapi.net API. Connecting a Google account by hand? The Google Account Setup scripts (Windows, macOS, Linux) open a clean, single-use Brave profile with device-bound sessions switched off, so the cookies you copy keep working.

git clone https://github.com/useapi/notebooklm-api.git
cd notebooklm-api/podcast
node ./podcast.mjs <API_TOKEN> <EMAIL>
# or, equivalently, with Python:
python3 ./podcast.py <API_TOKEN> <EMAIL>

Edit prompts.json in each folder to queue your own sources or questions. Every parameter is documented in the API reference, and a Postman collection is available too.

No terminal? Open the Colab notebook and run it in your browser. Using Claude Code, Codex or another coding agent? Install the skill and ask for a podcast in plain words:

npx skills add useapi/notebooklm-api --skill notebooklm-podcast

MCP server

useapi.net also runs a hosted Model Context Protocol server for Gemini Notebook (NotebookLM), so an AI assistant such as Claude Code, Cursor or VS Code Copilot can work with your notebooks on your Google account. It has 57 tools: notebooks, sources (links, YouTube, files, Google Drive, Google Play Books), chat with citations, notes, labels, sharing, collections, Deep Research and every Studio output (Audio and Video Overviews, slides, infographics, reports, tables, quizzes, flashcards, mind maps). Nothing to install or run locally, and no cookies to copy: you connect the account once and we keep it signed in.

• Endpoint: https://api.useapi.net/v1/gemini-notebook/mcp
• Transport: Streamable HTTP
• Authorization: your useapi.net API token in the Authorization: Bearer … header, and a Google account connected with the Gemini Notebook setup
• Listed in the official MCP Registry as net.useapi/gemini-notebook

Claude Code:

claude mcp add --transport http useapi-gemini-notebook https://api.useapi.net/v1/gemini-notebook/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "useapi-gemini-notebook": {
      "url": "https://api.useapi.net/v1/gemini-notebook/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code, Windsurf and the full tool list: Gemini Notebook MCP server (NotebookLM MCP server) docs. useapi.net is a third-party API, not affiliated with Google.

Use with Claude Code

This repo is also a Claude Code plugin marketplace. The plugin adds the hosted Gemini Notebook MCP server (NotebookLM MCP server) and the notebooklm-podcast agent skill, and reads your token from the USEAPI_TOKEN environment variable, so set it before you start Claude Code:

export USEAPI_TOKEN=user:12345-...      # your useapi.net API token

Then, inside Claude Code:

/plugin marketplace add useapi/notebooklm-api
/plugin install notebooklm@useapi-notebooklm

On Claude Code 2.1.275 or later, /plugin install notebooklm --marketplace useapi/notebooklm-api does both in one step. Run /mcp to check that useapi-gemini-notebook is connected.

Use with Gemini CLI

This repo is also a Gemini CLI extension with the same MCP server and the notebooklm-podcast agent skill:

gemini extensions install https://github.com/useapi/notebooklm-api

The install asks for your useapi.net API token and keeps it in the system keychain. Change it later with gemini extensions config useapi-notebooklm, and check the connection with gemini mcp list. The notebooklm-podcast skill's scripts read USEAPI_TOKEN from your shell, so export it as well if you use the skill.

Use in Dify

The dify-plugin/ folder is a Dify tool plugin, "Gemini Notebook (NotebookLM) by useapi.net", with 56 tools for workflows, chatflows and agents: notebooks, sources (links, YouTube, text, Google Drive, file uploads), chat with citations, Deep Research, and every Studio output. Generation tools wait for the job and return the Audio Overview .m4a, Video Overview .mp4, slides .pdf/.pptx or infographic .png as Dify files, plus variables (notebook, jobid, answer, text) for the next node.

1. Install it from the Dify Marketplace, or download the .difypkg from Releases and upload it under Plugins > Install plugin > Local package file.
2. In Tools, authorize "Gemini Notebook (NotebookLM) by useapi.net" with your useapi.net API token, and optionally a default Google account email.
3. Add a tool to a workflow. For links to a podcast in one node, use "Generate Audio Overview (podcast)" with urls set to your links: it creates the notebook, waits, and returns the .m4a.

The labels are in English, Simplified Chinese, Japanese and Brazilian Portuguese. Setup, every tool with its endpoint, and workflow and agent examples: Dify plugin README.

Articles and videos

• Gemini Notebook (NotebookLM) API Options in 2026: Google Enterprise API, Free Libraries or a Hosted API
• How to Automate Gemini Notebook (NotebookLM) with the API: Deep Research, Chat, Audio Overviews and a Lot More
• Turn a Web Page or YouTube Video into a Podcast with Gemini Notebook (NotebookLM): A Real Example
• How to Turn Web Pages, YouTube Videos and RSS Feeds into Gemini Notebook (NotebookLM) Podcasts with n8n
• Chinese-language tutorial (中文教程): 用 Gemini Notebook API（NotebookLM API）生成中文播客
• YouTube: NotebookLM has no API. Now it does: podcasts, video, slides from one REST call

Common questions

<!-- Official API figures in these answers, re-read 2026-10-20 (useapi.net/docs/api-g