@sjawhar/whatsapp-mcp 1.0.0

package/dist/import-contacts.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+/**
+ * Import phone contacts from a .vcf (vCard) file into the WhatsApp MCP database.
+ *
+ * Usage (standalone CLI):
+ *   npx tsx src/import-contacts.ts contacts.vcf
+ *   npx tsx src/import-contacts.ts contacts.vcf --dry-run
+ *
+ * Also exports `importContactsFromVcf()` for use by the MCP tool.
+ *
+ * Export your contacts from iPhone:
+ *   Settings > Contacts > Accounts > iCloud > Contacts (on)
+ *   Go to iCloud.com > Contacts > Select All > Export vCard
+ *
+ * Or use any other method that produces a .vcf file.
+ */
+import fs from "fs";
+import path from "path";
+import { pathToFileURL } from "node:url";
+import Database from "better-sqlite3";
+const __project_root = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const DB_PATH = path.join(__project_root, "store", "whatsapp.db");
+const CONTACTS_DIR = path.join(__project_root, "contacts");
+const DEFAULT_VCF = path.join(CONTACTS_DIR, "contacts.vcf");
+function parseVcf(content) {
+    const contacts = [];
+    const cards = content.split("BEGIN:VCARD");
+    for (const card of cards) {
+        if (!card.includes("END:VCARD"))
+            continue;
+        // Extract name: try FN first (formatted name), then N (structured name)
+        let name = null;
+        const fnMatch = card.match(/^FN[;:](.+)$/m);
+        if (fnMatch) {
+            name = fnMatch[1].trim();
+        }
+        if (!name) {
+            const nMatch = card.match(/^N[;:](.+)$/m);
+            if (nMatch) {
+                // N field format: Last;First;Middle;Prefix;Suffix
+                const parts = nMatch[1].split(";").map((s) => s.trim()).filter(Boolean);
+                if (parts.length >= 2) {
+                    name = `${parts[1]} ${parts[0]}`; // First Last
+                }
+                else if (parts.length === 1) {
+                    name = parts[0];
+                }
+            }
+        }
+        if (!name)
+            continue;
+        // Extract phone numbers — handle multi-line folded values
+        const phones = [];
+        // Unfold continuation lines (RFC 2425: line starting with space/tab continues previous)
+        const unfolded = card.replace(/\r?\n[ \t]/g, "");
+        const telMatches = unfolded.matchAll(/^TEL[^:]*:(.+)$/gm);
+        for (const match of telMatches) {
+            const raw = match[1].trim();
+            // Strip non-digit except leading +
+            const cleaned = raw.replace(/[^\d+]/g, "");
+            if (cleaned.length >= 7) {
+                phones.push(cleaned);
+            }
+        }
+        if (phones.length > 0) {
+            contacts.push({ name, phones });
+        }
+    }
+    return contacts;
+}
+// ─── Phone Number Normalization ─────────────────────────────────────
+/**
+ * Normalize a phone number to a WhatsApp JID.
+ * Strips leading +, leading 00, and handles common formats.
+ */
+function phoneToJid(phone) {
+    let digits = phone.replace(/\D/g, "");
+    // Strip leading 00 (international prefix)
+    if (digits.startsWith("00")) {
+        digits = digits.slice(2);
+    }
+    // Strip leading 0 only if it looks like a local number with country code context
+    // (we can't know the country code without more context, so we leave it)
+    return `${digits}@s.whatsapp.net`;
+}
+/**
+ * Import contacts from a VCF file into the database.
+ * Can be called from the MCP tool or standalone CLI.
+ *
+ * @param dbInstance - An open better-sqlite3 database instance.
+ *   When called from the MCP server, pass the shared DB.
+ *   When called from CLI, opens its own connection.
+ * @param vcfPath - Path to the .vcf file. Defaults to contacts/contacts.vcf.
+ */
+export function importContactsFromVcf(dbInstance, vcfPath) {
+    const absPath = path.resolve(vcfPath || DEFAULT_VCF);
+    // Containment check: VCF path must be inside the allowed contacts directory
+    const allowedBase = path.resolve(process.env.CONTACTS_DIR || CONTACTS_DIR);
+    const allowedPrefix = `${allowedBase}${path.sep}`;
+    if (!absPath.startsWith(allowedPrefix)) {
+        throw new Error(`VCF path not allowed: must be within ${allowedBase}`);
+    }
+    if (!fs.existsSync(absPath)) {
+        throw new Error(`VCF file not found: ${absPath}`);
+    }
+    // Parse VCF
+    const content = fs.readFileSync(absPath, "utf-8");
+    const contacts = parseVcf(content);
+    // Build lookup maps for all known JIDs (from chats and contacts tables)
+    const knownJids = new Set();
+    const chatRows = dbInstance.prepare("SELECT jid FROM chats WHERE jid LIKE '%@s.whatsapp.net'").all();
+    const contactRows = dbInstance.prepare("SELECT jid FROM contacts WHERE jid LIKE '%@s.whatsapp.net'").all();
+    for (const row of chatRows)
+        knownJids.add(row.jid);
+    for (const row of contactRows)
+        knownJids.add(row.jid);
+    // Build a suffix map for fuzzy matching: last 9 digits → JID
+    // 9 digits is long enough to avoid collisions but catches local-vs-international mismatches
+    const SUFFIX_LEN = 9;
+    const suffixMap = new Map();
+    for (const jid of knownJids) {
+        const digits = jid.replace("@s.whatsapp.net", "");
+        if (digits.length >= SUFFIX_LEN) {
+            const suffix = digits.slice(-SUFFIX_LEN);
+            if (!suffixMap.has(suffix))
+                suffixMap.set(suffix, []);
+            suffixMap.get(suffix).push(jid);
+        }
+    }
+    // Prepare statements
+    const upsertContact = dbInstance.prepare(`
+    INSERT INTO contacts (jid, name, notify)
+    VALUES (@jid, @name, NULL)
+    ON CONFLICT(jid) DO UPDATE SET
+      name = COALESCE(@name, contacts.name)
+  `);
+    const upsertChat = dbInstance.prepare(`
+    INSERT INTO chats (jid, name, conversation_ts, unread_count)
+    VALUES (@jid, @name, 0, 0)
+    ON CONFLICT(jid) DO UPDATE SET
+      name = COALESCE(@name, chats.name)
+  `);
+    // Match and update — exact matches first, then fuzzy suffix matches
+    let exactMatches = 0;
+    let fuzzyMatches = 0;
+    const matchedJids = new Set(); // prevent duplicate updates for same JID
+    const runImport = dbInstance.transaction(() => {
+        for (const contact of contacts) {
+            for (const phone of contact.phones) {
+                const jid = phoneToJid(phone);
+                // Exact match
+                if (knownJids.has(jid) && !matchedJids.has(jid)) {
+                    exactMatches++;
+                    matchedJids.add(jid);
+                    upsertContact.run({ jid, name: contact.name });
+                    upsertChat.run({ jid, name: contact.name });
+                    continue;
+                }
+                // Fuzzy suffix match (last 9 digits)
+                const digits = phone.replace(/\D/g, "");
+                if (digits.length >= SUFFIX_LEN) {
+                    const suffix = digits.slice(-SUFFIX_LEN);
+                    const candidates = suffixMap.get(suffix);
+                    if (candidates) {
+                        for (const candidateJid of candidates) {
+                            if (matchedJids.has(candidateJid))
+                                continue;
+                            fuzzyMatches++;
+                            matchedJids.add(candidateJid);
+                            upsertContact.run({ jid: candidateJid, name: contact.name });
+                            upsertChat.run({ jid: candidateJid, name: contact.name });
+                        }
+                    }
+                }
+            }
+        }
+    });
+    runImport();
+    const nameless = dbInstance.prepare(`
+    SELECT COUNT(*) AS cnt FROM chats
+    WHERE name IS NULL AND jid LIKE '%@s.whatsapp.net' AND conversation_ts > 0
+  `).get();
+    return {
+        success: true,
+        vcfPath: absPath,
+        totalParsed: contacts.length,
+        exactMatches,
+        fuzzyMatches,
+        totalUpdated: exactMatches + fuzzyMatches,
+        namelessChatsRemaining: nameless.cnt,
+    };
+}
+// ─── CLI Entry Point ────────────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    const dryRun = args.includes("--dry-run");
+    const vcfPath = args.find((a) => !a.startsWith("--"));
+    if (!vcfPath) {
+        console.error("Usage: npx tsx src/import-contacts.ts <contacts.vcf> [--dry-run]");
+        console.error("");
+        console.error("Export contacts from iPhone:");
+        console.error("  iCloud.com > Contacts > Select All > Export vCard");
+        process.exit(1);
+    }
+    const absPath = path.resolve(vcfPath);
+    if (!fs.existsSync(absPath)) {
+        console.error(`File not found: ${absPath}`);
+        process.exit(1);
+    }
+    if (!fs.existsSync(DB_PATH)) {
+        console.error(`Database not found: ${DB_PATH}`);
+        console.error("Run the WhatsApp MCP server first to create the database.");
+        process.exit(1);
+    }
+    if (dryRun) {
+        // For dry run, open our own DB and just parse + report
+        const db = new Database(DB_PATH);
+        db.pragma("journal_mode = WAL");
+        const content = fs.readFileSync(absPath, "utf-8");
+        const contacts = parseVcf(content);
+        console.log(`Parsed ${contacts.length} contacts with phone numbers from VCF`);
+        console.log("\n(Dry run — no changes made)");
+        db.close();
+        return;
+    }
+    const db = new Database(DB_PATH);
+    db.pragma("journal_mode = WAL");
+    const result = importContactsFromVcf(db, absPath);
+    console.log(`Parsed ${result.totalParsed} contacts with phone numbers from VCF`);
+    console.log(`\nMatched ${result.totalUpdated} phone numbers to existing WhatsApp JIDs`);
+    console.log(`  Exact matches: ${result.exactMatches}`);
+    console.log(`  Fuzzy matches (last 9 digits): ${result.fuzzyMatches}`);
+    console.log(`\nUpdated ${result.totalUpdated} contacts with address book names`);
+    console.log(`Chats still without a name: ${result.namelessChatsRemaining}`);
+    db.close();
+}
+// Only run CLI when executed directly (not imported)
+const isDirectRun = import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isDirectRun) {
+    main();
+}
+//# sourceMappingURL=import-contacts.js.map

