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

• Does Gemini Notebook (NotebookLM) have an API? Yes, through useapi.net, for regular Google accounts: the useapi.net Gemini Notebook API runs on your Google AI subscription, the free plan included, with chat with citations, Deep Research and every Studio output. Google's own Gemini Notebook Enterprise API needs Enterprise licenses in a Google Cloud project and covers only notebooks, sources, sharing and Audio Overviews, so regular Google accounts can't use it (as of October 2026).
• Where do I get an API key / token? Through useapi.net: you call Gemini Notebook with a useapi.net API token, since Google issues no Gemini Notebook API key for regular accounts. Connect your Google account once through the Gemini Notebook setup: sign in with Google, with no cookies to copy and no Google Cloud project. We keep the session signed in, and if Google ever signs it out, you get an email with a one-minute re-add link.
• How much does it cost? Through useapi.net, a podcast, video or answer has no price of its own: it uses the Gemini Notebook usage of your Google AI subscription, and the free plan works. A paid Google AI plan raises that usage, while Google's Enterprise API needs paid per-user licenses in a Google Cloud project (as of October 2026). See the plan comparison.
• How many podcasts can I make? Through useapi.net, as many as your connected Google accounts' usage allows: each account's Gemini Notebook usage refills every 5 hours up to a weekly limit. Connect more Google accounts with POST /accounts, 3 per useapi.net subscription and up to 100 in total, and new jobs go automatically to an account that is healthy and still has usage left.
• Can I generate Gemini Notebook (NotebookLM) podcasts with the API? Through useapi.net, yes: podcasts (Audio Overviews) and Video Overviews too, which Google's Enterprise API doesn't offer (as of October 2026). Send links or text to POST /artifacts and download the podcast as .m4a, a Video Overview as .mp4, slides as .pdf and .pptx or an infographic as .png. The podcast/ example does it in one run.
• More answers: Gemini Notebook API questions.

License

The example code in this repository is released under the MIT License. It covers the example scripts only, not the useapi.net service or API.

About useapi.net

useapi.net provides third-party REST APIs for AI services that run on your subscriptions to them: Google Flow, Google Vids, Muse, Gemini Notebook (NotebookLM), Dreamina, Kling, PixVerse, Mureka, Flow Music, MiniMax, Runway and more. See the model matrix.

Visit our Discord Server or Telegram Channel for any support questions and concerns.