CategoryWeightCategory scoreContribution
Securityprompt, exec, net, exfil, eval
35%
35.0 pts
Supply chainhash, typosquat, maintainer, lockfile
20%
20.0 pts
Maintenancestaleness, pinning, CI
15%
15.0 pts
TransparencySKILL.md, perms, README
15%
15.0 pts
Communityinstalls, verify, response
15%
15.0 pts
Findings & checks · 0 flagged
Security
✓—All security checks passedNo findings in this category for the latest scan.pass
Supply chain
✓—All supply chain checks passedNo findings in this category for the latest scan.pass
Maintenance
✓—All maintenance checks passedNo findings in this category for the latest scan.pass
Transparency
✓—All transparency checks passedNo findings in this category for the latest scan.pass
Community
✓—All community checks passedNo findings in this category for the latest scan.pass
Every scanned point with the score it earned and what moved between them.
f1cc484
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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
<a href="https://www.buymeacoffee.com/keeponfirst" target="_blank"> <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" height="45" /> </a>
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-mcpPost-install Setup
# Install Playwright browsers
playwright install chromium
# Initialize authentication (opens browser for Google login)
kof-notebooklm-initQuick Start
As MCP Server
Add to your MCP configuration (mcp_config.json):
{
"mcpServers": {
"notebooklm": {
"command": "kof-notebooklm-mcp",
"args": []
}
}
}Available Tools
| Tool | Description |
|---|---|
health_check | Verify connection and auth status |
list_notebooks | List all notebooks |
create_notebook | Create a new notebook (with optional title) |
get_notebook | Get notebook details |
list_sources | List sources in a notebook |
add_source | Add URL or text source |
ask | Query notebook AI with citations |
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):
| Variable | Description | Default |
|---|---|---|
KOF_NOTEBOOKLM_HEADLESS | Run browser in headless mode | true |
KOF_NOTEBOOKLM_PROFILE_DIR | Browser profile directory | ~/.kof-notebooklm/profile |
Development
git clone https://github.com/keeponfirst/kof-notebooklm-mcp.git
cd kof-notebooklm-mcp
pip install -e ".[dev]"
pytestLicense
MIT License - see LICENSE for details.
Related Projects
- KOF-LocalBrain — Local-first brain capture system
- Model Context Protocol — The standard for AI tool integration