package/dist/import-contacts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import path from "path";
+import { initDb, closeDb } from "./db.js";
+import { initWhatsApp, closeWhatsApp, resolveConnectionAsReadOnly } from "./whatsapp.js";
+import { registerTools } from "./tools.js";
+import { acquireWhatsAppLock, releaseWhatsAppLock } from "./lock.js";
+const __project_root = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const LOCK_FILE = path.join(__project_root, "store", ".whatsapp.lock");
+async function main() {
+    console.error("Starting WhatsApp MCP Server...");
+    // 1. Initialize SQLite database (synchronous, instant).
+    initDb();
+    // 2. Create MCP server and connect to stdio transport FIRST
+    //    so the client doesn't time out waiting for the initialize handshake.
+    const server = new McpServer({
+        name: "whatsapp",
+        version: "1.0.0",
+    });
+    registerTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+    // 3. Initialize WhatsApp in the background — but only if no other instance
+    //    already owns the WhatsApp connection. This prevents status 515/440
+    //    when Claude Desktop spawns multiple MCP server instances.
+    if (acquireWhatsAppLock(LOCK_FILE)) {
+        console.error("WhatsApp lock acquired — connecting...");
+        initWhatsApp().catch((err) => {
+            console.error("Failed to initialize WhatsApp:", err);
+        });
+    }
+    else {
+        console.error("Another instance owns the WhatsApp connection — running as read-only from SQLite");
+        resolveConnectionAsReadOnly();
+    }
+    // 4. Graceful shutdown
+    const shutdown = async () => {
+        console.error("Shutting down...");
+        await closeWhatsApp();
+        releaseWhatsAppLock(LOCK_FILE);
+        closeDb();
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.on("unhandledRejection", (reason) => {
+        console.error("Unhandled rejection:", reason);
+        shutdown();
+    });
+    process.on("uncaughtException", (err) => {
+        console.error("Uncaught exception:", err);
+        shutdown();
+    });
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lock.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Atomically acquire a file lock for the WhatsApp connection.
+ * Uses O_CREAT | O_EXCL to prevent race conditions between processes.
+ * Only one process should connect to WhatsApp at a time to avoid status 515/440.
+ *
+ * @param lockFilePath - Path to the lock file
+ * @returns true if lock was acquired, false if another live process holds it
+ */
+export declare function acquireWhatsAppLock(lockFilePath: string): boolean;
+/**
+ * Release the lock file, but only if this process owns it.
+ *
+ * @param lockFilePath - Path to the lock file
+ */
+export declare function releaseWhatsAppLock(lockFilePath: string): void;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAyCjE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAW9D"}

package/dist/lock.js

@@ -0,0 +1,65 @@
+import fs from "fs";
+import path from "path";
+/**
+ * Atomically acquire a file lock for the WhatsApp connection.
+ * Uses O_CREAT | O_EXCL to prevent race conditions between processes.
+ * Only one process should connect to WhatsApp at a time to avoid status 515/440.
+ *
+ * @param lockFilePath - Path to the lock file
+ * @returns true if lock was acquired, false if another live process holds it
+ */
+export function acquireWhatsAppLock(lockFilePath) {
+    fs.mkdirSync(path.dirname(lockFilePath), { recursive: true });
+    try {
+        // Atomic create — throws EEXIST if file already exists (no race window)
+        const fd = fs.openSync(lockFilePath, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY);
+        fs.writeSync(fd, String(process.pid));
+        fs.closeSync(fd);
+        return true;
+    }
+    catch (err) {
+        if (!(err instanceof Error) || err.code !== "EEXIST") {
+            throw err;
+        }
+        // File exists — check if the owning process is still alive
+        const pid = parseInt(fs.readFileSync(lockFilePath, "utf-8").trim(), 10);
+        try {
+            process.kill(pid, 0); // throws if process is dead
+            return false; // another instance is alive
+        }
+        catch {
+            // Stale lock — remove and retry once
+            console.error(`Stale lock file found (PID ${pid} is dead) — clearing and taking over`);
+            fs.unlinkSync(lockFilePath);
+            try {
+                const fd = fs.openSync(lockFilePath, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY);
+                fs.writeSync(fd, String(process.pid));
+                fs.closeSync(fd);
+                return true;
+            }
+            catch {
+                // Another process beat us to the retry — they win
+                return false;
+            }
+        }
+    }
+}
+/**
+ * Release the lock file, but only if this process owns it.
+ *
+ * @param lockFilePath - Path to the lock file
+ */
+export function releaseWhatsAppLock(lockFilePath) {
+    try {
+        if (fs.existsSync(lockFilePath)) {
+            const pid = parseInt(fs.readFileSync(lockFilePath, "utf-8").trim(), 10);
+            if (pid === process.pid) {
+                fs.unlinkSync(lockFilePath);
+            }
+        }
+    }
+    catch {
+        // Best-effort release — don't crash during shutdown
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,wEAAwE;QACxE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CACpB,YAAY,EACZ,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CACnE,CAAC;QACF,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChF,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,2DAA2D;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,4BAA4B;YAClD,OAAO,KAAK,CAAC,CAAC,4BAA4B;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,OAAO,CAAC,KAAK,CAAC,8BAA8B,GAAG,sCAAsC,CAAC,CAAC;YACvF,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAE5B,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CACpB,YAAY,EACZ,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CACnE,CAAC;gBACF,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;gBAClD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACxE,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;gBACxB,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all WhatsApp MCP tools on the server.
+ */
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBpE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+ZrD"}