KastorFlow NotebookLM MCP

A free, local MCP server for NotebookLM (now Gemini Notebook). Connect Claude Desktop, Claude Code, Cursor or any other MCP client to your notebooks through the KastorFlow Chrome extension.

Status: this works with the next KastorFlow update, which turns AI agents on. The KastorFlow version in the Chrome Web Store today can't connect to it yet, and the npm package kastorflow-notebooklm-mcp is published with that update. Watch this repository for the release.

Google has no public API for notebooklm.google.com. kastorflow-notebooklm-mcp is an unofficial, local way in for AI agents: it runs on your computer, and every call goes through the KastorFlow extension in your own signed-in Chrome. Your agent can list notebooks; read sources, notes and artifacts; get a notebook's summary; create notebooks and add links or text; start research; rename, tag and write notes; and generate one Studio artifact at a time. These are the tools of KastorFlow's Free plan.

KastorFlow is independent. It is not affiliated with, endorsed by or sponsored by Google. NotebookLM and Gemini are trademarks of Google LLC.

AI agents work on every KastorFlow plan. This client lists the Free-plan tools only; for Pro and Pro+ tools KastorFlow's full companion, kastorflow-mcp, comes with the same update. The extension checks your plan on every call either way, so this client's list is what it shows, not what decides.

This repository is generated from KastorFlow's own source and published here. Open issues here.

How it works

your agent app ──stdio──▶ kastorflow-notebooklm-mcp ──local socket──▶ native host ──Chrome──▶ KastorFlow extension ──▶ NotebookLM

Nothing listens on a network port and nothing passes through a server. Both companions register the same native host (com.kastorflow.mcp) in the same folder, so installing this one replaces the full companion's registration, and installing the full one replaces this one's.

Set up

1. Install the bridge once (Node.js 20 or later): npx kastorflow-notebooklm-mcp setup

2. Connect an agent in KastorFlow: Settings → AI agents → Connect an agent. Choose the notebooks and what the agent may do; KastorFlow shows the setup for your agent app.

3. Add it to your agent app, with kastorflow-notebooklm-mcp in place of kastorflow-mcp:

   {
     "mcpServers": {
       "kastorflow": {
         "command": "npx",
         "args": ["-y", "kastorflow-notebooklm-mcp"],
         "env": {
           "KASTORFLOW_PROFILE_NONCE": "…",
           "KASTORFLOW_PAIRING_TOKEN": "…"
         }
       }
     }
   }
   

   On Windows use "command": "cmd" and "args": ["/c", "npx", "-y", "kastorflow-notebooklm-mcp"]. Claude Code: claude mcp add kastorflow -e KASTORFLOW_PROFILE_NONCE=… -e KASTORFLOW_PAIRING_TOKEN=… -- npx -y kastorflow-notebooklm-mcp

Chrome must be open with KastorFlow for calls to work.

The tools

What you allow	Tools
Read	list_notebooks, list_sources, read_source, describe_notebook, list_notes, list_artifacts, read_artifact, list_tags
Add	create_notebook, add_sources
Organize	rename_notebook, rename_source, write_note, tag_sources
Research	start_research
Create	generate_artifacts
Send or share	share_notebook
Local records	save_research, find_records, read_record, read_history, propose_decision, revise_proposal, publish_record, publication_status
Always	connection_status, job_status, request_status

A tool not on this list answers that this client has Free-plan tools only. Sharing a notebook asks you in KastorFlow first. Deleting, merging, moving and refreshing are not agent tools.

Stop or remove

• Pause or revoke a connection in KastorFlow → Settings → AI agents. It stops on its next call.
• Uninstall the bridge: npx kastorflow-notebooklm-mcp uninstall.

Questions

Is there a NotebookLM API? Google has no public API for notebooklm.google.com. This client gives AI agents an unofficial, local one through the KastorFlow extension.

Does it work with Gemini Notebook? Yes. NotebookLM is now Gemini Notebook (notebook.google.com); it is the same service and the same notebooks.

Is it free? Yes. The client is Apache-2.0, and every tool it lists is on KastorFlow's Free plan.

Where does my data go? It stays on your computer. The client talks only to the KastorFlow extension over a local pipe or socket. What your agent reads goes to your agent app, and that app's own privacy policy applies.

License

Apache-2.0 (see LICENSE).