@roomi-fields/notebooklm-mcp 1.3.6 → 1.5.1

package/docs/CHROME_PROFILE_LIMITATION.md

@@ -1,6 +1,20 @@
 # Chrome Profile Limitation
 
-## 🚨 Current Limitation (v1.3.2)
+## ✅ SOLVED: Use the Stdio-HTTP Proxy (v1.3.6+)
+
+**The proxy mode allows Claude Desktop and HTTP server to run simultaneously!**
+
+```bash
+# Terminal 1: Start HTTP server (owns Chrome)
+npm run start:http
+
+# Claude Desktop uses the proxy (no Chrome needed)
+# See: deployment/docs/09-MULTI-INTERFACE.md
+```
+
+---
+
+## 🚨 Original Limitation (v1.3.2-v1.3.5)
 
 **The HTTP server and MCP stdio modes cannot run simultaneously** due to Chrome profile locking.
 

package/docs/MULTI_ACCOUNT_SYSTEM.md

@@ -0,0 +1,304 @@
+# Multi-Account Management System
+
+## Overview
+
+The multi-account system enables industrial-grade authentication management for NotebookLM MCP by supporting:
+
+- **Multiple Google accounts** with encrypted credential storage
+- **Account pool rotation** with configurable strategies
+- **Quota tracking** per account (50 queries/day free tier)
+- **Automated login** with credential replay and interstitial handling
+- **TOTP 2FA support** for accounts with two-factor authentication
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     Account Management                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
+│  │  Account 1  │    │  Account 2  │    │  Account N  │         │
+│  │  (Primary)  │    │  (Backup)   │    │  (Pool)     │         │
+│  └──────┬──────┘    └──────┬──────┘    └──────┬──────┘         │
+│         │                  │                  │                 │
+│         └──────────────────┴──────────────────┘                 │
+│                            │                                    │
+│                   ┌────────▼────────┐                           │
+│                   │ AccountManager  │                           │
+│                   │ - Pool logic    │                           │
+│                   │ - Rotation      │                           │
+│                   │ - Quota         │                           │
+│                   └────────┬────────┘                           │
+│                            │                                    │
+│                   ┌────────▼────────┐                           │
+│                   │ AutoLoginManager│                           │
+│                   │ - Credential    │                           │
+│                   │   replay        │                           │
+│                   │ - 2FA/TOTP      │                           │
+│                   │ - Interstitial  │                           │
+│                   │   handling      │                           │
+│                   └─────────────────┘                           │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Components
+
+### 1. Credential Encryption (`src/accounts/crypto.ts`)
+
+- **Algorithm**: AES-256-GCM
+- **Key Management**: Auto-generated encryption key stored securely
+- **Storage**: Encrypted credentials in JSON format
+
+```typescript
+// Example encrypted credential structure
+{
+  emailEncrypted: "base64...",
+  passwordEncrypted: "base64...",
+  totpSecretEncrypted: "base64...", // Optional
+  encryptedAt: "2024-01-15T10:30:00Z"
+}
+```
+
+### 2. Account Manager (`src/accounts/account-manager.ts`)
+
+Manages the account pool with:
+
+- **Account lifecycle**: Add, remove, enable/disable
+- **Quota tracking**: Per-account usage limits
+- **Rotation strategies**:
+  - `least_used`: Prefer accounts with lowest usage
+  - `round_robin`: Sequential rotation
+  - `failover`: Use primary until failure
+  - `random`: Random selection from pool
+
+### 3. Auto-Login Manager (`src/accounts/auto-login-manager.ts`)
+
+Handles automated Google authentication:
+
+- **Credential replay**: Email and password entry with human-like typing
+- **TOTP 2FA**: Automatic code generation and entry
+- **Interstitial handling**: Dismisses Google prompts (passkeys, security, etc.)
+- **State persistence**: Saves authenticated session for reuse
+
+## Adding a New Account with 2FA (Complete Procedure)
+
+### Prerequisites
+
+Before adding an account, ensure it has:
+
+- A completed Google profile (date of birth, recovery email, etc.)
+- TOTP-based 2FA enabled (Google Authenticator, not SMS)
+- The TOTP secret key (base32 format, e.g., `JBSWY3DPEHPK3PXP`)
+
+### Step 1: Add the Account
+
+Use a TypeScript script to avoid shell escaping issues with special characters in passwords:
+
+```typescript
+// add-account.ts
+import { AccountManager } from './src/accounts/account-manager.js';
+
+const manager = new AccountManager();
+await manager.initialize();
+
+await manager.addAccount(
+  'user@gmail.com',
+  'P@ssw0rd!Special$Chars', // Special chars handled correctly
+  'JBSWY3DPEHPK3PXP' // TOTP secret (no spaces)
+);
+```
+
+Run with:
+
+```bash
+npx tsx add-account.ts
+```
+
+### Step 2: First Login (Headed Mode Required)
+
+**CRITICAL**: The first login MUST be in headed mode (visible browser). Google blocks headless browsers for new account connections with "This browser or app may not be secure" error.
+
+```bash
+npx tsx src/cli/accounts.ts test <account-id> --show
+```
+
+This step:
+
+- Opens a visible Chrome browser
+- Automatically enters email, password, and TOTP code
+- No human intervention required (fully automated)
+- Establishes trust with Google for future headless logins
+- Saves the authenticated session
+
+### Step 3: Verify Headless Mode Works
+
+After the headed login succeeds, test headless mode:
+
+```bash
+npx tsx src/cli/accounts.ts test <account-id>
+```
+
+Expected output: `Already authenticated (session still valid)!`
+
+### Step 4: Share Notebooks (Optional)
+
+If the account needs access to existing notebooks:
+
+1. Share notebooks from the owner account to the new account's email
+2. The new account can access shared notebooks immediately via direct URL
+3. No need for the new account to manually open the notebook first
+
+### Important Notes
+
+| Aspect              | Behavior                                       |
+| ------------------- | ---------------------------------------------- |
+| First login         | Must be headed (`--show`), but fully automated |
+| Subsequent logins   | Can be headless                                |
+| TOTP handling       | Automatic code generation and entry            |
+| Shared notebooks    | Accessible immediately via URL                 |
+| Session persistence | Saved to browser profile for reuse             |
+| Google anti-bot     | Blocks headless on first login only            |
+
+### Troubleshooting
+
+**"This browser or app may not be secure"**
+
+- Always use `--show` for the first login
+- This is Google's anti-bot detection, not an account issue
+
+**"Password field not found"**
+
+- Usually means Google blocked the browser
+- Run with `--show` to see what's happening
+
+**TOTP code rejected**
+
+- Verify the TOTP secret is correct (base32, no spaces)
+- Check system time is synchronized
+
+**Session expires quickly**
+
+- Re-run the headed login to refresh the session
+- Check that the browser profile isn't corrupted
+
+## CLI Commands
+
+```bash
+# Add account (without 2FA)
+npm run accounts add "user@gmail.com" "password"
+
+# Add account (with TOTP) - USE SCRIPT FOR SPECIAL CHARS
+npx tsx add-account.ts  # Recommended for passwords with special characters
+
+# List all accounts
+npm run accounts list
+
+# Test auto-login (headless)
+npm run accounts test <account-id>
+
+# Test auto-login (headed - REQUIRED for first login)
+npm run accounts test <account-id> --show
+
+# Check account health
+npm run accounts health
+
+# Set rotation strategy
+npm run accounts strategy least_used
+
+# Remove account
+npm run accounts remove <account-id>
+```
+
+## Configuration
+
+### Data Storage
+
+Account data is stored in the platform-specific data directory:
+
+- **Windows**: `%APPDATA%\notebooklm-mcp\Data\accounts\`
+- **Linux**: `~/.local/share/notebooklm-mcp/accounts/`
+- **macOS**: `~/Library/Application Support/notebooklm-mcp/accounts/`
+
+### Files
+
+| File                                     | Description                           |
+| ---------------------------------------- | ------------------------------------- |
+| `accounts.json`                          | Account configurations and state      |
+| `encryption.key`                         | AES-256 encryption key (BACKUP THIS!) |
+| `accounts/<id>/credentials.enc`          | Encrypted credentials per account     |
+| `accounts/<id>/browser_state/state.json` | Session cookies per account           |
+
+## Security Considerations
+
+1. **Encryption Key**: The encryption key (`encryption.key`) must be backed up securely. Lost key = lost credentials.
+
+2. **Credential Storage**: Credentials are encrypted at rest using AES-256-GCM.
+
+3. **Browser Profiles**: Each account has isolated browser profile data.
+
+4. **TOTP Secrets**: If stored, TOTP secrets are also encrypted.
+
+## Limitations
+
+1. **Google Account Requirements**: Accounts must have:
+   - Completed profile (date of birth, etc.)
+   - Standard password authentication enabled
+   - Optional: TOTP 2FA configured (not SMS/phone)
+
+2. **Google Security**: Google may still require additional verification for:
+   - New device/location
+   - Suspicious activity detection
+   - Captcha challenges
+
+3. **Rate Limits**: Google may rate-limit login attempts. Space out auto-login tests.
+
+## Usage Example
+
+```typescript
+import { getAccountManager, AutoLoginManager } from './accounts/index.js';
+
+// Get account manager
+const manager = await getAccountManager();
+
+// Add an account
+const accountId = await manager.addAccount(
+  'user@gmail.com',
+  'password',
+  'TOTP_SECRET' // optional
+);
+
+// Get best account based on rotation strategy
+const selection = await manager.getBestAccount();
+if (selection) {
+  console.log(`Using: ${selection.account.config.email}`);
+  console.log(`Reason: ${selection.reason}`);
+}
+
+// Perform auto-login
+const autoLogin = new AutoLoginManager(manager);
+const result = await autoLogin.performAutoLogin(accountId, { showBrowser: true });
+
+if (result.success) {
+  console.log('Login successful!');
+} else {
+  console.log(`Login failed: ${result.error}`);
+  if (result.requiresManualIntervention) {
+    console.log('Manual verification required');
+  }
+}
+
+// Record usage (for quota tracking)
+await manager.recordUsage(accountId);
+
+// Check health of all accounts
+const health = await manager.healthCheck();
+```
+
+## Future Enhancements
+
+1. **Session Manager Integration**: Coordinate account selection with SessionManager
+2. **Auto-refresh**: Background session keep-alive with cookie refresh
+3. **Quota Alerts**: Notifications when approaching quota limits
+4. **Account Analytics**: Usage patterns and optimization suggestions

package/package.json

@@ -1,24 +1,23 @@
 {
   "name": "@roomi-fields/notebooklm-mcp",
-  "version": "1.3.6",
+  "version": "1.5.1",
   "description": "MCP server for NotebookLM API with HTTP REST API - Zero hallucinations from your notebooks",
   "type": "module",
   "bin": {
-    "notebooklm-mcp": "dist/index.js"
+    "notebooklm-mcp": "dist/index.js",
+    "notebooklm-mcp-proxy": "dist/stdio-http-proxy.js"
   },
   "scripts": {
     "help": "node dist/cli/help.js",
     "setup-auth": "node dist/cli/setup-auth.js",
     "de-auth": "node dist/cli/de-auth.js",
+    "accounts": "node dist/cli/accounts.js",
     "start:http": "node dist/http-wrapper.js",
+    "start:proxy": "node dist/stdio-http-proxy.js",
     "dev:http": "tsx watch src/http-wrapper.ts",
-    "daemon:start": "pm2 start ecosystem.config.cjs",
-    "daemon:stop": "pm2 stop notebooklm-mcp",
-    "daemon:restart": "pm2 restart notebooklm-mcp",
-    "daemon:logs": "pm2 logs notebooklm-mcp",
-    "daemon:status": "pm2 status",
-    "daemon:delete": "pm2 delete notebooklm-mcp",
-    "build": "tsc",
+    "dev:proxy": "tsx watch src/stdio-http-proxy.ts",
+    "build": "tsc && npm run build:i18n",
+    "build:i18n": "node -e \"require('fs').cpSync('src/i18n', 'dist/i18n', {recursive: true, filter: (s) => s.endsWith('.json') || require('fs').statSync(s).isDirectory()})\"",
     "watch": "tsc --watch",
     "dev": "tsx watch src/index.ts",
     "prepare": "husky",
@@ -27,7 +26,9 @@
     "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
     "test:ci": "node --experimental-vm-modules node_modules/jest/bin/jest.js --ci --coverage --reporters=default",
     "test:unit": "node --experimental-vm-modules node_modules/jest/bin/jest.js --testPathPatterns=unit",
-    "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js --testPathPatterns=integration"
+    "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js --testPathPatterns=integration",
+    "test:e2e": "powershell -ExecutionPolicy Bypass -File tests/e2e/run-e2e-tests.ps1",
+    "test:e2e:basic": "powershell -ExecutionPolicy Bypass -File tests/e2e/run-e2e-tests.ps1 -SkipBrowserTests"
   },
   "keywords": [
     "mcp",
@@ -59,7 +60,9 @@
     "README.md",
     "NOTEBOOKLM_USAGE.md",
     "LICENSE",
-    "docs"
+    "docs",
+    "scripts",
+    "deployment"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -68,6 +71,7 @@
     "env-paths": "^3.0.0",
     "express": "^4.18.2",
     "globby": "^14.1.0",
+    "otplib": "^12.0.1",
     "patchright": "^1.48.2",
     "zod": "^3.22.0"
   },
@@ -84,7 +88,6 @@
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^16.2.7",
-    "pm2": "^6.0.14",
     "prettier": "^3.6.2",
     "ts-jest": "^29.4.5",
     "tsx": "^4.7.0",

package/scripts/archive/add-and-activate-notebook.ps1

@@ -0,0 +1,31 @@
+# Add the newly created notebook to library and activate it
+Write-Host "=== Adding and activating new notebook ===" -ForegroundColor Cyan
+
+# Add the notebook
+$addBody = @{
+    name = "e2e-rom1pey-test"
+    url = "https://notebooklm.google.com/notebook/725d28e1-4284-4f36-99a2-b6693c2ebf13"
+    description = "E2E test notebook owned by rom1pey"
+} | ConvertTo-Json
+
+Write-Host "Adding notebook to library..."
+try {
+    $response = Invoke-RestMethod -Uri "http://localhost:3000/notebooks" -Method POST -ContentType "application/json" -Body $addBody -TimeoutSec 60
+    Write-Host "Added: $($response.success)" -ForegroundColor Green
+} catch {
+    Write-Host "Already exists or error: $($_.Exception.Message)" -ForegroundColor Yellow
+}
+
+# Activate it
+Write-Host "`nActivating notebook..."
+try {
+    $response = Invoke-RestMethod -Uri "http://localhost:3000/notebooks/e2e-rom1pey-test/activate" -Method PUT -TimeoutSec 30
+    Write-Host "Activated: $($response.success)" -ForegroundColor Green
+} catch {
+    Write-Host "Error: $($_.Exception.Message)" -ForegroundColor Red
+}
+
+# Verify
+Write-Host "`nVerifying active notebook..."
+$notebooks = Invoke-RestMethod -Uri "http://localhost:3000/notebooks" -Method GET
+Write-Host "Active: $($notebooks.data.active_notebook_id)" -ForegroundColor Cyan

