@roomi-fields/notebooklm-mcp 1.3.6 → 1.5.0

package/README.md

@@ -4,7 +4,7 @@
 
 > **Forked from** [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp)
 
-**Chat directly with NotebookLM for zero-hallucination answers based on your own notebooks**
+**Full automation of Google NotebookLM: Q&A, audio podcasts, and source management**
 
 <!-- Badges -->
 
@@ -18,33 +18,75 @@
 
 ---
 
-## Why NotebookLM?
+## Features
 
-| Approach            | Token Cost  | Hallucinations                | Answer Quality       |
-| ------------------- | ----------- | ----------------------------- | -------------------- |
-| Feed docs to Claude | Very high   | Yes - fills gaps              | Variable             |
-| Web search          | Medium      | High - unreliable sources     | Hit or miss          |
-| Local RAG           | Medium-High | Medium - retrieval gaps       | Depends on setup     |
-| **NotebookLM MCP**  | **Minimal** | **Zero** - refuses if unknown | **Expert synthesis** |
+### Q&A with Citations
 
-NotebookLM is pre-indexed by Gemini, provides citation-backed answers, and requires no infrastructure.
+- **Ask questions** to NotebookLM and get accurate, citation-backed answers
+- **Source citation extraction** with 5 formats: none, inline, footnotes, json, expanded
+- **Session management** for multi-turn conversations
+
+### Content Generation
+
+Generate multiple content types from your notebook sources:
+
+| Content Type       | Formats                  | Options                                        |
+| ------------------ | ------------------------ | ---------------------------------------------- |
+| **Audio Overview** | Podcast-style discussion | Language (80+), custom instructions            |
+| **Video**          | Brief, Explainer         | 6 visual styles, language, custom instructions |
+| **Infographic**    | Horizontal, Vertical     | Language, custom instructions                  |
+| **Report**         | Summary, Detailed        | Language, custom instructions                  |
+| **Presentation**   | Overview, Detailed       | Language, custom instructions                  |
+| **Data Table**     | Simple, Detailed         | Language, custom instructions                  |
+
+**Video Visual Styles**: classroom, documentary, animated, corporate, cinematic, minimalist
+
+### Content Download
+
+- **Download Audio** — WAV audio files
+- **Download Video** — MP4 video files
+- **Download Infographic** — PNG image files
+- Text-based content (report, presentation, data_table) is returned in the API response
+
+### Source Management
+
+- **Add sources**: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive
+- **List sources**: View all sources in a notebook
+
+### Notebook Library
+
+- **Multi-notebook management** with validation and smart selection
+- **Auto-discovery**: Automatically generate metadata via NotebookLM queries
+- **Search notebooks** by keyword in name, description, or topics
+
+### Integration Options
+
+- **MCP Protocol** — Claude Code, Cursor, Codex, any MCP client
+- **HTTP REST API** — n8n, Zapier, Make.com, custom integrations
 
 ---
 
 ## Quick Start
 
