read-email-mcp 1.0.0 → 2.0.0

package/dist/providers.js

@@ -0,0 +1,122 @@
+export const PROVIDER_PRESETS = [
+    {
+        id: "gmail",
+        label: "Gmail / Google Workspace",
+        imapHost: "imap.gmail.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["gmail.com", "googlemail.com"],
+        hints: [
+            "Gmail requires an app password when 2FA is on: https://myaccount.google.com/apppasswords",
+            "Enable IMAP in Gmail settings: Settings > See all settings > Forwarding and POP/IMAP"
+        ]
+    },
+    {
+        id: "outlook",
+        label: "Outlook.com / Microsoft 365",
+        imapHost: "outlook.office365.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["outlook.com", "hotmail.com", "hotmail.co.uk", "live.com", "msn.com"],
+        hints: [
+            "Microsoft may require an app password or OAuth2 for accounts with MFA",
+            "Some Microsoft 365 tenants disable basic-auth IMAP; ask your admin if login fails"
+        ]
+    },
+    {
+        id: "yahoo",
+        label: "Yahoo Mail",
+        imapHost: "imap.mail.yahoo.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["yahoo.com", "ymail.com", "rocketmail.com", "yahoo.co.uk", "yahoo.ca", "yahoo.co.in"],
+        hints: ["Yahoo requires an app password: https://login.yahoo.com/account/security"]
+    },
+    {
+        id: "icloud",
+        label: "iCloud Mail",
+        imapHost: "imap.mail.me.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["icloud.com", "me.com", "mac.com"],
+        hints: ["iCloud requires an app-specific password: https://appleid.apple.com > Sign-In and Security > App-Specific Passwords"]
+    },
+    {
+        id: "fastmail",
+        label: "Fastmail",
+        imapHost: "imap.fastmail.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["fastmail.com", "fastmail.fm", "sent.as"],
+        hints: ["Fastmail requires an app password: Settings > Privacy & Security > Integrations > App passwords"]
+    },
+    {
+        id: "zoho",
+        label: "Zoho Mail",
+        imapHost: "imap.zoho.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["zoho.com", "zohomail.com"],
+        hints: ["Enable IMAP access in Zoho Mail settings first (Mail settings > IMAP access)"]
+    },
+    {
+        id: "aol",
+        label: "AOL Mail",
+        imapHost: "imap.aol.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["aol.com", "aim.com"],
+        hints: ["AOL requires an app password: https://login.aol.com/account/security"]
+    },
+    {
+        id: "gmx",
+        label: "GMX",
+        imapHost: "imap.gmx.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["gmx.com", "gmx.net", "gmx.de", "gmx.at", "gmx.ch"],
+        hints: []
+    },
+    {
+        id: "proton",
+        label: "Proton Mail (via Bridge)",
+        imapHost: "127.0.0.1",
+        imapPort: 1143,
+        imapSecure: false,
+        domains: ["proton.me", "protonmail.com", "pm.me"],
+        hints: [
+            "Proton Mail needs Proton Mail Bridge running locally (https://proton.me/mail/bridge)",
+            "Use the Bridge-generated mailbox password, not your Proton account password"
+        ]
+    },
+    {
+        id: "yandex",
+        label: "Yandex Mail",
+        imapHost: "imap.yandex.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["yandex.com", "yandex.ru", "ya.ru"],
+        hints: ["Enable IMAP in Yandex Mail settings; app password required with 2FA"]
+    },
+    {
+        id: "mailcom",
+        label: "mail.com",
+        imapHost: "imap.mail.com",
+        imapPort: 993,
+        imapSecure: true,
+        domains: ["mail.com", "email.com", "usa.com", "post.com"],
+        hints: []
+    }
+];
+export function findProvider(id) {
+    const needle = id.trim().toLowerCase();
+    return PROVIDER_PRESETS.find((preset) => preset.id === needle) ?? null;
+}
+export function detectProvider(email) {
+    const domain = email.split("@")[1]?.trim().toLowerCase();
+    if (!domain) {
+        return null;
+    }
+    return PROVIDER_PRESETS.find((preset) => preset.domains.includes(domain)) ?? null;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/server.d.ts

@@ -1,10 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { z } from "zod";
-import { EmailSyncService } from "./imap.js";
-import type { AppConfig } from "./config.js";
-import { EmailStore } from "./store.js";
-import { createToolHandlers, type ToolResult } from "./tools.js";
-export declare const REQUIRED_TOOL_NAMES: readonly ["sync_email", "get_sync_status", "list_mailboxes", "get_recent_emails", "browse_email_dates", "search_emails", "list_emails", "get_email", "get_thread", "get_raw_email", "get_storage_stats", "optimize_email_store"];
+import { createToolHandlers, type AccountRuntime, type ToolResult } from "./tools.js";
+export declare const REQUIRED_TOOL_NAMES: readonly ["sync_email", "list_accounts", "get_sync_status", "list_mailboxes", "get_recent_emails", "browse_email_dates", "search_emails", "list_emails", "get_email", "get_emails", "get_thread", "list_attachments", "get_attachment", "get_inbox_summary", "list_senders", "check_accounts", "get_raw_email", "get_storage_stats", "optimize_email_store"];
 type EmailToolHandlers = ReturnType<typeof createToolHandlers>;
 export interface ToolRegistrar {
     registerTool(name: string, config: {
@@ -13,5 +10,5 @@ export interface ToolRegistrar {
     }, handler: (args: unknown) => Promise<ToolResult>): unknown;
 }
 export declare function registerEmailTools(registrar: ToolRegistrar, handlers: EmailToolHandlers): void;
-export declare function createEmailMcpServer(config: AppConfig, store: EmailStore, sync: EmailSyncService): McpServer;
+export declare function createEmailMcpServer(accounts: AccountRuntime[]): McpServer;
 export {};

package/dist/server.js

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { createToolHandlers, toolDescriptions, toolSchemas } from "./tools.js";
 export const REQUIRED_TOOL_NAMES = [
     "sync_email",
+    "list_accounts",
     "get_sync_status",
     "list_mailboxes",
     "get_recent_emails",
@@ -9,7 +10,13 @@ export const REQUIRED_TOOL_NAMES = [
     "search_emails",
     "list_emails",
     "get_email",
+    "get_emails",
     "get_thread",
+    "list_attachments",
+    "get_attachment",
+    "get_inbox_summary",
+    "list_senders",
+    "check_accounts",
     "get_raw_email",
     "get_storage_stats",
     "optimize_email_store"
@@ -22,17 +29,12 @@ export function registerEmailTools(registrar, handlers) {
         }, async (args) => handlers[name](args));
     }
 }
-export function createEmailMcpServer(config, store, sync) {
+export function createEmailMcpServer(accounts) {
     const server = new McpServer({
         name: "read-email-mcp",
-        version: "1.0.0-rc.1"
-    });
-    const handlers = createToolHandlers({
-        accountEmail: config.account.email,
-        storagePath: config.storage.accountDir,
-        store,
-        sync
+        version: "2.0.0"
     });
+    const handlers = createToolHandlers({ accounts });
     registerEmailTools(server, handlers);
     return server;
 }

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAEhG,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY;IACZ,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,aAAa;IACb,WAAW;IACX,YAAY;IACZ,eAAe;IACf,mBAAmB;IACnB,sBAAsB;CACd,CAAC;AAaX,MAAM,UAAU,kBAAkB,CAAC,SAAwB,EAAE,QAA2B;IACtF,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,SAAS,CAAC,YAAY,CACpB,IAAI,EACJ;YACE,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC;SAC/B,EACD,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC,IAAa,CAAC,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,KAAiB,EAAE,IAAsB;IAC/F,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;QAClC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU;QACtC,KAAK;QACL,IAAI;KACL,CAAC,CAAC;IACH,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAwC,MAAM,YAAY,CAAC;AAErH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,aAAa;IACb,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;IAChB,mBAAmB;IACnB,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,sBAAsB;CACd,CAAC;AAaX,MAAM,UAAU,kBAAkB,CAAC,SAAwB,EAAE,QAA2B;IACtF,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,SAAS,CAAC,YAAY,CACpB,IAAI,EACJ;YACE,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC;SAC/B,EACD,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC,IAAa,CAAC,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA0B;IAC7D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/store.d.ts

@@ -1,4 +1,4 @@
-import type { DateBucket, DateBucketOptions, MailboxRecord, MessageFilters, MessageInput, PaginatedMessages, StoredMessage, SyncResultRecord, SyncStatus } from "./types.js";
+import type { DateBucket, DateBucketOptions, MailboxRecord, MessageFilters, MessageInput, MessageSummary, PaginatedMessages, SenderStat, StoredMessage, SyncResultRecord, SyncStatus } from "./types.js";
 export declare class EmailStore {
     private readonly databasePath;
     private db;
@@ -8,16 +8,36 @@ export declare class EmailStore {
     upsertMailbox(mailbox: MailboxRecord): void;
     listMailboxes(): MailboxRecord[];
     getMailbox(mailboxPath: string): MailboxRecord | null;
-    deleteMailboxMessages(mailboxPath: string): void;
+    deleteMailboxMessages(mailboxPath: string): string[];
+    updateMessageFlags(mailbox: string, uid: number, flags: string[]): boolean;
+    pruneMailboxMessagesExcept(mailboxPath: string, keepUids: ReadonlySet<number>, maxUid: number): string[];
     upsertMessage(message: MessageInput): number;
     searchMessages(filters?: MessageFilters): PaginatedMessages;
     listMessages(filters?: MessageFilters): PaginatedMessages;
     getMessageById(id: number): StoredMessage | null;
     getMessageByMailboxUid(mailbox: string, uid: number): StoredMessage | null;
     getMessageByMessageId(messageId: string): StoredMessage | null;
+    getMessagesByIds(ids: number[]): StoredMessage[];
     getThread(messageIdOrInternalId: number | string): StoredMessage[];
+    private findMessagesReferencing;
     getDateBuckets(options: DateBucketOptions): DateBucket[];
     recordSyncResult(result: SyncResultRecord): void;
+    getMessageCounts(): {
+        total: number;
+        unread: number;
+        flagged: number;
+    };
+    getTopSenders(options?: {
+        limit?: number;
+        unreadOnly?: boolean;
+    }): SenderStat[];
+    searchRanked(filters: MessageFilters, paging: {
+        limit: number;
+        offset: number;
+    }): {
+        items: MessageSummary[];
+        hasMore: boolean;
+    };
     getSyncStatus(): SyncStatus;
     getStorageStats(): {
         databasePath: string;
@@ -36,3 +56,12 @@ export declare class EmailStore {
     private refreshFts;
     private get connection();
 }
+export declare function encodeCursor(message: {
+    date: string;
+    id: number;
+}, sort: NonNullable<MessageFilters["sort"]>): string;
+export declare function decodeCursor(cursor?: string): {
+    date: string;
+    id: number;
+    sort: NonNullable<MessageFilters["sort"]>;
+} | null;