package/scripts/archive/add-new-notebook.ps1

@@ -0,0 +1,25 @@
+# Add the newly created notebook to library with all required fields
+Write-Host "=== Adding notebook to library ===" -ForegroundColor Cyan
+
+$body = @{
+    name = "e2e-rom1pey-test"
+    url = "https://notebooklm.google.com/notebook/725d28e1-4284-4f36-99a2-b6693c2ebf13"
+    description = "E2E test notebook owned by rom1pey"
+    topics = @("test", "e2e", "rom1pey")
+} | ConvertTo-Json
+
+Write-Host "Body: $body"
+Write-Host "`nSending request..."
+
+try {
+    $response = Invoke-RestMethod -Uri "http://localhost:3000/notebooks" -Method POST -ContentType "application/json" -Body $body -TimeoutSec 120
+    Write-Host "Success: $($response.success)" -ForegroundColor Green
+    Write-Host "Notebook ID: $($response.data.notebook.id)"
+} catch {
+    Write-Host "Error: $($_.Exception.Message)" -ForegroundColor Red
+
+    # Get response body
+    $streamReader = [System.IO.StreamReader]::new($_.Exception.Response.GetResponseStream())
+    $responseBody = $streamReader.ReadToEnd()
+    Write-Host "Response: $responseBody" -ForegroundColor Yellow
+}

