@mcp-monorepo/mail 1.0.0

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,13 @@
+#!/usr/bin/env node
+import { createMcpServer, logger } from '@mcp-monorepo/shared';
+import { registerFetchLatestMailsTool } from './tools/fetch-latest-mails.js';
+import { registerMarkMailsAsSeenTool } from './tools/mark-mails-as-seen.js';
+import { registerReadMailTool } from './tools/read-mail.js';
+import { registerSearchMailsTool } from './tools/search-mails.js';
+createMcpServer({
+    name: 'mail',
+    importMetaPath: import.meta.filename,
+    title: 'Mail MCP Server',
+    tools: [registerFetchLatestMailsTool, registerSearchMailsTool, registerReadMailTool, registerMarkMailsAsSeenTool],
+}).catch((e) => logger.error('Failed to start mail server', e));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,eAAe,CAAC;IACd,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,CAAC,4BAA4B,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,2BAA2B,CAAC;CAClH,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,CAAA"}

package/dist/lib/accounts.d.ts

@@ -0,0 +1,17 @@
+import type { AccountCredentials } from './types.js';
+/**
+ * Parses the MAIL_ACCOUNTS env variable into an array of AccountCredentials.
+ * Format: user:pass@host:port (space-separated for multiple accounts)
+ * Handles special characters in user/pass robustly.
+ * Throws on invalid/missing format.
+ */
+export declare function parseMailAccounts(): AccountCredentials[];
+/**
+ * Finds a specific mail account from the configured environment variables.
+ * @throws An error if the account is not found.
+ */
+export declare function findMailAccount({ username, host }: {
+    username: string;
+    host: string;
+}): AccountCredentials;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/lib/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/lib/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,EAAE,CAyBxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAO1G"}

package/dist/lib/accounts.js

@@ -0,0 +1,48 @@
+/**
+ * Parses the MAIL_ACCOUNTS env variable into an array of AccountCredentials.
+ * Format: user:pass@host:port (space-separated for multiple accounts)
+ * Handles special characters in user/pass robustly.
+ * Throws on invalid/missing format.
+ */
+export function parseMailAccounts() {
+    const env = process.env.MAIL_ACCOUNTS;
+    if (!env)
+        throw new Error('MAIL_ACCOUNTS env variable is not set');
+    return env
+        .split(' ')
+        .filter(Boolean)
+        .map((entry) => {
+        const atIdx = entry.lastIndexOf('@');
+        if (atIdx === -1)
+            throw new Error('Invalid MAIL_ACCOUNTS entry: Could not split at LAST @ for host/port, FIRST for user/pass');
+        const cred = entry.slice(0, atIdx);
+        const hostPort = entry.slice(atIdx + 1);
+        const colonIdx = cred.indexOf(':');
+        if (colonIdx === -1)
+            throw new Error('Invalid MAIL_ACCOUNTS entry (missing colon in user:pass)');
+        const user = cred.slice(0, colonIdx);
+        const pass = cred.slice(colonIdx + 1);
+        const hostPortMatch = hostPort.match(/^(.*?):(\d+)$/);
+        if (!hostPortMatch)
+            throw new Error(`Invalid MAIL_ACCOUNTS entry (host:port): ${entry}`);
+        return {
+            user,
+            pass,
+            host: hostPortMatch[1],
+            port: Number(hostPortMatch[2]),
+        };
+    });
+}
+/**
+ * Finds a specific mail account from the configured environment variables.
+ * @throws An error if the account is not found.
+ */
+export function findMailAccount({ username, host }) {
+    const accounts = parseMailAccounts();
+    const account = accounts.find((a) => a.user === username && a.host === host);
+    if (!account) {
+        throw new Error(`Account for ${username}@${host} not found in configuration.`);
+    }
+    return account;
+}
+//# sourceMappingURL=accounts.js.map

package/dist/lib/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/lib/accounts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAClE,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,KAAK,KAAK,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAA;QAC9G,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAChG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;QACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;QACrD,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,KAAK,EAAE,CAAC,CAAA;QACxF,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;YACtB,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAC/B,CAAA;IACH,CAAC,CAAC,CAAA;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAsC;IACpF,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,IAAI,IAAI,8BAA8B,CAAC,CAAA;IAChF,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/lib/imap.d.ts

