kof-notebooklm-mcp

MCP Server for Google NotebookLM — Create notebooks, add sources, and query AI with citations directly from your IDE.

🧠 Part of the KOF-LocalBrain ecosystem

☕ Support this project

If this project helps you, you can support development here:

👉 https://buymeacoffee.com/keeponfirst

Features

• 🆕 Create Notebooks — Programmatically create and name NotebookLM notebooks
• 📄 Add Sources — Upload URLs or paste text directly into notebooks
• 💬 Ask Questions — Query the AI and get answers with source citations
• 📋 List & Inspect — Browse notebooks and their sources
• 🔐 Persistent Auth — Login once, reuse session across runs

Installation

pip install kof-notebooklm-mcp

Post-install Setup

# Install Playwright browsers
playwright install chromium

# Initialize authentication (opens browser for Google login)
kof-notebooklm-init

Quick Start

As MCP Server

Add to your MCP configuration (mcp_config.json):

{
  "mcpServers": {
    "notebooklm": {
      "command": "kof-notebooklm-mcp",
      "args": []
    }
  }
}

Available Tools

Example Usage (via MCP client)

# Create a research notebook
result = await mcp.call_tool("create_notebook", {"title": "Market Research 2026"})
notebook_id = result["notebook_id"]

# Add a source
await mcp.call_tool("add_source", {
    "notebook_id": notebook_id,
    "source_type": "url",
    "url": "https://example.com/report.pdf"
})

# Ask a question
answer = await mcp.call_tool("ask", {
    "notebook_id": notebook_id,
    "question": "What are the key market trends?"
})
print(answer["answer"])
print(answer["citations"])

Configuration

Environment variables (optional):

Development

git clone https://github.com/keeponfirst/kof-notebooklm-mcp.git
cd kof-notebooklm-mcp

pip install -e ".[dev]"
pytest

License

MIT License - see LICENSE for details.

Related Projects

• KOF-LocalBrain — Local-first brain capture system
• Model Context Protocol — The standard for AI tool integration