package/scripts/archive/add-rom1pey.ps1

@@ -0,0 +1,2 @@
+cd D:\Claude\notebooklm-mcp-http
+npm run accounts add "rom1pey@gmail.com" "qZa!8A!Dm7S@vsnU" "ozzt dbdy d4po icw7 msk3 dc3s 33xc 3v36"

package/scripts/archive/add-rpmonster.ps1

@@ -0,0 +1,2 @@
+cd D:\Claude\notebooklm-mcp-http
+npm run accounts add "rpmonster@gmail.com" 'w^mXCKl$o7aaJpp!' "e6ty a6dz jckj 5ogf m4yi vabs 4ttg x3tl"

package/scripts/archive/add-source-debug.ps1

@@ -0,0 +1,11 @@
+$body = @{
+    source_type = "text"
+    title = "Test Source"
+    text = "Test document for E2E."
+    notebook_url = "https://notebooklm.google.com/notebook/abd21688-02a6-4459-953b-30f0612a984e"
+    show_browser = $true
+} | ConvertTo-Json
+
+Write-Host "Adding source (visible browser)..."
+$response = Invoke-RestMethod -Uri "http://localhost:3000/content/sources" -Method POST -ContentType "application/json" -Body $body -TimeoutSec 180
+$response | ConvertTo-Json -Depth 5

