@miguelarios/email-mcp 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @miguelarios/email-mcp
+
+MCP server for email via IMAP/SMTP — read, search, send, and manage emails.
+
+## Usage
+
+```bash
+npx @miguelarios/email-mcp
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `IMAP_HOST` | Yes | — | IMAP server hostname |
+| `IMAP_USER` | Yes | — | IMAP username |
+| `IMAP_PASS` | Yes | — | IMAP password |
+| `IMAP_PORT` | No | `993` | IMAP port |
+| `IMAP_SECURE` | No | `true` | Use TLS |
+| `SMTP_HOST` | Yes | — | SMTP server hostname |
+| `SMTP_USER` | Yes | — | SMTP username |
+| `SMTP_PASS` | Yes | — | SMTP password |
+| `SMTP_PORT` | No | `465` | SMTP port |
+| `SMTP_SECURE` | No | `true` | Use TLS |
+| `SMTP_FROM_NAME` | No | — | Display name for outgoing emails |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_emails` | Search and filter emails by folder, sender, subject, date, flags |
+| `get_email` | Fetch full email by UID — headers, body, attachment metadata |
+| `send_email` | Compose and send via SMTP with attachment support |
+| `move_email` | Move email between folders |
+| `mark_email` | Set/unset flags (read, unread, flagged) |
+| `delete_email` | Move to trash or permanently delete |
+| `list_folders` | List all IMAP folders |
+| `create_folder` | Create an IMAP folder |
+| `download_attachment` | Download attachment by email UID and filename |
+| `get_email_raw` | Export email as .eml |
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

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

package/dist/bin/cli.d.ts.map

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