@@ -0,0 +1,4 @@
+import { ImapFlow, type MailboxLockObject } from 'imapflow';
+import type { AccountCredentials } from './types.js';
+export declare function withImapClient<T>(account: AccountCredentials, action: (client: ImapFlow, lock: MailboxLockObject) => Promise<T>): Promise<T>;
+//# sourceMappingURL=imap.d.ts.map

package/dist/lib/imap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap.d.ts","sourceRoot":"","sources":["../../src/lib/imap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAChE,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/lib/imap.js

@@ -0,0 +1,21 @@
+import { logger } from '@mcp-monorepo/shared';
+import { ImapFlow } from 'imapflow';
+export async function withImapClient(account, action) {
+    const client = new ImapFlow({
+        host: account.host,
+        port: account.port,
+        secure: true,
+        auth: { user: account.user, pass: account.pass },
+        logger: false, // Set to true for verbose IMAP logging
+    });
+    await client.connect();
+    const lock = await client.getMailboxLock('INBOX');
+    try {
+        return await action(client, lock);
+    }
+    finally {
+        lock.release();
+        await client.logout().catch((e) => logger.warn(`Failed to logout from ${account.host}`, e));
+    }
+}
+//# sourceMappingURL=imap.js.map

package/dist/lib/imap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap.js","sourceRoot":"","sources":["../../src/lib/imap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAA0B,MAAM,UAAU,CAAA;AAI3D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B,EAC3B,MAAiE;IAEjE,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAChD,MAAM,EAAE,KAAK,EAAE,uCAAuC;KACvD,CAAC,CAAA;IAEF,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACtB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7F,CAAC;AACH,CAAC"}

package/dist/lib/mail.service.d.ts

@@ -0,0 +1,10 @@
+import type { AccountCredentials, Mail, MailMarkResult, ReadMailResult } from './types.js';
+export declare function searchMails(account: AccountCredentials, { searchString, searchBody, fromContains }: {
+    searchString?: string;
+    searchBody?: boolean;
+    fromContains?: string;
+}): Promise<Mail[]>;
+export declare function fetchLatestMails(account: AccountCredentials, days?: number): Promise<Mail[]>;
+export declare function readMailContent(account: AccountCredentials, mailId: string): Promise<ReadMailResult>;
+export declare function markMailAsSeen(account: AccountCredentials, mailId: string): Promise<MailMarkResult>;
+//# sourceMappingURL=mail.service.d.ts.map

package/dist/lib/mail.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.service.d.ts","sourceRoot":"","sources":["../../src/lib/mail.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAe1F,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,EAC3B,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACjH,OAAO,CAAC,IAAI,EAAE,CAAC,CAmBjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAM7F;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAmC1G;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBzG"}

package/dist/lib/mail.service.js

