Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add PracticalSwan/agent-skills --skill notebooklm-managementgit clone --depth 1 https://github.com/PracticalSwan/agent-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/practicalswan/agent-skills/notebooklm-management)<a href="https://agentmods.dev/skills/practicalswan/agent-skills/notebooklm-management"><img src="https://agentmods.dev/badge/skills/practicalswan/agent-skills/notebooklm-management/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/practicalswan/agent-skills/notebooklm-management"><img src="https://agentmods.dev/badge/skills/practicalswan/agent-skills/notebooklm-management.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00038 | $0.01253 |
| Opus 5 | $0.00019 | $0.00626 |
| Sonnet 5 | $0.00008 | $0.00251 |
| Haiku 4.5 | $0.00004 | $0.00125 |
Grade A, and why
notebooklm-management scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 123 lines — stays where its author put it; the contents beside it link to each section on GitHub.
NotebookLM MCP Management
Tech Stack Target / Version: NotebookLM current web release, Markdown session capture, and URL-tracked research workflows.
Use this skill when research should be grounded in NotebookLM notebooks instead of a generic web search.
- Leverage native parallel subagent dispatch and 200k+ context windows where available.
Current MCP Reality
This repository already targets a real NotebookLM MCP workflow. The concrete tool surface available in this environment includes:
get_healthlist_notebooks,search_notebooks,select_notebookask_questionadd_notebook,update_notebook,remove_notebooklist_sessions,reset_session,close_sessionsetup_auth,re_auth,cleanup_data
Activation Conditions
Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.
- Querying a specific NotebookLM notebook
- Adding a notebook from a share URL
- Managing a notebook library or switching active notebooks
- Recovering authentication or cleaning NotebookLM state
- Continuing a multi-turn research session
Recommended Workflow
- Call
get_healthfirst to confirm authentication and server readiness. - Reuse an existing session when the task is the same.
- Prefer
search_notebooksorlist_notebooksbefore asking the user to restate what is already in the library. - Use
ask_questioniteratively in the same session for deep work. - Use
setup_authorre_authonly when health indicates auth problems.
Library Management Rules
- Do not add or remove notebooks without explicit user confirmation.
- When adding a notebook, collect URL, description, topics, and use cases first.
- Update metadata instead of creating duplicates when the notebook already exists.
Troubleshooting
- Auth broken:
get_health->re_auth - Stale browser state:
cleanup_data(preserve_library=true)after closing browsers - Wrong context:
reset_sessionor switch notebooks - Ambiguous notebook choice: search the library before creating a new one
What ships with it
12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- CHANGELOG.md 6.2 KB
- examples/add-notebook.py 1.3 KB runs code
- examples/adhoc-query.py 2.5 KB runs code
- examples/library-management.py 2.7 KB runs code
- examples/multi-turn-conversation.py 2.0 KB runs code
- examples/simple-query.py 845 B runs code
- LICENSE.txt 1.0 KB
- references/mcp-tool-reference.md 9.0 KB
- references/troubleshooting.md 12 KB
- references/workflows.md 21 KB
- scripts/notebooklm-helper.py 15 KB runs code
- scripts/README.md 380 B
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +1 lines 2e21fba8082b
- 2d ago Changed b6662ce5adb0
- 5d ago First seen · 122 lines · 38 tokens per session scan A 2dde2f285876
notebooklm-management is a skill published in the GitHub repository PracticalSwan/agent-skills (13 stars, last pushed yesterday), licensed MIT. It adds 38 tokens to every session and 1,253 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
flowise-builder
Use when flowise visual LLM workflow builder — drag-drop chatflows, API endpoints, document loaders, tools. Use when working with flowise builder.
pipedream-workflows
Use when pipedream serverless workflows — triggers, code steps, pre-built actions, data stores, HTTP. Use when working with pipedream workflows.
gws-drive
Google Drive: Manage files, folders, and shared drives.
recipe-save-email-attachments
Find Gmail messages with attachments and save them to a Google Drive folder.
recipe-share-doc-and-notify
Share a Google Docs document with edit access and email collaborators the link.
recipe-bulk-download-folder
List and download all files from a Google Drive folder.