notebooklm

Productivity Community

Skill notes

Installation

From PyPI (Recommended for AI agents — Python-version-aware): Full install matrix (extras, headless servers, contributor flow): Installation guide on GitHub. From GitHub (use latest release tag, NOT main branch): ⚠️ DO NOT install from main branch (pip install git+https://github.com/teng-lin/notebooklm-py). The main branch may contain unreleased/unstable changes. Always use PyPI or a specific release tag, unless you are testing unreleased features.

Prerequisites

IMPORTANT: Before using any command, you MUST authenticate: If commands fail with authentication errors, re-run notebooklm login.

CI/CD, Multiple Accounts, and Parallel Agents

For automated environments, multiple accounts, or parallel agent workflows: Variable · Purpose NOTEBOOKLM_HOME · Custom config directory (default: ~/.notebooklm) NOTEBOOKLM_PROFILE · Active profile name (default: default) NOTEBOOKLM_AUTH_JSON · Inline auth JSON - no file writes needed

Agent Setup Verification

Before starting workflows, verify auth is in place. Use --test --json (not bare --json) — bare --json only proves the cookie file parses; --test makes a network call and proves the cookies still authenticate against Google. notebooklm auth check --test --json → require BOTH "status": "ok" AND "checks.token_fetch": true. Bare "status": "ok" (without --test) is a false-positive trap — a stale cookie file passes the parse check.

When This Skill Activates

Explicit: User says "/notebooklm", "use notebooklm", or mentions the tool by name Intent detection: Recognize requests like: "Create a podcast about [topic]" "Summarize these URLs/documents" "Generate a quiz from my research"

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Productivity
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@teng-lin · no license declared
Token usage
Moderate
Setup complexity
Manual integration
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
Node.js · Python >=3.13
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview notebooklm.preview
# Command Output Formats

$ notebooklm create "Research" --json
{"notebook": {"id": "abc123de-...", "title": "Research", "created_at": null}}
# parse with: jq -r .notebook.id

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.