package/dist/bin/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startServer } from "../main.js";
+startServer().catch((error) => {
+    console.error("[email-mcp] Fatal error:", error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,4 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(): Promise<Server>;
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CA8BpD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}

package/dist/main.js

@@ -0,0 +1,36 @@
+import { loadEmailConfig } from "@miguelarios/pim-core";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { ImapService } from "./services/ImapService.js";
+import { SmtpService } from "./services/SmtpService.js";
+import { EMAIL_TOOLS, handleEmailTool } from "./tools/emailTools.js";
+export async function createServer() {
+    const config = loadEmailConfig();
+    const imapService = new ImapService(config);
+    const smtpService = new SmtpService(config);
+    const server = new Server({ name: "@miguelarios/email-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: EMAIL_TOOLS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleEmailTool(name, (args ?? {}), imapService, smtpService);
+    });
+    const handleShutdown = async () => {
+        process.exit(0);
+    };
+    process.on("SIGINT", handleShutdown);
+    process.on("SIGTERM", handleShutdown);
+    server.onerror = (error) => {
+        console.error("[email-mcp] Server error:", error.message);
+    };
+    return server;
+}
+export async function startServer() {
+    const server = await createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[email-mcp] Server started on stdio");
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,EAAE,EACpD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC"}

package/dist/search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parses structured search query strings into imapflow-compatible search criteria.
+ *
+ * Supported prefixes:
+ * - from:address     → IMAP FROM filter
+ * - to:address       → IMAP TO filter
+ * - subject:text     → IMAP SUBJECT filter
+ * - is:unread/read/flagged → flag filters
+ * - has:attachment    → Content-Type header check
+ * - since:YYYY-MM-DD → date range start
+ * - before:YYYY-MM-DD → date range end
+ * - plain text        → IMAP BODY search
+ */
+export declare function parseSearchQuery(query: string): Record<string, unknown>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiFvE"}

package/dist/search.js

@@ -0,0 +1,98 @@
+/**
+ * Parses structured search query strings into imapflow-compatible search criteria.
+ *
+ * Supported prefixes:
+ * - from:address     → IMAP FROM filter
+ * - to:address       → IMAP TO filter
+ * - subject:text     → IMAP SUBJECT filter
+ * - is:unread/read/flagged → flag filters
+ * - has:attachment    → Content-Type header check
+ * - since:YYYY-MM-DD → date range start
+ * - before:YYYY-MM-DD → date range end
+ * - plain text        → IMAP BODY search
+ */
+export function parseSearchQuery(query) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return {};
+    const criteria = {};
+    const plainParts = [];
+    const tokens = trimmed.split(/\s+/);
+    let i = 0;
+    while (i < tokens.length) {
+        const token = tokens[i];
+        const colonIndex = token.indexOf(":");
+        if (colonIndex > 0) {
+            const prefix = token.substring(0, colonIndex).toLowerCase();
+            const value = token.substring(colonIndex + 1);
+            switch (prefix) {
+                case "from":
+                    criteria.from = value;
+                    i++;
+                    break;
+                case "to":
+                    criteria.to = value;
+                    i++;
+                    break;
+                case "subject": {
+                    const subjectParts = [value];
+                    i++;
+                    while (i < tokens.length && !isPrefix(tokens[i])) {
+                        subjectParts.push(tokens[i]);
+                        i++;
+                    }
+                    criteria.subject = subjectParts.join(" ");
+                    break;
+                }
+                case "is":
+                    switch (value.toLowerCase()) {
+                        case "unread":
+                            criteria.seen = false;
+                            break;
+                        case "read":
+                            criteria.seen = true;
+                            break;
+                        case "flagged":
+                            criteria.flagged = true;
+                            break;
+                    }
+                    i++;
+                    break;
+                case "has":
+                    if (value.toLowerCase() === "attachment") {
+                        criteria.header = { "content-type": "multipart/mixed" };
+                    }
+                    i++;
+                    break;
+                case "since":
+                    criteria.since = new Date(value);
+                    i++;
+                    break;
+                case "before":
+                    criteria.before = new Date(value);
+                    i++;
+                    break;
+                default:
+                    plainParts.push(token);
+                    i++;
+                    break;
+            }
+        }
+        else {
+            plainParts.push(token);
+            i++;
+        }
+    }
+    if (plainParts.length > 0) {
+        criteria.body = plainParts.join(" ");
+    }
+    return criteria;
+}
+const KNOWN_PREFIXES = new Set(["from", "to", "subject", "is", "has", "since", "before"]);
+function isPrefix(token) {
+    const colonIndex = token.indexOf(":");
+    if (colonIndex <= 0)
+        return false;
+    return KNOWN_PREFIXES.has(token.substring(0, colonIndex).toLowerCase());
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/services/ImapService.d.ts

@@ -0,0 +1,61 @@
+import { type EmailConfig } from "@miguelarios/pim-core";
+export interface EmailSummary {
+    uid: number;
+    messageId: string;
+    subject: string;
+    from: {
+        name?: string;
+        address: string;
+    };
+    to: Array<{
+        name?: string;
+        address: string;
+    }>;
+    date: string;
+    flags: string[];
+    hasAttachments: boolean;
+}
+export interface EmailFull extends EmailSummary {
+    cc?: Array<{
+        name?: string;
+        address: string;
+    }>;
+    textBody?: string;
+    htmlBody?: string;
+    attachments: Array<{
+        filename: string;
+        contentType: string;
+        size: number;
+        partId: string;
+    }>;
+}
+export interface FolderInfo {
+    path: string;
+    specialUse?: string;
+    delimiter: string;
+}
+export interface AttachmentData {
+    filename: string;
+    contentType: string;
+    size: number;
+    content: Buffer;
+}
+export interface SearchOptions {
+    limit?: number;
+    offset?: number;
+}
+export declare class ImapService {
+    private config;
+    constructor(config: EmailConfig);
+    private createClient;
+    listFolders(): Promise<FolderInfo[]>;
+    searchEmails(folder: string, query: Record<string, unknown>, options?: SearchOptions): Promise<EmailSummary[]>;
+    fetchEmail(folder: string, uid: number): Promise<EmailFull>;
+    fetchRawEmail(folder: string, uid: number): Promise<string>;
+    moveEmails(folder: string, uids: number[], destination: string): Promise<void>;
+    markEmails(folder: string, uids: number[], flags: string[], action: "add" | "remove"): Promise<void>;
+    deleteEmails(folder: string, uids: number[], permanent?: boolean): Promise<void>;
+    createFolder(path: string): Promise<void>;
+    downloadAttachment(folder: string, uid: number, partId: string): Promise<AttachmentData>;
+}
+//# sourceMappingURL=ImapService.d.ts.map

package/dist/services/ImapService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImapService.d.ts","sourceRoot":"","sources":["../../src/services/ImapService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,uBAAuB,CAAC;AAI5F,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,EAAE,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,EAAE,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,YAAY;IAad,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAiBpC,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IA0DpB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAoD3D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB3D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9E,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,KAAK,GAAG,QAAQ,GACvB,OAAO,CAAC,IAAI,CAAC;IAwBV,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAoC/F"}

package/dist/services/ImapService.js

@@ -0,0 +1,305 @@
+import { EmailError, ErrorCode, toPimError } from "@miguelarios/pim-core";
+import { ImapFlow } from "imapflow";
+import { simpleParser } from "mailparser";
+export class ImapService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    createClient() {
+        return new ImapFlow({
+            host: this.config.imap.host,
+            port: this.config.imap.port,
+            secure: this.config.imap.secure,
+            auth: {
+                user: this.config.imap.user,
+                pass: this.config.imap.pass,
+            },
+            logger: false,
+        });
+    }
+    async listFolders() {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const mailboxes = await client.list();
+            return mailboxes.map((mb) => ({
+                path: mb.path,
+                specialUse: mb.specialUse || undefined,
+                delimiter: mb.delimiter,
+            }));
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async searchEmails(folder, query, options = {}) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const searchCriteria = Object.keys(query).length > 0 ? query : { all: true };
+                const searchResult = await client.search(searchCriteria, {
+                    uid: true,
+                });
+                const uids = searchResult || [];
+                if (uids.length === 0)
+                    return [];
+                const offset = options.offset ?? 0;
+                const limit = options.limit ?? 50;
+                const sliced = uids.slice(offset, offset + limit);
+                const summaries = [];
+                const uidRange = sliced.join(",");
+                for await (const msg of client.fetch(uidRange, {
+                    envelope: true,
+                    flags: true,
+                    bodyStructure: true,
+                    uid: true,
+                })) {
+                    const envelope = msg.envelope;
+                    summaries.push({
+                        uid: msg.uid,
+                        messageId: envelope.messageId || "",
+                        subject: envelope.subject || "",
+                        from: envelope.from?.[0]
+                            ? {
+                                name: envelope.from[0].name,
+                                address: envelope.from[0].address || "",
+                            }
+                            : { address: "unknown" },
+                        to: (envelope.to || []).map((a) => ({
+                            name: a.name,
+                            address: a.address || "",
+                        })),
+                        date: envelope.date?.toISOString() || "",
+                        flags: [...(msg.flags || [])],
+                        hasAttachments: hasAttachmentParts(msg.bodyStructure),
+                    });
+                }
+                return summaries;
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async fetchEmail(folder, uid) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const fetchResult = await client.fetchOne(String(uid), { source: true }, { uid: true });
+                if (!fetchResult || !fetchResult.source) {
+                    throw new EmailError(`Email UID ${uid} not found`, ErrorCode.EMAIL_NOT_FOUND, uid);
+                }
+                const parsed = await simpleParser(fetchResult.source);
+                return {
+                    uid,
+                    messageId: parsed.messageId || "",
+                    subject: parsed.subject || "",
+                    from: parsed.from?.value?.[0]
+                        ? {
+                            name: parsed.from.value[0].name,
+                            address: parsed.from.value[0].address || "",
+                        }
+                        : { address: "unknown" },
+                    to: (Array.isArray(parsed.to) ? parsed.to : parsed.to ? [parsed.to] : [])
+                        .flatMap((addr) => addr.value)
+                        .map((a) => ({ name: a.name, address: a.address || "" })),
+                    cc: (Array.isArray(parsed.cc) ? parsed.cc : parsed.cc ? [parsed.cc] : [])
+                        .flatMap((addr) => addr.value)
+                        .map((a) => ({ name: a.name, address: a.address || "" })) || undefined,
+                    date: parsed.date?.toISOString() || "",
+                    flags: [],
+                    hasAttachments: (parsed.attachments?.length || 0) > 0,
+                    textBody: parsed.text || undefined,
+                    htmlBody: parsed.html || undefined,
+                    attachments: (parsed.attachments || []).map((att, index) => ({
+                        filename: att.filename || `attachment-${index}`,
+                        contentType: att.contentType || "application/octet-stream",
+                        size: att.size || 0,
+                        partId: String(index + 1),
+                    })),
+                };
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            if (error instanceof EmailError)
+                throw error;
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async fetchRawEmail(folder, uid) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const fetchResult = await client.fetchOne(String(uid), { source: true }, { uid: true });
+                if (!fetchResult || !fetchResult.source) {
+                    throw new EmailError(`Email UID ${uid} not found`, ErrorCode.EMAIL_NOT_FOUND, uid);
+                }
+                return fetchResult.source.toString();
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            if (error instanceof EmailError)
+                throw error;
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async moveEmails(folder, uids, destination) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                await client.messageMove(uids.join(","), destination, {
+                    uid: true,
+                });
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async markEmails(folder, uids, flags, action) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const uidRange = uids.join(",");
+                if (action === "add") {
+                    await client.messageFlagsAdd(uidRange, flags, { uid: true });
+                }
+                else {
+                    await client.messageFlagsRemove(uidRange, flags, {
+                        uid: true,
+                    });
+                }
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async deleteEmails(folder, uids, permanent = false) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const uidRange = uids.join(",");
+                if (permanent) {
+                    await client.messageDelete(uidRange, { uid: true });
+                }
+                else {
+                    await client.messageMove(uidRange, "Trash", { uid: true });
+                }
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async createFolder(path) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            await client.mailboxCreate(path);
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+    async downloadAttachment(folder, uid, partId) {
+        const client = this.createClient();
+        try {
+            await client.connect();
+            const lock = await client.getMailboxLock(folder);
+            try {
+                const { meta, content } = await client.download(String(uid), partId, { uid: true });
+                if (!content) {
+                    throw new EmailError(`Attachment ${partId} not found for email ${uid}`, ErrorCode.ATTACHMENT_NOT_FOUND, uid);
+                }
+                const chunks = [];
+                for await (const chunk of content) {
+                    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                }
+                return {
+                    filename: meta.filename || `attachment-${partId}`,
+                    contentType: meta.contentType || "application/octet-stream",
+                    size: meta.expectedSize || Buffer.concat(chunks).length,
+                    content: Buffer.concat(chunks),
+                };
+            }
+            finally {
+                lock.release();
+            }
+        }
+        catch (error) {
+            if (error instanceof EmailError)
+                throw error;
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            await client.logout().catch(() => { });
+        }
+    }
+}
+function hasAttachmentParts(bodyStructure) {
+    if (!bodyStructure)
+        return false;
+    if (bodyStructure.type?.toLowerCase().includes("multipart/mixed"))
+        return true;
+    if (bodyStructure.childNodes) {
+        return bodyStructure.childNodes.some((node) => hasAttachmentParts(node));
+    }
+    return false;
+}
+//# sourceMappingURL=ImapService.js.map

package/dist/services/ImapService.js.map

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

package/dist/services/SmtpService.d.ts

@@ -0,0 +1,27 @@
+import { type EmailConfig } from "@miguelarios/pim-core";
+export interface SendEmailOptions {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: Array<{
+        filename: string;
+        path?: string;
+        content?: string | Buffer;
+        contentType?: string;
+    }>;
+}
+export interface SendResult {
+    messageId: string;
+    accepted: string[];
+    rejected: string[];
+}
+export declare class SmtpService {
+    private config;
+    constructor(config: EmailConfig);
+    private createTransporter;
+    sendEmail(options: SendEmailOptions): Promise<SendResult>;
+}
+//# sourceMappingURL=SmtpService.d.ts.map

package/dist/services/SmtpService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmtpService.d.ts","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAIrE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,iBAAiB;IAYnB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BhE"}

package/dist/services/SmtpService.js

@@ -0,0 +1,46 @@
+import { toPimError } from "@miguelarios/pim-core";
+import nodemailer from "nodemailer";
+export class SmtpService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    createTransporter() {
+        return nodemailer.createTransport({
+            host: this.config.smtp.host,
+            port: this.config.smtp.port,
+            secure: this.config.smtp.secure,
+            auth: {
+                user: this.config.smtp.user,
+                pass: this.config.smtp.pass,
+            },
+        });
+    }
+    async sendEmail(options) {
+        const transporter = this.createTransporter();
+        try {
+            const from = this.config.fromName
+                ? `"${this.config.fromName}" <${this.config.smtp.user}>`
+                : this.config.smtp.user;
+            const info = await transporter.sendMail({
+                from,
+                to: options.to.join(", "),
+                cc: options.cc?.join(", "),
+                bcc: options.bcc?.join(", "),
+                subject: options.subject,
+                text: options.text,
+                html: options.html,
+                attachments: options.attachments,
+            });
+            return {
+                messageId: info.messageId,
+                accepted: info.accepted,
+                rejected: info.rejected,
+            };
+        }
+        catch (error) {
+            throw toPimError(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+}
+//# sourceMappingURL=SmtpService.js.map

package/dist/services/SmtpService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmtpService.js","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,UAAU,MAAM,YAAY,CAAC;AAwBpC,MAAM,OAAO,WAAW;IACd,MAAM,CAAc;IAE5B,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,iBAAiB;QACvB,OAAO,UAAU,CAAC,eAAe,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YAC/B,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;aAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAyB;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG;gBACxD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAE1B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBACtC,IAAI;gBACJ,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAoB;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAoB;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF"}

package/dist/tools/emailTools.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { ImapService } from "../services/ImapService.js";
+import type { SmtpService } from "../services/SmtpService.js";
+export declare const EMAIL_TOOLS: Tool[];
+export declare function handleEmailTool(name: string, args: Record<string, unknown>, imapService: ImapService, smtpService: SmtpService): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=emailTools.d.ts.map

package/dist/tools/emailTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailTools.d.ts","sourceRoot":"","sources":["../../src/tools/emailTools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,eAAO,MAAM,WAAW,EAAE,IAAI,EAqP7B,CAAC;AAEF,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IACT,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAoGD"}

package/dist/tools/emailTools.js

@@ -0,0 +1,334 @@
+import { toPimError } from "@miguelarios/pim-core";
+import { parseSearchQuery } from "../search.js";
+export const EMAIL_TOOLS = [
+    {
+        name: "list_emails",
+        description: "Search and list emails in a folder. Supports structured query prefixes: from:, to:, subject:, is:unread/read/flagged, has:attachment, since:YYYY-MM-DD, before:YYYY-MM-DD. Plain text searches subject and body. Returns email summaries with UID, subject, sender, date, and flags.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder to search. Defaults to INBOX.",
+                },
+                query: {
+                    type: "string",
+                    description: 'Search query with optional prefixes. Examples: "from:boss@work.com is:unread", "subject:meeting", "has:attachment". Plain text searches body.',
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return. Defaults to 20.",
+                },
+                offset: {
+                    type: "number",
+                    description: "Number of results to skip for pagination. Defaults to 0.",
+                },
+            },
+        },
+    },
+    {
+        name: "get_email",
+        description: "Fetch a full email by UID including headers, text/HTML body, and attachment metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder containing the email. Defaults to INBOX.",
+                },
+                uid: {
+                    type: "number",
+                    description: "The UID of the email to fetch.",
+                },
+            },
+            required: ["uid"],
+        },
+    },
+    {
+        name: "send_email",
+        description: "Compose and send an email via SMTP. Supports to/cc/bcc, text and HTML body, and file attachments.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                to: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Recipient email addresses.",
+                },
+                cc: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "CC email addresses.",
+                },
+                bcc: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "BCC email addresses.",
+                },
+                subject: {
+                    type: "string",
+                    description: "Email subject line.",
+                },
+                text: {
+                    type: "string",
+                    description: "Plain text body.",
+                },
+                html: {
+                    type: "string",
+                    description: "HTML body.",
+                },
+                attachments: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            filename: { type: "string" },
+                            path: {
+                                type: "string",
+                                description: "File path to attach.",
+                            },
+                            content: {
+                                type: "string",
+                                description: "String content to attach.",
+                            },
+                        },
+                        required: ["filename"],
+                    },
+                    description: "File attachments.",
+                },
+            },
+            required: ["to", "subject"],
+        },
+    },
+    {
+        name: "move_email",
+        description: "Move one or more emails to a different IMAP folder.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "Source IMAP folder. Defaults to INBOX.",
+                },
+                uids: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "UIDs of emails to move.",
+                },
+                destination: {
+                    type: "string",
+                    description: "Destination folder path.",
+                },
+            },
+            required: ["uids", "destination"],
+        },
+    },
+    {
+        name: "mark_email",
+        description: 'Set or unset flags on one or more emails. Common flags: "\\Seen" (read), "\\Flagged" (starred).',
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder. Defaults to INBOX.",
+                },
+                uids: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "UIDs of emails to modify.",
+                },
+                flags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'Flags to set/unset (e.g., "\\Seen", "\\Flagged").',
+                },
+                action: {
+                    type: "string",
+                    enum: ["add", "remove"],
+                    description: 'Whether to add or remove the flags. Defaults to "add".',
+                },
+            },
+            required: ["uids", "flags"],
+        },
+    },
+    {
+        name: "delete_email",
+        description: "Delete one or more emails. Moves to Trash by default, or permanently deletes if specified.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder. Defaults to INBOX.",
+                },
+                uids: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "UIDs of emails to delete.",
+                },
+                permanent: {
+                    type: "boolean",
+                    description: "If true, permanently delete instead of moving to Trash. Defaults to false.",
+                },
+            },
+            required: ["uids"],
+        },
+    },
+    {
+        name: "list_folders",
+        description: "List all IMAP folders with their paths and special-use flags (Inbox, Sent, Trash, etc.).",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "create_folder",
+        description: "Create a new IMAP folder.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Folder path to create (e.g., 'Projects/Work').",
+                },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "download_attachment",
+        description: "Download a specific attachment from an email. Returns the attachment content as base64.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder. Defaults to INBOX.",
+                },
+                uid: {
+                    type: "number",
+                    description: "UID of the email containing the attachment.",
+                },
+                partId: {
+                    type: "string",
+                    description: "MIME part ID of the attachment (from get_email attachment metadata).",
+                },
+            },
+            required: ["uid", "partId"],
+        },
+    },
+    {
+        name: "get_email_raw",
+        description: "Export an email as raw .eml (RFC 822 source). Useful for archival or forwarding.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                folder: {
+                    type: "string",
+                    description: "IMAP folder. Defaults to INBOX.",
+                },
+                uid: {
+                    type: "number",
+                    description: "UID of the email to export.",
+                },
+            },
+            required: ["uid"],
+        },
+    },
+];
+export async function handleEmailTool(name, args, imapService, smtpService) {
+    try {
+        const folder = args.folder || "INBOX";
+        switch (name) {
+            case "list_emails": {
+                const query = args.query ? parseSearchQuery(args.query) : {};
+                const limit = args.limit || 20;
+                const offset = args.offset || 0;
+                const emails = await imapService.searchEmails(folder, query, {
+                    limit,
+                    offset,
+                });
+                return ok(JSON.stringify(emails, null, 2));
+            }
+            case "get_email": {
+                const uid = args.uid;
+                const email = await imapService.fetchEmail(folder, uid);
+                return ok(JSON.stringify(email, null, 2));
+            }
+            case "send_email": {
+                const result = await smtpService.sendEmail({
+                    to: args.to,
+                    cc: args.cc,
+                    bcc: args.bcc,
+                    subject: args.subject,
+                    text: args.text,
+                    html: args.html,
+                    attachments: args.attachments,
+                });
+                return ok(JSON.stringify({ status: "sent", ...result }));
+            }
+            case "move_email": {
+                const uids = args.uids;
+                const destination = args.destination;
+                await imapService.moveEmails(folder, uids, destination);
+                return ok(JSON.stringify({ status: "moved", uids, destination }));
+            }
+            case "mark_email": {
+                const uids = args.uids;
+                const flags = args.flags;
+                const action = args.action || "add";
+                await imapService.markEmails(folder, uids, flags, action);
+                return ok(JSON.stringify({ status: "updated", uids, flags, action }));
+            }
+            case "delete_email": {
+                const uids = args.uids;
+                const permanent = args.permanent || false;
+                await imapService.deleteEmails(folder, uids, permanent);
+                return ok(JSON.stringify({
+                    status: permanent ? "permanently_deleted" : "moved_to_trash",
+                    uids,
+                }));
+            }
+            case "list_folders": {
+                const folders = await imapService.listFolders();
+                return ok(JSON.stringify(folders, null, 2));
+            }
+            case "create_folder": {
+                const path = args.path;
+                await imapService.createFolder(path);
+                return ok(JSON.stringify({ status: "created", path }));
+            }
+            case "download_attachment": {
+                const uid = args.uid;
+                const partId = args.partId;
+                const attachment = await imapService.downloadAttachment(folder, uid, partId);
+                return ok(JSON.stringify({
+                    filename: attachment.filename,
+                    contentType: attachment.contentType,
+                    size: attachment.size,
+                    content: attachment.content.toString("base64"),
+                }));
+            }
+            case "get_email_raw": {
+                const uid = args.uid;
+                const raw = await imapService.fetchRawEmail(folder, uid);
+                return ok(raw);
+            }
+            default:
+                return error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        const pimError = toPimError(err instanceof Error ? err : new Error(String(err)));
+        return error(`${pimError.message}${pimError.isRetryable ? " (retryable)" : ""}`);
+    }
+}
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+function error(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+//# sourceMappingURL=emailTools.js.map

package/dist/tools/emailTools.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@miguelarios/email-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for email via IMAP/SMTP — read, search, send, and manage emails",
+  "keywords": ["mcp", "email", "imap", "smtp", "mailbox"],
+  "license": "MIT",
+  "author": "Miguel Rios",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/miguelarios/pim-agents.git",
+    "directory": "packages/email-mcp"
+  },
+  "homepage": "https://github.com/miguelarios/pim-agents",
+  "bugs": "https://github.com/miguelarios/pim-agents/issues",
+  "type": "module",
+  "bin": {
+    "email-mcp": "dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "start": "node dist/bin/cli.js"
+  },
+  "dependencies": {
+    "@miguelarios/pim-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "imapflow": "^1.0.0",
+    "mailparser": "^3.7.0",
+    "nodemailer": "^6.9.0"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^6.4.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}