NotebookLM Manager

Query orchestration and notebook registry management.

Instructions

CRITICAL CONSTRAINT

This skill MUST NOT call any

mcp__claude-in-chrome__*

1. Query Detection

Extract from user message:

• notebook_id

  : Which notebook (e.g., "claude-docs")

• question

  : What to ask

2. Notebook Lookup

Read

${SKILL_ROOT}/data/library.json

• File not found → Create

  data/

  folder and files with

  []

• Not found → Show "Did you mean?" with similar IDs

3. Chat History Confirmation (First Query Only)

Before the first query to a notebook, ask user about chat history:

AskUserQuestion({
  questions: [{
    question: "Clear NotebookLM chat history before querying?",
    header: "History",
    options: [
      { label: "No (Recommended)", description: "Keep previous context, faster response" },
      { label: "Yes", description: "Start fresh, may involve UI modal interaction" }
    ],
    multiSelect: false
  }]
})

Pass result to agent as

clearHistory: true/false

Note: Clearing history may trigger a confirmation modal in NotebookLM, which can slow down automation. Default "No" is recommended.

Track per-notebook first-query status within the current conversation. After asking once for a given notebook URL, skip the confirmation for subsequent queries to the same URL in the same session.

4. Agent Invocation

Task({
  subagent_type: "notebooklm-connector:chrome-mcp-query",
  prompt: `Execute the workflow: Input parsing → Tab setup → Title extraction → Submit question → Poll response → Output and exit

URL: {url}
Question: {question}
mode: query
clearHistory: {true/false}

Output the response immediately upon receiving it and exit.`
})

Follow-up queries use the same Task format with the follow-up question. The agent's STEP 1 automatically reuses the existing tab for the same URL.

4.1 Agent Result Parsing

After Task returns, check the agent output:

ERROR_TYPE: CHROME_NOT_CONNECTED

ERROR_TYPE: AUTH_REQUIRED

ERROR_TYPE:

Chrome Connection Troubleshooting (show to user):

1. Verify Chrome or Edge browser is running
2. Chrome →

   chrome://extensions

   → Ensure "Claude in Chrome" extension is enabled
3. In Chrome, click extension icon → Side panel → Click "Connect" button
   • If a login screen appears, sign in with your Claude account (Pro/Max/Team/Enterprise required)
4. In Claude Code:

   /chrome

   → Select "Reconnect extension"
5. If this is your first time connecting, restart the browser to register the native messaging host, then repeat steps 3-4
6. Retry the query

5. Post-Query Coverage Analysis (MANDATORY — DO NOT SKIP)

After EVERY successful Task(chrome-mcp-query) return, perform this checklist BEFORE presenting any answer. The PostToolUse hook will also remind you via

COVERAGE_REMINDER

DO NOT present the answer yet. DO NOT generate "Suggested follow-ups" yet.

STEP A: ANALYZE

Re-read user's original message. List ALL keywords/topics.

STEP B: VERIFY

Each keyword: ✅ covered / ❌ missing

STEP C: QUERY (if gaps)

Launch follow-up:

Task(subagent_type: "notebooklm-connector:chrome-mcp-query", same URL, missing topic question)

STEP D: COMPLETE

All covered OR 3 follow-ups → Synthesize and present (Section 6 format). Max 3 follow-ups. After limit: AskUserQuestion to confirm whether to continue.

6. Response Format

**Notebook**: [Title] (`{id}`)

**Answer**: [response]

**Citations**:
[1] "quote" - Source: [doc]

---
**Suggested follow-ups**:
- [question 1]
- [question 2]

Commands

See

references/commands.md

list

add <url>

show <id>

search <query>

Storage

Location:

${SKILL_ROOT}/data/

data/
├── library.json        # Active notebooks (index)
├── archive.json        # Archived notebooks
└── notebooks/{id}.json # Full metadata (on-demand)

Initialization:

• If

  data/

  folder does not exist, create it
• If

  library.json

  does not exist, create with:

  {"notebooks": {}, "schema_version": "1.0", "updated_at": "<ISO timestamp>"}

• If

  archive.json

  does not exist, create with:

  {"notebooks": {}, "schema_version": "1.0", "updated_at": "<ISO timestamp>"}

• If

  notebooks/

  folder does not exist, create it
• Each

  notebooks/{id}.json

  must include

  "schema_version": "1.0"

  as the first field

Tool Boundaries

• Use: Read, Write, Task, AskUserQuestion
• Do NOT use: Chrome MCP tools directly (

  mcp__claude-in-chrome__*

  )

References

• references/commands.md

  - Full command reference

• references/schemas.md

  - JSON schemas