Pantheon-Security/notebooklm-mcp-secure

What's New

Query Logging 📝

• All Q&A interactions now logged to ~/.local/share/notebooklm-mcp/query_logs/
• JSONL format with 90-day retention
• New get_query_history tool to search past sessions by session_id, notebook_id, date, or search pattern

Enhanced Quota Visibility 📊

• Every ask_question response now includes quota_info:
  • queries_remaining, queries_used_today, should_stop, warnings
• get_quota tool enhanced with:
  • Remaining counts for queries and notebooks
  • should_stop flag (true when ≤5 queries remaining)
  • reset_time (next midnight)
  • New sync=true option to fetch actual quota from Google's NotebookLM UI

Multi-Session Auth Stability 🔒

• Cross-platform advisory file locking for concurrent sessions
• Atomic quota increment with reload-before-write pattern
• Locked auth state save/load and browser context creation
• Prevents race conditions when running 4-5 concurrent research chats

Rate Limit Detection ⚠️

• Scrapes NotebookLM UI for query usage patterns
• Detects rate limit error messages ("quota exceeded", "try again tomorrow", etc.)
• Automatically marks quota as exhausted when rate limit detected

Environment Variables

NLMCP_QUERY_LOG_ENABLED=true          # Enable query logging (default: true)
NLMCP_QUERY_LOG_RETENTION_DAYS=90     # Log retention (default: 90)
NLMCP_LOCK_TIMEOUT_MS=10000           # Lock timeout (default: 10s)
NLMCP_LOCK_STALE_MS=30000             # Stale lock threshold (default: 30s)

Full Changelog: https://github.com/Pantheon-Security/notebooklm-mcp-secure/compare/v1.10.7...v1.10.8