@hasna/contacts 0.2.3 → 0.2.4

package/dist/lib/gmail-import.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Gmail contact import — fetches messages matching a query, extracts unique
+ * senders/recipients, and returns them as CreateContactInput objects.
+ *
+ * Uses the Gmail REST API directly with tokens stored at
+ * ~/.connectors/connect-gmail/profiles/default/tokens.json
+ * (requires connect-gmail auth login to be completed first).
+ */
+import type { CreateContactInput } from "../types/index.js";
+/**
+ * Parse a single RFC 5322 address header value into { name, email } pairs.
+ * Handles: "Name <email>", "<email>", "email", and comma-separated lists.
+ */
+export declare function parseAddressHeader(header: string): Array<{
+    name: string;
+    email: string;
+}>;
+export interface GmailImportOptions {
+    query: string;
+    /** Max messages to scan (default 200, max 500) */
+    max_messages?: number;
+    /** Gmail profile to use (default: "default") */
+    gmail_profile?: string;
+    tag_ids?: string[];
+    group_id?: string;
+}
+export interface ExtractedContact {
+    email: string;
+    name: string;
+    company_hint: string | null;
+    contact_input: CreateContactInput;
+}
+/**
+ * Fetch messages matching `query` from Gmail and extract unique contacts.
+ * Does NOT write to the database — returns prepared CreateContactInput objects.
+ */
+export declare function extractContactsFromGmail(opts: GmailImportOptions): Promise<ExtractedContact[]>;
+//# sourceMappingURL=gmail-import.d.ts.map

package/dist/lib/gmail-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-import.d.ts","sourceRoot":"","sources":["../../src/lib/gmail-import.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAoD5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBzF;AAqCD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoF7B"}

package/dist/lib/gmail-import.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gmail-import.test.d.ts.map

package/dist/lib/gmail-import.test.d.ts.map

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

package/dist/mcp/index.js

@@ -1688,6 +1688,152 @@ async function exportContacts(format, contacts) {
   }
 }
 
+// src/lib/gmail-import.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { homedir } from "os";
+import { join as join2 } from "path";
+function loadGmailToken(profile = "default") {
+  const bases = [
+    join2(homedir(), ".connectors", "connect-gmail"),
+    join2(homedir(), ".connect", "connect-gmail")
+  ];
+  for (const base of bases) {
+    const tokenPath = join2(base, "profiles", profile, "tokens.json");
+    if (existsSync2(tokenPath)) {
+      try {
+        const raw = readFileSync(tokenPath, "utf-8");
+        const tokens = JSON.parse(raw);
+        if (tokens.accessToken)
+          return tokens.accessToken;
+      } catch {}
+    }
+  }
+  throw new Error("Gmail not authenticated. Run `connect-gmail auth login` first.");
+}
+function parseAddressHeader(header) {
+  const results = [];
+  const parts = header.split(/,(?![^<>]*>)(?![^"]*")/);
+  for (const part of parts) {
+    const trimmed = part.trim();
+    if (!trimmed)
+      continue;
+    const angleMatch = trimmed.match(/^(.*?)\s*<([^>]+)>\s*$/);
+    if (angleMatch) {
+      const name = angleMatch[1].trim().replace(/^"|"$/g, "");
+      const email = angleMatch[2].trim().toLowerCase();
+      if (email.includes("@"))
+        results.push({ name, email });
+    } else if (trimmed.includes("@")) {
+      results.push({ name: "", email: trimmed.toLowerCase() });
+    }
+  }
+  return results;
+}
+function domainToCompany(email) {
+  const domain = email.split("@")[1];
+  if (!domain)
+    return null;
+  const genericDomains = new Set([
+    "gmail.com",
+    "googlemail.com",
+    "yahoo.com",
+    "yahoo.co.uk",
+    "hotmail.com",
+    "hotmail.co.uk",
+    "outlook.com",
+    "live.com",
+    "icloud.com",
+    "me.com",
+    "mac.com",
+    "protonmail.com",
+    "pm.me",
+    "fastmail.com",
+    "hey.com",
+    "aol.com",
+    "msn.com"
+  ]);
+  if (genericDomains.has(domain.toLowerCase()))
+    return null;
+  const parts = domain.split(".");
+  const name = parts.length > 2 ? parts[parts.length - 2] : parts[0];
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function parseName(displayName) {
+  const name = displayName.trim();
+  if (!name)
+    return {};
+  const parts = name.split(/\s+/);
+  if (parts.length === 1)
+    return { first_name: parts[0] };
+  const last = parts.pop();
+  return { first_name: parts.join(" "), last_name: last };
+}
+async function extractContactsFromGmail(opts) {
+  const maxMessages = Math.min(opts.max_messages ?? 200, 500);
+  const profile = opts.gmail_profile ?? "default";
+  const token = loadGmailToken(profile);
+  const listUrl = new URL("https://gmail.googleapis.com/gmail/v1/users/me/messages");
+  listUrl.searchParams.set("q", opts.query);
+  listUrl.searchParams.set("maxResults", String(maxMessages));
+  const listResp = await fetch(listUrl.toString(), {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (!listResp.ok) {
+    const body = await listResp.text();
+    if (listResp.status === 401) {
+      throw new Error("Gmail token expired. Run `connect-gmail auth login` to re-authenticate.");
+    }
+    throw new Error(`Gmail API error ${listResp.status}: ${body}`);
+  }
+  const listData = await listResp.json();
+  const messageRefs = listData.messages ?? [];
+  if (messageRefs.length === 0) {
+    return [];
+  }
+  const seen = new Map;
+  const batchSize = 20;
+  for (let i = 0;i < messageRefs.length; i += batchSize) {
+    const batch = messageRefs.slice(i, i + batchSize);
+    const fetches = batch.map((ref) => {
+      const url = new URL(`https://gmail.googleapis.com/gmail/v1/users/me/messages/${ref.id}`);
+      url.searchParams.set("format", "metadata");
+      url.searchParams.set("metadataHeaders", "From");
+      url.searchParams.set("metadataHeaders", "To");
+      url.searchParams.set("metadataHeaders", "Cc");
+      return fetch(url.toString(), {
+        headers: { Authorization: `Bearer ${token}` }
+      }).then((r) => r.ok ? r.json() : null);
+    });
+    const results = await Promise.all(fetches);
+    for (const msg of results) {
+      if (!msg?.payload?.headers)
+        continue;
+      const headers = msg.payload.headers;
+      const getHeader = (name) => headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value ?? "";
+      const addresses = [
+        ...parseAddressHeader(getHeader("From")),
+        ...parseAddressHeader(getHeader("To")),
+        ...parseAddressHeader(getHeader("Cc"))
+      ];
+      for (const { name, email } of addresses) {
+        if (seen.has(email))
+          continue;
+        const company_hint = domainToCompany(email);
+        const nameParts = parseName(name);
+        const contact_input = {
+          ...nameParts,
+          display_name: name || email.split("@")[0],
+          emails: [{ address: email, type: "work", is_primary: true }],
+          ...opts.tag_ids?.length ? { tag_ids: opts.tag_ids } : {},
+          source: "email"
+        };
+        seen.set(email, { email, name, company_hint, contact_input });
+      }
+    }
+  }
+  return Array.from(seen.values());
+}
+
 // src/mcp/index.ts
 var server = new Server({ name: "contacts", version: "0.1.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -2431,6 +2577,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         properties: { contact_id: { type: "string" } },
         required: ["contact_id"]
       }
+    },
+    {
+      name: "import_contacts_from_gmail",
+      description: "Extract unique contacts from Gmail messages matching a search query and batch-upsert them. Requires connect-gmail auth login first. Returns { imported, skipped, errors }.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Gmail search query, e.g. 'from:(company.com) newer_than:30d'" },
+          max_messages: { type: "number", description: "Max messages to scan (default 200, max 500)" },
+          gmail_profile: { type: "string", description: "connect-gmail profile to use (default: 'default')" },
+          tag_ids: { type: "array", items: { type: "string" }, description: "Tag IDs to apply to all imported contacts" },
+          group_id: { type: "string", description: "Group ID to add all imported contacts to" },
+          dry_run: { type: "boolean", description: "If true, extract contacts but do not save to database" }
+        },
+        required: ["query"]
+      }
     }
   ]
 }));