package/scripts/archive/add-source-e2e.ps1

@@ -0,0 +1,28 @@
+# Add source to test notebook with proper cleanup
+$testNotebookUrl = "https://notebooklm.google.com/notebook/abd21688-02a6-4459-953b-30f0612a984e"
+
+Write-Host "Adding text source to test notebook..." -ForegroundColor Cyan
+
+$sourceBody = @{
+    source_type = "text"
+    title = "E2E Test Document"
+    text = "# E2E Test Document`n`nThis is a test document for E2E testing.`n`n## Features`n- HTTP REST API`n- Browser automation`n- Multi-account support`n`n## Technical`n1. Express.js wrapper`n2. Playwright sessions`n3. Content manager"
+    notebook_url = $testNotebookUrl
+} | ConvertTo-Json
+
+try {
+    $result = Invoke-RestMethod -Uri "http://localhost:3000/content/sources" -Method POST -ContentType "application/json" -Body $sourceBody -TimeoutSec 90
+    Write-Host "Result:" -ForegroundColor Yellow
+    $result | ConvertTo-Json -Depth 5
+} catch {
+    Write-Host "Error: $($_.Exception.Message)" -ForegroundColor Red
+}
+
+# Close all sessions after operation
+Write-Host "`nCleaning up sessions..." -ForegroundColor Cyan
+$sessions = Invoke-RestMethod -Uri "http://localhost:3000/sessions" -Method GET
+foreach ($session in $sessions.data.sessions) {
+    Write-Host "  Closing session $($session.id)..."
+    Invoke-RestMethod -Uri "http://localhost:3000/sessions/$($session.id)" -Method DELETE -ErrorAction SilentlyContinue | Out-Null
+}
+Write-Host "Done." -ForegroundColor Green