+> ⚠️ **npm registry temporarily unavailable** - Install from GitHub instead (see below)
+
 ### Option 1: MCP Mode (Claude Code, Cursor, Codex)
 
 ```bash
+# Clone and build locally
+git clone https://github.com/roomi-fields/notebooklm-mcp.git
+cd notebooklm-mcp
+npm install && npm run build
+
 # Claude Code
-claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp@latest
+claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js
 
 # Cursor - add to ~/.cursor/mcp.json
 {
   "mcpServers": {
     "notebooklm": {
-      "command": "npx",
-      "args": ["-y", "@roomi-fields/notebooklm-mcp@latest"]
+      "command": "node",
+      "args": ["/path/to/notebooklm-mcp/dist/index.js"]
     }
   }
 }
@@ -82,36 +124,25 @@ curl -X POST http://localhost:3000/ask \
 | [Troubleshooting](./deployment/docs/05-TROUBLESHOOTING.md)   | Common issues and solutions               |
 | [Notebook Library](./deployment/docs/06-NOTEBOOK-LIBRARY.md) | Multi-notebook management                 |
 | [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |
-| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | HTTP/MCP simultaneous mode issue          |
-
----
-
-## Core Features
-
-- **Zero Hallucinations** — NotebookLM refuses to answer if info isn't in your docs
-- **Multi-Notebook Library** — Manage multiple notebooks with validation and smart selection
-- **Auto-Discovery** — Automatically generate metadata via NotebookLM queries
-- **HTTP REST API** — Use from n8n, Zapier, Make.com, or any HTTP client
-- **Daemon Mode** — Run as background process with PM2 (`npm run daemon:start`)
-- **Cross-Tool** — Works with Claude Code, Cursor, Codex, and any MCP client
+| [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |
+| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |
 
 ---
 
-## Architecture
+## Roadmap
 
-```
-Your Task → Agent/n8n → MCP/HTTP Server → Chrome Automation → NotebookLM → Gemini 2.5 → Your Docs
-                                                                    ↓
-                                                            Accurate Output
-```
+See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
 
----
+**Latest releases:**
 
-## Roadmap
+- **v1.5.0** — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources
+- **v1.4.0** — Content management (sources, audio, generation) + Multi-account
+- **v1.3.7** — Source citation extraction (5 formats)
 
-See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
+**Not yet implemented:**
 
-**Next up (v1.4.0):** Separate Chrome profiles to enable HTTP + MCP modes simultaneously.
+- Discover sources (Web/Drive search with Fast/Deep modes)
+- Edit notes (create, delete, and convert are implemented)
 
 ---
 
@@ -133,6 +164,10 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 MIT — Use freely in your projects. See [LICENSE](./LICENSE).
 
+## Author
+
+**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)
+
 ---
 
 <details>

package/dist/accounts/account-manager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Account Manager
+ *
+ * Manages multiple Google accounts for NotebookLM with:
+ * - Account pool with rotation strategies
+ * - Encrypted credential storage
+ * - Quota tracking per account
+ * - Session health monitoring
+ * - Auto-login when sessions expire
+ */
+import type { Account, AccountHealth, AccountSelection, RotationStrategy } from './types.js';
+export declare class AccountManager {
+    private configPath;
+    private accountsDir;
+    private config;
+    private accounts;
+    private lastUsedIndex;
+    constructor();
+    /**
+     * Initialize the account manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure required directories exist
+     */
+    private ensureDirectories;
+    /**
+     * Load accounts configuration
+     */
+    private loadConfig;
+    /**
+     * Save accounts configuration
+     */
+    private saveConfig;
+    /**
+     * Load all accounts from disk
+     */
+    private loadAccounts;
+    /**
+     * Load a single account
+     */
+    private loadAccount;
+    /**
+     * Create fresh quota (resets at midnight UTC)
+     */
+    private createFreshQuota;
+    /**
+     * Add a new account
+     */
+    addAccount(email: string, password: string, totpSecret?: string, options?: {
+        priority?: number;
+        notes?: string;
+    }): Promise<string>;
+    /**
+     * Remove an account
+     */
+    removeAccount(accountId: string): Promise<boolean>;
+    /**
+     * List all accounts
+     */
+    listAccounts(): Account[];
+    /**
+     * Get account by ID
+     */
+    getAccount(accountId: string): Account | undefined;
+    /**
+     * Get credentials for an account
+     */
+    getCredentials(accountId: string): Promise<{
+        email: string;
+        password: string;
+        totpSecret?: string;
+    } | null>;
+    /**
+     * Get the best available account based on rotation strategy
+     * @param excludeAccountId Optional account ID to exclude (e.g., rate-limited account)
+     */
+    getBestAccount(excludeAccountId?: string): Promise<AccountSelection | null>;
+    /**
+     * Get accounts that are available for use
+     */
+    private getAvailableAccounts;
+    /**
+     * Select account with most remaining quota
+     */
+    private selectLeastUsed;
+    /**
+     * Select account using round-robin
+     */
+    private selectRoundRobin;
+    /**
+     * Select account by priority (failover)
+     */
+    private selectFailover;
+    /**
+     * Record a query usage for an account
+     */
+    recordUsage(accountId: string): Promise<void>;
+    /**
+     * Mark account as rate-limited (quota exhausted)
+     * This ensures the account won't be selected again until quota resets
+     */
+    markRateLimited(accountId: string): Promise<void>;
+    /**
+     * Save the ID of the currently active account
+     * This is used to identify which account is currently loaded in the main profile
+     */
+    saveCurrentAccountId(accountId: string): Promise<void>;
+    /**
+     * Get the ID of the currently active account
+     * Returns null if no account is set or file doesn't exist
+     */
+    getCurrentAccountId(): Promise<string | null>;
+    /**
+     * Record a login failure
+     */
+    recordLoginFailure(accountId: string, error: string): Promise<void>;
+    /**
+     * Record a successful login
+     */
+    recordLoginSuccess(accountId: string): Promise<void>;
+    /**
+     * Update session status for an account
+     */
+    updateSessionStatus(accountId: string, status: 'valid' | 'expiring' | 'expired'): Promise<void>;
+    /**
+     * Check health of all accounts
+     */
+    healthCheck(): Promise<AccountHealth[]>;
+    /**
+     * Check health of a single account
+     */
+    private checkAccountHealth;
+    /**
+     * Get current rotation strategy
+     */
+    getRotationStrategy(): RotationStrategy;
+    /**
+     * Set rotation strategy
+     */
+    setRotationStrategy(strategy: RotationStrategy): Promise<void>;
+    /**
+     * Check if auto-login is enabled
+     */
+    isAutoLoginEnabled(): boolean;
+    /**
+     * Enable/disable auto-login
+     */
+    setAutoLoginEnabled(enabled: boolean): Promise<void>;
+    /**
+     * Get account count
+     */
+    getAccountCount(): number;
+    /**
+     * Check if any accounts are configured
+     */
+    hasAccounts(): boolean;
+}
+/**
+ * Get or create the account manager instance
+ */
+export declare function getAccountManager(): Promise<AccountManager>;
+//# sourceMappingURL=account-manager.d.ts.map

package/dist/accounts/account-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-manager.d.ts","sourceRoot":"","sources":["../../src/accounts/account-manager.ts"],"names":[],"mappings":"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"}