@@ -2977,6 +3139,54 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return { content: [{ type: "text", text: "null" }] };
         return { content: [{ type: "text", text: JSON.stringify(contact, null, 2) }] };
       }
+      case "import_contacts_from_gmail": {
+        const db = getDatabase();
+        const extracted = await extractContactsFromGmail({
+          query: a.query,
+          max_messages: a.max_messages,
+          gmail_profile: a.gmail_profile,
+          tag_ids: a.tag_ids,
+          group_id: a.group_id
+        });
+        if (a.dry_run) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({ dry_run: true, would_import: extracted.length, contacts: extracted }, null, 2)
+            }]
+          };
+        }
+        let imported = 0;
+        let skipped = 0;
+        const errors = [];
+        for (const { email, contact_input, company_hint } of extracted) {
+          try {
+            const emailRow = db.prepare(`SELECT contact_id FROM emails WHERE LOWER(address) = LOWER(?) AND contact_id IS NOT NULL LIMIT 1`).get(email);
+            if (emailRow) {
+              skipped++;
+              continue;
+            }
+            const contact = createContact(contact_input);
+            if (a.group_id && typeof a.group_id === "string") {
+              try {
+                db.prepare(`INSERT OR IGNORE INTO contact_groups (contact_id, group_id) VALUES (?, ?)`).run(contact.id, a.group_id);
+              } catch {}
+            }
+            if (company_hint) {
+              autoLinkContactToCompany(contact.id);
+            }
+            imported++;
+          } catch (err) {
+            errors.push(`${email}: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ imported, skipped, errors: errors.length, error_details: errors }, null, 2)
+          }]
+        };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/contacts",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Contact management for AI coding agents — CLI + MCP + Web",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,12 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "dashboard/dist", "LICENSE", "README.md"],
+  "files": [
+    "dist",
+    "dashboard/dist",
+    "LICENSE",
+    "README.md"
+  ],
   "scripts": {
     "build": "cd dashboard && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly --outDir dist",
     "build:core": "bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly --outDir dist",
@@ -27,12 +32,30 @@
     "dev:serve": "bun run src/server/index.ts",
     "prepublishOnly": "bun run build"
   },
-  "keywords": ["contacts", "mcp", "ai", "coding-agent", "claude", "cli", "rolodex", "address-book"],
-  "publishConfig": {"access": "public"},
-  "repository": {"type": "git", "url": "https://github.com/hasna/contacts.git"},
+  "keywords": [
+    "contacts",
+    "mcp",
+    "ai",
+    "coding-agent",
+    "claude",
+    "cli",
+    "rolodex",
+    "address-book"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hasna/contacts.git"
+  },
   "homepage": "https://github.com/hasna/contacts",
-  "bugs": {"url": "https://github.com/hasna/contacts/issues"},
-  "engines": {"bun": ">=1.0.0"},
+  "bugs": {
+    "url": "https://github.com/hasna/contacts/issues"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
   "author": "Andrei Hasna <andrei@hasna.com>",
   "license": "Apache-2.0",
   "dependencies": {