nlm  by tmc

CLI for AI-powered research and content generation

Created 1 year ago
362 stars

Top 77.5% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a command-line interface (CLI) and an MCP server for Google NotebookLM, enabling programmatic interaction with notebooks, sources, notes, and artifact generation. It targets developers and power users seeking to automate workflows or integrate NotebookLM capabilities into other applications, offering a flexible way to manage and leverage AI-generated insights.

How It Works

The CLI authenticates by reading browser cookies from Chrome, Brave, or Edge, or by accepting an explicit authentication token. It exposes a rich set of commands for managing notebook content, adding various source types (URLs, files, text), creating notes, and generating artifacts like audio overviews, video walkthroughs, and slide decks. A key feature is the integrated Model Context Protocol (MCP) server, which exposes NotebookLM operations as tools for AI assistants, facilitating integration with other AI systems.

Quick Start & Requirements

  • Installation: go install github.com/tmc/nlm/cmd/nlm@latest
  • Prerequisites: Go toolchain.
  • Authentication: Requires access to browser cookies (Chrome, Brave, Edge) or an auth token. Supports multi-account selection via the -authuser flag.
  • Setup Time: Minimal, dependent on Go installation and authentication setup.
  • Documentation: Usage examples provided directly in the README.

Highlighted Details

  • Artifact Creation: Supports generating audio overviews, video walkthroughs, and slide decks from notebook content.
  • Content Transformation: Offers numerous commands for processing notebook content, including summarization, critique, rephrasing, expansion, verification, explanation, and generating study guides, FAQs, timelines, and mindmaps.
  • MCP Server: Includes a built-in server that exposes NotebookLM operations as tools for AI assistants, compatible with MCP clients like Claude Code.
  • Deep Research: Enables initiating "deep research" sessions within notebooks for complex queries.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels (like Discord/Slack) are present in the provided README.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: The MIT license is permissive and generally compatible with commercial use and closed-source applications.

Limitations & Caveats

The interactiveaudio package is noted as experimental. Authentication relies on browser cookies or tokens, which may require manual handling or specific browser configurations. The full range of MCP tools available might extend beyond those explicitly listed.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
28 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.