package/scripts/archive/add-source-visible.ps1

@@ -0,0 +1,11 @@
+$body = @{
+    source_type = "text"
+    title = "E2E Test Source"
+    text = "# E2E Test`n`nTest document for E2E testing. Contains info about NotebookLM MCP Server.`n`n## Features`n- REST API`n- Browser automation`n- Multi-account"
+    notebook_url = "https://notebooklm.google.com/notebook/abd21688-02a6-4459-953b-30f0612a984e"
+    show_browser = $true
+} | ConvertTo-Json
+
+Write-Host "Adding source (visible browser)..."
+$response = Invoke-RestMethod -Uri "http://localhost:3000/content/sources" -Method POST -ContentType "application/json" -Body $body -TimeoutSec 120
+$response | ConvertTo-Json -Depth 5

package/scripts/archive/add-test-notebook.ps1

@@ -0,0 +1,13 @@
+# Add test notebook to library (no browser needed)
+$testNotebookUrl = "https://notebooklm.google.com/notebook/abd21688-02a6-4459-953b-30f0612a984e"
+
+$addBody = @{
+    url = $testNotebookUrl
+    name = "E2E-Test-Notebook"
+    description = "Notebook for E2E testing - can be modified/deleted"
+    topics = @("test", "e2e", "automation")
+} | ConvertTo-Json
+
+Write-Host "Adding test notebook to library..."
+$result = Invoke-RestMethod -Uri "http://localhost:3000/notebooks" -Method POST -ContentType "application/json" -Body $addBody -TimeoutSec 10
+$result | ConvertTo-Json -Depth 3

package/scripts/archive/add-test-source.ps1

