nblm-rs

Unofficial NotebookLM Enterprise API client

🦀 Rust CLI: Command-line tool for shell scripting and automation 🐍 Python SDK: Python bindings for integration in Python applications

[!IMPORTANT] This project targets the NotebookLM Enterprise API only. Google hasn’t published an API for the consumer edition or general Google Workspace tenants as of 2025-10-25.

Known API Issues

[!NOTE] The NotebookLM API is currently in alpha and has several known limitations. See API Limitations for details.

Motivation

In September 2025, Google released the NotebookLM Enterprise API, enabling programmatic access to NotebookLM features for the first time.

While you can interact with the API using simple curl commands, this approach has several limitations that this project addresses:

Challenges with Direct API Calls

• Authentication complexity

  • Problem: Managing OAuth tokens, handling token refresh, and ensuring secure credential storage
  • Solution: Seamless gcloud CLI integration with automatic token caching and refresh

• Manual request construction

  • Problem: Writing JSON payloads by hand, managing resource names, and handling API versioning
  • Solution: Type-safe CLI flags and Python SDK with intelligent defaults and validation

• Error handling

  • Problem: Cryptic HTTP error codes without context or recovery suggestions
  • Solution: Clear, actionable error messages with automatic retries for transient failures

• Batch operations

  • Problem: Writing loops to process multiple items, managing API call sequences
  • Solution: Built-in batch commands with simplified syntax for multiple operations

• Output parsing

  • Problem: Manual JSON parsing and extracting specific fields from responses
  • Solution: Structured output formats and JSON mode for easy integration with jq and other tools

Project Goals

This project provides production-ready tools that make the NotebookLM API accessible and reliable:

• Rust CLI: Fast, cross-platform binary for shell scripting and automation
• Python SDK: Idiomatic Python bindings for application integration
• Type safety: Compile-time checks prevent common API usage errors
• Developer experience: Intuitive commands and clear documentation

Features (Verified as of 2025-10-25)

[!NOTE] The NotebookLM API is currently in alpha. Some features may not work as documented due to API limitations. See Known API Issues for details.

Notebooks

Sources

Audio Overview

Sharing

Installation

CLI (Rust)

# From crates.io
cargo install nblm-cli

# Or build from source
git clone https://github.com/K-dash/nblm-rs.git
cd nblm-rs
cargo build --release

Python SDK

pip install nblm

Prerequisites: Google Cloud project with NotebookLM API enabled

Detailed Installation Guide: See Installation Documentation for platform-specific instructions and troubleshooting.

Quick Start

CLI

# 1. Authenticate
gcloud auth login

# 2. Set environment variables
export NBLM_PROJECT_NUMBER="123456789012"  # Get from GCP console
export NBLM_LOCATION="global"
export NBLM_ENDPOINT_LOCATION="global"

# 3. Create a notebook
nblm notebooks create --title "My Notebook"

# 4. Add a source
nblm sources add \
  --notebook-id YOUR_NOTEBOOK_ID \
  --web-url "https://example.com" \
  --web-name "Example"

Python

from nblm import NblmClient, GcloudTokenProvider, WebSource

# Initialize client
client = NblmClient(
    token_provider=GcloudTokenProvider(),
    project_number="123456789012"
)

# Create a notebook
notebook = client.create_notebook(title="My Notebook")

# Add sources
response = client.add_sources(
    notebook_id=notebook.notebook_id,
    web_sources=[WebSource(url="https://example.com", name="Example")]
)

Platform Support

Platform	CLI	Python SDK
Linux
macOS
Windows

Documentation

Complete guides and API references:

• Getting Started - Installation, authentication, configuration
• CLI Reference - All commands, options, and examples
• Python SDK Reference - API reference and usage patterns
• API Limitations - Known issues and workarounds

Related Resources

• NotebookLM API Documentation - Official API documentation
• NotebookLM API Reference - API reference

Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup and guidelines.

[!IMPORTANT] All pull requests must pass cargo make all (Rust) and cargo make py-all (Python) before being merged.

License

MIT