notebooklm-management

Manages NotebookLM notebook lifecycles, research imports, and evidence provenance via MCP and CLI adapters.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill notebooklm-management-dagimalemayehuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notebooklm-management
Source: https://github.com/DagimAlemayehuu/AgenticEngineering/tree/main/agentic-engineering/core/dependencies/research/notebooklm-management
Command: npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill notebooklm-management-dagimalemayehuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? NotebookLM research operations fail unpredictably: MCP servers enter cooldowns, task IDs go stale after notebook deletion or consolidation, and parallel imports crash the server. This Skill provides a provider-neutral adapter with documented failure modes, CLI fallbacks, and evidence-preservation rules so research workflows stay recoverable. ## Core Features & Use Cases - Lifecycle Guardrails: Verifies host capability and approved notebook IDs before any operation, treats notebook outputs as untrusted evidence, and requires human approval for deletions. - Failure Recovery Playbooks: Reference notes document MCP cooldown cascades, full server unreachability with valid auth, stale task ID detection, and sequential import patterns with the nlm CLI fallback. - Maintenance Automation: The notebooklm_helper.py script deduplicates sources across notebooks by URL and title, and imports completed research into empty notebooks. - Use Case: A cron job monitoring 12 research notebooks hits MCP timeouts; the Skill's decision tree routes status checks to the nlm CLI with --max-wait 0, completing all checks in under a minute without triggering cooldown. ## Quick Start Use the notebooklm-management skill to check research status across my notebooks and import any completed sources, falling back to the nlm CLI if MCP is unreachable.

Frequently Asked Questions about notebooklm-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check NotebookLM research status when the MCP server is unreachable?▼

Use the nlm CLI directly: run `nlm research status <notebook_id> --compact --max-wait 0`. The CLI bypasses the MCP server process and talks to the NotebookLM API directly, returning results in 2-3 seconds per notebook.

How to import NotebookLM research sources from an in-progress task?▼

Run `nlm research import <notebook_id> <task_id> --timeout 300` even while status shows in_progress. The import pulls whatever sources are discovered so far and is idempotent, so re-running skips already-indexed sources.

Why does the NotebookLM MCP server become unreachable after parallel calls?▼

The MCP server has a failure counter that trips after 3-4 consecutive timeouts, blocking all heavy tools for about 60 seconds. Avoid parallel research_status or research_import calls; use sequential calls or the nlm CLI for batch operations.

Can I reuse stored NotebookLM task IDs in cron jobs?▼

No. Task IDs become permanently invalid when notebooks are deleted, consolidated, or research is re-run. Store only notebook IDs and discover the active task ID at runtime by calling research status without a task ID.

How do I remove duplicate sources across NotebookLM notebooks?▼

Run the helper script with `python3 notebooklm_helper.py dedup`. It scans all notebooks, detects duplicates by normalized URL and title, and deletes them in batches of 20 with per-item fallback on batch failure.