@@ -0,0 +1,50 @@
+# Add source to test notebook with proper cleanup
+$testNotebookUrl = "https://notebooklm.google.com/notebook/abd21688-02a6-4459-953b-30f0612a984e"
+
+Write-Host "Adding text source to test notebook..." -ForegroundColor Cyan
+
+$sourceBody = @{
+    source_type = "text"
+    title = "E2E Test Document"
+    text = @"
+# E2E Test Document
+
+This is a test document for End-to-End testing of the NotebookLM MCP HTTP Server.
+
+## Section 1: Introduction
+The NotebookLM MCP HTTP Server provides a REST API for interacting with Google NotebookLM.
+
+## Section 2: Features
+- Asking questions about notebook content
+- Adding and managing sources
+- Generating audio overviews, presentations, and reports
+- Creating and managing notes
+
+## Section 3: Technical Details
+The architecture consists of:
+1. HTTP wrapper (Express.js)
+2. Session manager (Playwright browser sessions)
+3. Content manager (source and content operations)
+
+This document should provide enough content for testing.
+"@
+    notebook_url = $testNotebookUrl
+} | ConvertTo-Json
+
+try {
+    $result = Invoke-RestMethod -Uri "http://localhost:3000/content/sources" -Method POST -ContentType "application/json" -Body $sourceBody -TimeoutSec 90
+    Write-Host "Result:" -ForegroundColor Yellow
+    $result | ConvertTo-Json -Depth 5
+} catch {
+    Write-Host "Error: $($_.Exception.Message)" -ForegroundColor Red
+}
+
+# Close all sessions after operation
+Write-Host ""
+Write-Host "Cleaning up sessions..." -ForegroundColor Cyan
+$sessions = Invoke-RestMethod -Uri "http://localhost:3000/sessions" -Method GET
+foreach ($session in $sessions.data.sessions) {
+    Write-Host "  Closing session $($session.id)..."
+    Invoke-RestMethod -Uri "http://localhost:3000/sessions/$($session.id)" -Method DELETE -ErrorAction SilentlyContinue | Out-Null
+}
+Write-Host "Done." -ForegroundColor Green

package/scripts/archive/capture-screen.ps1

@@ -0,0 +1,11 @@
+# Just activate notebook and get content to take screenshot
+Write-Host "Activating notebook-1..."
+$response = Invoke-RestMethod -Uri "http://localhost:3000/notebooks/notebook-1/activate" -Method PUT
+Write-Host "Activated"
+
+# The server should have taken debug screenshots - check the data folder
+Write-Host "`nChecking for debug screenshots..."
+$debugPath = "C:\Users\romai\AppData\Local\notebooklm-mcp\Data"
+Get-ChildItem $debugPath -Filter "*.png" | Sort-Object LastWriteTime -Descending | Select-Object -First 5 | ForEach-Object {
+    Write-Host "  $($_.Name) - $($_.LastWriteTime)"
+}

package/scripts/archive/change-language.mjs

@@ -0,0 +1,45 @@
+/**
+ * Change Google account language to English
+ */
+import { chromium } from 'patchright';
+import path from 'path';
+import readline from 'readline';
+
+const ACCOUNT_ID = 'account-1767079146601'; // rom1pey@gmail.com
+const DATA_DIR = 'C:\\Users\\romai\\AppData\\Local\\notebooklm-mcp\\Data';
+const PROFILE_DIR = path.join(DATA_DIR, 'accounts', ACCOUNT_ID, 'profile');
+
+async function changeLanguage() {
+  console.log('🌐 Opening browser with rom1pey profile...');
+  console.log(`📁 Profile: ${PROFILE_DIR}`);
+
+  const browser = await chromium.launchPersistentContext(PROFILE_DIR, {
+    headless: false,
+    channel: 'chrome',
+    viewport: { width: 1280, height: 800 },
+  });
+
+  const page = await browser.newPage();
+
+  console.log('🔗 Navigating to Google language settings...');
+  await page.goto('https://myaccount.google.com/language', { waitUntil: 'networkidle' });
+
+  // Wait for user to manually change language
+  console.log('\n' + '='.repeat(60));
+  console.log('👆 MANUAL STEP REQUIRED:');
+  console.log('1. Click the pencil icon next to your language');
+  console.log('2. Select "English (United States)" as primary language');
+  console.log('3. Press ENTER here when done');
+  console.log('='.repeat(60) + '\n');
+
+  // Wait for user input
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  await new Promise((resolve) => rl.question('Press ENTER when done... ', resolve));
+  rl.close();
+
+  console.log('✅ Saving and closing browser...');
+  await browser.close();
+  console.log('🎉 Done! Language should now be English.');
+}
+
+changeLanguage().catch(console.error);