Provides integration with Google NotebookLM, enabling AI agents to query notebooks, save dated memory sources, search and read memories, and manage session authentication via the BrainBridge MCP server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@BrainBridge Save this thought to my personal brain: shipped v2 today."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Give any AI agent a brain that remembers. BrainBridge is an MCP server that connects Claude Code / Cursor / Codex / any MCP client to your NotebookLM notebooks ("brains") — ask with citations, save memories as dated sources, read everything back. Zero context loss.
Auth is a one-time Google popup (
brain_login) — no cookies, no copy-paste. Lazy auth: ANY memory tool auto-opens the popup when the session is missing. Fallback chain: popup (system Chrome → bundled Chromium) → silent browser cookies → clear instructions. A keepalive loop keeps the session alive for weeks. Your memory stays in your own Google account (cloud); this server runs locally / self-hosted.
Tool | What it does |
| Session health check (go/no-go) |
| List all your brains (notebooks) with IDs |
| Query a brain — answers cite your sources |
| Persist anything as a dated Markdown memory source |
| Search your memory archive |
| Read a full entry |
| Session-start digest — "what you already know" |
| 🔐 Opens the Google sign-in popup (session auto-saves) |
| Silent auth from your installed Chrome/Firefox/Brave |
| Clear local session (never signs you out of Google) |
| Rotate the token now + report status |
Related MCP server: NotebookLM MCP Server
Persistence: session stored in ~/.notebooklm/profiles/default/storage_state.json
(Playwright state) — every call reuses it, no re-login.
Keepalive loop (official cadence = 15 min):
nohup ./keepalive.sh >/tmp/nblm-keepalive.log 2>&1 & # rotates __Secure-1PSIDTS
./keepalive.sh check # one-shot refresh + statusDesktop: cron/launchd/systemd */15 * * * * /path/to/brainbridge/keepalive.sh check.
Tool-level: brain_keepalive for refresh + status on demand.
The bundled notebooklm MCP server also runs a keepalive=600s client task.
./setup.sh # pip deps + Playwright Chromium (for the login popup)
./run.sh # start the MCP server (stdio)
# or: python3 -m brainbridgeConnect to Claude Desktop / Cursor:
{
"mcpServers": {
"brainbridge": { "command": "python3", "args": ["-m", "brainbridge"], "cwd": "/absolute/path/to/brainbridge-mcp" }
}
}First time: call brain_login → Google popup → approve → everything just works.
If you changed browsers later: notebooklm auth import-cookies <export>.json is still supported.
BRAIN_REGISTRY in brainbridge/server.py)Map brain keys to your notebook IDs. Default entries (example — replace with yours):
BRAIN_REGISTRY = {
"personal": {"id": "41538b98-f0ed-4110-baff-a348d8976563", "alias": "abdelkhalik", ...},
"project": {"id": "d3d08d6b-6185-44f8-997e-0c476c478e49", "alias": "artisanpro", ...},
}BrainBridge is local/self-hosted by design — do NOT deploy it publicly; it holds the session to your Google account.
.gitignore excludes storage_state.json*, cookies*.json, .env.
Logout only clears the local profile — never your Google session.
MIT — see LICENSE.
Part of the BrainForge suite · built by @DeadEnde · 2026
This server cannot be deployed
Cross-session, cross-device memory for your agent: remember and recall notes. No key to start.
Persistent memory and vector search for AI agents. Hosted, OAuth-protected via Google sign-in.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.