@@ -0,0 +1,94 @@
+import { withImapClient } from './imap.js';
+import { convertHtmlToText, findTextPart, getStartOfPeriodUTC, mapImapMessageToMail, streamToString } from './utils.js';
+async function fetchAndMapMails(client, uids, accountIdentifier) {
+    if (!uids || uids.length === 0) {
+        return [];
+    }
+    const fetchedMails = [];
+    for await (const msg of client.fetch(uids, { envelope: true, flags: true, uid: true }, { uid: true })) {
+        fetchedMails.push(mapImapMessageToMail(msg, accountIdentifier));
+    }
+    return fetchedMails.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+}
+export async function searchMails(account, { searchString, searchBody, fromContains }) {
+    const accountIdentifier = `${account.user}@${account.host}`;
+    return withImapClient(account, async (client) => {
+        const orConditions = [];
+        if (searchString) {
+            orConditions.push({ subject: searchString });
+            if (searchBody) {
+                orConditions.push({ body: searchString });
+            }
+        }
+        if (fromContains) {
+            orConditions.push({ from: fromContains });
+        }
+        const searchQuery = orConditions.length > 1 ? { or: orConditions } : orConditions[0];
+        const uids = (await client.search(searchQuery, { uid: true })) || [];
+        return fetchAndMapMails(client, uids, accountIdentifier);
+    });
+}
+export async function fetchLatestMails(account, days = 2) {
+    const accountIdentifier = `${account.user}@${account.host}`;
+    return withImapClient(account, async (client) => {
+        const uids = (await client.search({ since: getStartOfPeriodUTC(days) }, { uid: true })) || [];
+        return fetchAndMapMails(client, uids, accountIdentifier);
+    });
+}
+export async function readMailContent(account, mailId) {
+    try {
+        return await withImapClient(account, async (client) => {
+            const msg = await client.fetchOne(mailId, { envelope: true, bodyStructure: true }, { uid: true });
+            if (!msg)
+                throw new Error(`Mail with ID ${mailId} not found.`);
+            const textPart = msg.bodyStructure && findTextPart(msg.bodyStructure, 'plain');
+            const htmlPart = msg.bodyStructure && findTextPart(msg.bodyStructure, 'html');
+            let content = '';
+            if (textPart?.part) {
+                const { content: stream } = await client.download(mailId, textPart.part, { uid: true });
+                content = await streamToString(stream);
+            }
+            else if (htmlPart?.part) {
+                const { content: stream } = await client.download(mailId, htmlPart.part, { uid: true });
+                const htmlRaw = await streamToString(stream);
+                content = convertHtmlToText(htmlRaw);
+            }
+            else {
+                throw new Error('No viewable part (text or html) in mail');
+            }
+            return {
+                id: mailId,
+                title: msg.envelope?.subject || '(no subject)',
+                content,
+            };
+        });
+    }
+    catch (err) {
+        return {
+            id: mailId,
+            title: '',
+            content: '',
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export async function markMailAsSeen(account, mailId) {
+    let title = '(unknown title)';
+    try {
+        await withImapClient(account, async (client) => {
+            const msg = await client.fetchOne(mailId, { envelope: true }, { uid: true });
+            title = (msg && msg.envelope?.subject) || '(no subject)';
+            await client.messageFlagsAdd(mailId, ['\\Seen'], { uid: true });
+        });
+        return { id: mailId, title, success: true };
+    }
+    catch (error) {
+        return {
+            id: mailId,
+            title,
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=mail.service.js.map

package/dist/lib/mail.service.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,36 @@
+export interface AccountCredentials {
+    user: string;
+    pass: string;
+    host: string;
+    port: number;
+}
+export interface MailAddress {
+    address?: string;
+    name?: string;
+}
+export interface Mail {
+    uid: string;
+    account: string;
+    title: string;
+    read: boolean;
+    from: MailAddress;
+    date: string;
+}
+export interface MailAccountResult {
+    account: string;
+    mails: Mail[];
+    error?: string;
+}
+export interface ReadMailResult {
+    id: string;
+    title: string;
+    content: string;
+    error?: string;
+}
+export interface MailMarkResult {
+    id: string;
+    title: string;
+    success: boolean;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

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

package/dist/lib/utils.d.ts

@@ -0,0 +1,10 @@
+import type { Mail } from './types.js';
+import type { FetchMessageObject, MessageStructureObject } from 'imapflow';
+export declare function streamToString(stream: NodeJS.ReadableStream): Promise<string>;
+export declare function findTextPart(struct: MessageStructureObject, subtype: 'plain' | 'html'): {
+    part: string;
+} | undefined;
+export declare function convertHtmlToText(html: string): string;
+export declare function mapImapMessageToMail(msg: FetchMessageObject, accountIdentifier: string): Mail;
+export declare const getStartOfPeriodUTC: (daysAgo: number) => Date;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAE1E,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAInF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAWpH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAY7F;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,IAA4D,CAAA"}

package/dist/lib/utils.js

@@ -0,0 +1,40 @@
+import { htmlToText } from 'html-to-text';
+export async function streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString('utf8');
+}
+export function findTextPart(struct, subtype) {
+    if (struct.type?.toLowerCase() === `text/${subtype}` && struct.part) {
+        return { part: struct.part };
+    }
+    if (struct.childNodes) {
+        for (const child of struct.childNodes) {
+            const found = findTextPart(child, subtype);
+            if (found)
+                return found;
+        }
+    }
+    return undefined;
+}
+export function convertHtmlToText(html) {
+    return htmlToText(html, {
+        wordwrap: 130,
+        selectors: [{ selector: 'h1', options: { uppercase: false } }],
+    });
+}
+export function mapImapMessageToMail(msg, accountIdentifier) {
+    const from = msg.envelope?.from?.[0];
+    const date = msg.envelope?.date ?? new Date();
+    return {
+        uid: String(msg.uid),
+        account: accountIdentifier,
+        title: msg.envelope?.subject || '(no subject)',
+        read: msg.flags?.has('\\Seen') ?? false,
+        date: date.toISOString().slice(0, 16).replace('T', ' '),
+        from: { address: from?.address, name: from?.name },
+    };
+}
+export const getStartOfPeriodUTC = (daysAgo) => new Date(Date.now() - daysAgo * 24 * 60 * 60 * 1000);
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA6B;IAChE,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA8B,EAAE,OAAyB;IACpF,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,QAAQ,OAAO,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC1C,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,UAAU,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;KAC/D,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAuB,EAAE,iBAAyB;IACrF,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI,IAAI,EAAE,CAAA;IAE7C,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACpB,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,cAAc;QAC9C,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK;QACvC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;QACvD,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;KACnD,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAQ,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA"}

package/dist/tools/fetch-latest-mails.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerFetchLatestMailsTool: (server: McpServer) => void;
+//# sourceMappingURL=fetch-latest-mails.d.ts.map

package/dist/tools/fetch-latest-mails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-latest-mails.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-latest-mails.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAcxE,eAAO,MAAM,4BAA4B,GAAI,QAAQ,SAAS,SA4C1D,CAAA"}

package/dist/tools/fetch-latest-mails.js

@@ -0,0 +1,57 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { parseMailAccounts } from '../lib/accounts.js';
+import { fetchLatestMails } from '../lib/mail.service.js';
+const mailSchema = z.object({
+    uid: z.string(),
+    account: z.string(),
+    title: z.string(),
+    read: z.boolean(),
+    from: z.object({
+        address: z.string().optional(),
+        name: z.string().optional(),
+    }),
+    date: z.string(),
+});
+export const registerFetchLatestMailsTool = (server) => registerTool(server, {
+    name: 'fetch-latest-mails',
+    title: 'Fetch Latest Mails',
+    description: 'Query all mails from the past two days for all configured accounts. No parameters.',
+    inputSchema: {},
+    outputSchema: {
+        accounts: z.array(z.object({
+            account: z.string(),
+            mails: z.array(mailSchema),
+            error: z.string().optional(),
+        })),
+    },
+    isReadOnly: true,
+    async fetcher() {
+        const accounts = parseMailAccounts();
+        if (!accounts.length) {
+            throw new Error('MAIL_ACCOUNTS env variable is not configured correctly');
+        }
+        const results = [];
+        for (const account of accounts) {
+            const accountIdentifier = `${account.user}@${account.host}`;
+            try {
+                const mails = await fetchLatestMails(account);
+                results.push({ account: accountIdentifier, mails });
+            }
+            catch (error) {
+                results.push({
+                    account: accountIdentifier,
+                    mails: [],
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    },
+    formatter(data) {
+        return {
+            accounts: data,
+        };
+    },
+});
+//# sourceMappingURL=fetch-latest-mails.js.map

package/dist/tools/fetch-latest-mails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-latest-mails.js","sourceRoot":"","sources":["../../src/tools/fetch-latest-mails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAKzD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,MAAiB,EAAE,EAAE,CAChE,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,oFAAoF;IACjG,WAAW,EAAE,EAAE;IACf,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;YAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC,CACH;KACF;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC3E,CAAC;QAED,MAAM,OAAO,GAAwB,EAAE,CAAA;QAEvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,iBAAiB,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;YAC3D,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAA;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO,EAAE,iBAAiB;oBAC1B,KAAK,EAAE,EAAE;oBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO;YACL,QAAQ,EAAE,IAAI;SACf,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/mark-mails-as-seen.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerMarkMailsAsSeenTool: (server: McpServer) => void;
+//# sourceMappingURL=mark-mails-as-seen.d.ts.map

package/dist/tools/mark-mails-as-seen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-mails-as-seen.d.ts","sourceRoot":"","sources":["../../src/tools/mark-mails-as-seen.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,2BAA2B,GAAI,QAAQ,SAAS,SA8CzD,CAAA"}

package/dist/tools/mark-mails-as-seen.js

@@ -0,0 +1,46 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { findMailAccount } from '../lib/accounts.js';
+import { markMailAsSeen } from '../lib/mail.service.js';
+export const registerMarkMailsAsSeenTool = (server) => registerTool(server, {
+    name: 'mark-mails-as-seen',
+    title: 'Mark Mails as Seen',
+    description: 'Marks specified emails as seen/read in the INBOX. Requires username, IMAP server, and a list of mail UIDs.',
+    inputSchema: {
+        username: z.string().describe('Username for IMAP authentication'),
+        imapServer: z.string().describe('IMAP server hostname'),
+        mailIds: z.array(z.string()).min(1).describe('List of mail UIDs to mark as seen'),
+    },
+    outputSchema: {
+        account: z.string(),
+        totalProcessed: z.number(),
+        successCount: z.number(),
+        failureCount: z.number(),
+        results: z.array(z.object({
+            id: z.string(),
+            title: z.string(),
+            success: z.boolean(),
+            error: z.string().optional(),
+        })),
+    },
+    isDestructive: true,
+    async fetcher({ username, imapServer, mailIds }) {
+        const account = findMailAccount({ username, host: imapServer });
+        const results = [];
+        for (const mailId of mailIds) {
+            // Await each call individually to handle per-mail errors
+            results.push(await markMailAsSeen(account, mailId));
+        }
+        return {
+            account: `${account.user}@${account.host}`,
+            totalProcessed: mailIds.length,
+            successCount: results.filter((r) => r.success).length,
+            failureCount: results.filter((r) => !r.success).length,
+            results,
+        };
+    },
+    formatter(data) {
+        return data;
+    },
+});
+//# sourceMappingURL=mark-mails-as-seen.js.map

package/dist/tools/mark-mails-as-seen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-mails-as-seen.js","sourceRoot":"","sources":["../../src/tools/mark-mails-as-seen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAKvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAiB,EAAE,EAAE,CAC/D,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,4GAA4G;IAC9G,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACjE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACvD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KAClF;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC,CACH;KACF;IACD,aAAa,EAAE,IAAI;IACnB,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE;QAC7C,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;QAE/D,MAAM,OAAO,GAAqB,EAAE,CAAA;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,yDAAyD;YACzD,OAAO,CAAC,IAAI,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QACrD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;YAC1C,cAAc,EAAE,OAAO,CAAC,MAAM;YAC9B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YACrD,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YACtD,OAAO;SACR,CAAA;IACH,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/read-mail.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerReadMailTool: (server: McpServer) => void;
+//# sourceMappingURL=read-mail.d.ts.map

package/dist/tools/read-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-mail.d.ts","sourceRoot":"","sources":["../../src/tools/read-mail.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SAmClD,CAAA"}

package/dist/tools/read-mail.js

@@ -0,0 +1,36 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { findMailAccount } from '../lib/accounts.js';
+import { readMailContent } from '../lib/mail.service.js';
+export const registerReadMailTool = (server) => registerTool(server, {
+    name: 'read-mail',
+    title: 'Read Mail Content',
+    description: 'Reads the content and subject/title of specified mails. If only HTML is present, converts it to plain text.',
+    inputSchema: {
+        username: z.string().min(1, 'username required'),
+        imapServer: z.string().min(1, 'imapServer required'),
+        mailIds: z.array(z.string().min(1)).min(1, 'Provide at least one mail ID'),
+    },
+    outputSchema: {
+        mails: z.array(z.object({
+            id: z.string(),
+            title: z.string(),
+            content: z.string(),
+            error: z.string().optional(),
+        })),
+    },
+    isReadOnly: true,
+    async fetcher({ username, imapServer, mailIds }) {
+        const account = findMailAccount({ username, host: imapServer });
+        const results = [];
+        for (const mailId of mailIds) {
+            // Await each call individually to handle per-mail errors
+            results.push(await readMailContent(account, mailId));
+        }
+        return results;
+    },
+    formatter(data) {
+        return { mails: data };
+    },
+});
+//# sourceMappingURL=read-mail.js.map

package/dist/tools/read-mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-mail.js","sourceRoot":"","sources":["../../src/tools/read-mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAE,EAAE,CACxD,YAAY,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,6GAA6G;IAC/G,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;QAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;QACpD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;KAC3E;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC,CACH;KACF;IACD,UAAU,EAAE,IAAI;IAChB,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE;QAC7C,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;QAE/D,MAAM,OAAO,GAAqB,EAAE,CAAA;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,yDAAyD;YACzD,OAAO,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QACtD,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACxB,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/search-mails.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerSearchMailsTool: (server: McpServer) => void;
+//# sourceMappingURL=search-mails.d.ts.map

package/dist/tools/search-mails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-mails.d.ts","sourceRoot":"","sources":["../../src/tools/search-mails.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAcxE,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,SAiDrD,CAAA"}

package/dist/tools/search-mails.js

@@ -0,0 +1,61 @@
+import { registerTool } from '@mcp-monorepo/shared';
+import { z } from 'zod';
+import { parseMailAccounts } from '../lib/accounts.js';
+import { searchMails } from '../lib/mail.service.js';
+const mailSchema = z.object({
+    uid: z.string(),
+    account: z.string(),
+    title: z.string(),
+    read: z.boolean(),
+    from: z.object({
+        address: z.string().optional(),
+        name: z.string().optional(),
+    }),
+    date: z.string(),
+});
+export const registerSearchMailsTool = (server) => registerTool(server, {
+    name: 'search-mails',
+    title: 'Search Mails',
+    description: 'Find mails by subject, body, or sender address across all configured accounts. At least one of searchString or fromContains must be set.',
+    inputSchema: {
+        searchString: z.string().min(1).optional().describe('Substring to search in subject or body.'),
+        searchBody: z.boolean().optional().describe('If true, also search in mail body.'),
+        fromContains: z.string().min(1).optional().describe('Substring to search in sender address.'),
+    },
+    outputSchema: {
+        accounts: z.array(z.object({
+            account: z.string(),
+            mails: z.array(mailSchema),
+            error: z.string().optional(),
+        })),
+    },
+    isReadOnly: true,
+    async fetcher({ searchString, searchBody, fromContains }) {
+        if (!searchString && !fromContains) {
+            throw new Error('At least one of searchString or fromContains must be provided.');
+        }
+        const accounts = parseMailAccounts();
+        const results = [];
+        for (const account of accounts) {
+            const accountIdentifier = `${account.user}@${account.host}`;
+            try {
+                const mails = await searchMails(account, { searchString, searchBody, fromContains });
+                results.push({ account: accountIdentifier, mails });
+            }
+            catch (error) {
+                results.push({
+                    account: accountIdentifier,
+                    mails: [],
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    },
+    formatter(data) {
+        return {
+            accounts: data,
+        };
+    },
+});
+//# sourceMappingURL=search-mails.js.map

package/dist/tools/search-mails.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mcp-monorepo/mail",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "MCP server for mail tools (fetch, read, search, mark as seen).",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-npm-server": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@mcp-monorepo/shared": "*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.76",
+    "imapflow": "^1.0.191",
+    "html-to-text": "^9.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "rimraf": "^6.0.1",
+    "@types/imapflow": "^1.0.23",
+    "@types/html-to-text": "^9.0.4"
+  }
+}