Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jacob-bd/notebooklm-mcp-cli/llms.txt

Use this file to discover all available pages before exploring further.

AI skills are expert reference guides that you install directly into your AI assistant’s context. When an AI tool reads a skill file on startup, it gains accurate, up-to-date knowledge of nlm commands, workflows, best practices, and troubleshooting tips — without needing to be told anything in a system prompt. Think of a skill as a compact manual that travels with your AI session wherever it runs. Skills are distinct from the MCP server integration. The MCP server gives an AI assistant functional access to NotebookLM — the ability to actually call the API and manipulate notebooks. A skill gives the AI reference knowledge about how to use those tools well: the right flags, correct argument order, known pitfalls, and recommended workflows. You can install one without the other, but they work best together.
nlm setup (and nlm setup add <tool>) configures the MCP server transport — the connection that lets an AI assistant call NotebookLM’s API. nlm skill install <tool> installs AI reference documentation into the tool’s skill/rules directory. These are separate concerns and separate commands.

​
Installing Skills

Run the appropriate install command for your AI tool. By default, skills are installed at the user level (your home directory), so they apply to every project you open.
1

Claude Code

nlm skill install claude-code
Installs SKILL.md and reference files into ~/.claude/skills/nlm-skill/.
2

Cursor

nlm skill install cursor
Installs into ~/.cursor/skills/nlm-skill/.
3

Cline

nlm skill install cline
Installs into ~/.cline/skills/nlm-skill/.
4

OpenClaw

nlm skill install openclaw
Installs into ~/.openclaw/workspace/skills/nlm-skill/.
5

Codex / Gemini CLI / Generic agents

All three of the following commands install to the same shared path — they are interchangeable aliases for the cross-tool compatible ~/.agents/skills/nlm-skill/ location:
nlm skill install agents      # Generic name
nlm skill install codex       # Alias for OpenAI Codex CLI
nlm skill install gemini-cli  # Alias for Google Gemini CLI
Gemini CLI (v0.33.1+) and Codex both read from .agents/skills/.
6

OpenCode

nlm skill install opencode
Installs into ~/.config/opencode/skills/nlm-skill/.
7

Antigravity

nlm skill install antigravity
Installs into ~/.gemini/antigravity/skills/nlm-skill/.
8

Alef Agent

nlm skill install alef-agent
Alef Agent uses a different base path and requires tool-specific frontmatter (type: tool, status: approved). Installs into ~/.alef-agent/workspace/skills/nlm-skill/.
9

Hermes Agent

nlm skill install hermes
Installs into ~/.hermes/skills/nlm-skill/ by default. Set the HERMES_HOME environment variable before installing if you keep your Hermes data in a non-default location — the skill will be placed at $HERMES_HOME/skills/nlm-skill/ instead.

​
Project-Level Install

Add --level project to install into the current working directory instead of your home directory. This is useful for per-repository skill configurations: 
nlm skill install claude-code --level project
# Installs to ./.claude/skills/nlm-skill/

nlm skill install agents --level project
# Installs to ./.agents/skills/nlm-skill/

​
Supported Tools at a Glance

Claude Code

Install path (user): ~/.claude/skills/nlm-skill/Install path (project): .claude/skills/nlm-skill/
nlm skill install claude-code

Cursor

Install path (user): ~/.cursor/skills/nlm-skill/Install path (project): .cursor/skills/nlm-skill/
nlm skill install cursor

Cline

Install path (user): ~/.cline/skills/nlm-skill/Install path (project): .cline/skills/nlm-skill/
nlm skill install cline

Agents / Codex / Gemini CLI

Install path (user): ~/.agents/skills/nlm-skill/Install path (project): .agents/skills/nlm-skill/
nlm skill install agents
nlm skill install codex
nlm skill install gemini-cli

OpenCode

Install path (user): ~/.config/opencode/skills/nlm-skill/Install path (project): .opencode/skills/nlm-skill/
nlm skill install opencode

Antigravity

Install path (user): ~/.gemini/antigravity/skills/nlm-skill/Install path (project): .agents/skills/nlm-skill/
nlm skill install antigravity

OpenClaw

Install path (user): ~/.openclaw/workspace/skills/nlm-skill/Install path (project): .openclaw/workspace/skills/nlm-skill/
nlm skill install openclaw

Alef Agent

Install path (user): ~/.alef-agent/workspace/skills/nlm-skill/Install path (project): .alef-agent/workspace/skills/nlm-skill/
nlm skill install alef-agent

Hermes Agent

Install path (user): ~/.hermes/skills/nlm-skill/ (or $HERMES_HOME/skills/nlm-skill/ if HERMES_HOME is set)Install path (project): .hermes/skills/nlm-skill/
nlm skill install hermes

​
Managing Skills

​
Check Installation Status

nlm skill list
Displays a table showing every supported tool, its description, and whether the skill is installed at user and/or project level. Outdated versions are highlighted in yellow. 
┌─────────────┬──────────────────────────────┬──────┬─────────┐
│ Tool        │ Description                  │ User │ Project │
├─────────────┼──────────────────────────────┼──────┼─────────┤
│ claude-code │ Claude Code CLI and Desktop  │  ✓   │    -    │
│ cursor      │ Cursor AI editor             │  -   │    -    │
│ agents      │ Generic agent skill          │  ✓   │    -    │
└─────────────┴──────────────────────────────┴──────┴─────────┘

​
View Skill Content

nlm skill show
Prints the full content of the SKILL.md file to your terminal so you can review what gets installed.

​
Update Installed Skills

nlm skill update              # Update all outdated skills
nlm skill update claude-code  # Update a specific tool only
After upgrading notebooklm-mcp-cli, run nlm skill update to push the latest reference content to all your AI tools.

​
Uninstall a Skill

nlm skill uninstall claude-code
nlm skill uninstall agents --level project
Removes the skill directory (or section, for AGENTS.md-format tools) from the install location.

​
Verb-First Alternatives

The CLI supports both noun-first and verb-first command styles. The following are equivalent to their nlm skill counterparts: 
# Install
nlm install skill claude-code
nlm install skill agents --level project

# List
nlm list skills
Use whichever style feels more natural in your workflow.

Build docs developers (and LLMs) love

Get started for freeTalk to us