better-email-mcp 0.1.0

package/dist/smtp/client.js

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * Minimal SMTP client using Node's built-in net/tls modules.
+ * Supports EHLO, AUTH PLAIN, STARTTLS, and message submission.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmtpClient = exports.SmtpError = void 0;
+const net = __importStar(require("net"));
+const tls = __importStar(require("tls"));
+class SmtpError extends Error {
+    code;
+    constructor(code, message) {
+        super(`SMTP error [${code}]: ${message}`);
+        this.code = code;
+        this.name = "SmtpError";
+    }
+}
+exports.SmtpError = SmtpError;
+function validateAddress(address) {
+    if (/[\r\n\x00<>]/.test(address)) {
+        throw new SmtpError("invalid_address", "Email address contains illegal characters");
+    }
+}
+class SmtpClient {
+    socket = null;
+    host = "";
+    buffer = "";
+    capabilities = [];
+    responseResolve = null;
+    responseReject = null;
+    responseLines = [];
+    async connect(config) {
+        this.host = config.host;
+        return new Promise((resolve, reject) => {
+            this.responseResolve = (resp) => {
+                if (resp.code === 220) {
+                    resolve();
+                }
+                else {
+                    reject(new SmtpError("greeting", `Server rejected connection: ${resp.lines.join(" ")}`));
+                }
+            };
+            this.responseReject = reject;
+            const onError = (err) => {
+                this.responseResolve = null;
+                this.responseReject = null;
+                reject(new SmtpError("connect", err.message));
+            };
+            if (config.tls) {
+                this.socket = tls.connect({ host: config.host, port: config.port }, () => {
+                    // Connected, waiting for greeting
+                });
+            }
+            else {
+                this.socket = net.connect({ host: config.host, port: config.port }, () => {
+                    // Connected, waiting for greeting
+                });
+            }
+            this.socket.setEncoding("utf-8");
+            this.socket.on("data", (data) => this.onData(data));
+            this.socket.on("error", onError);
+            this.socket.on("close", () => {
+                if (this.responseReject) {
+                    this.responseReject(new SmtpError("closed", "Connection closed unexpectedly"));
+                    this.responseResolve = null;
+                    this.responseReject = null;
+                }
+                this.socket = null;
+            });
+        });
+    }
+    async ehlo(hostname) {
+        const resp = await this.sendCommand(`EHLO ${hostname}`, [250]);
+        this.capabilities = resp;
+        return resp;
+    }
+    async startTls() {
+        if (!this.socket) {
+            throw new SmtpError("disconnected", "Not connected");
+        }
+        const hasStartTls = this.capabilities.some((c) => c.toUpperCase() === "STARTTLS");
+        if (!hasStartTls) {
+            throw new SmtpError("starttls", "Server does not advertise STARTTLS");
+        }
+        await this.sendCommand("STARTTLS", [220]);
+        // Upgrade the socket to TLS
+        const rawSocket = this.socket;
+        rawSocket.removeAllListeners("data");
+        const tlsSocket = tls.connect({ socket: rawSocket, servername: this.host });
+        await new Promise((resolve, reject) => {
+            tlsSocket.once("secureConnect", resolve);
+            tlsSocket.once("error", reject);
+        });
+        this.socket = tlsSocket;
+        this.buffer = "";
+        this.socket.setEncoding("utf-8");
+        this.socket.on("data", (data) => this.onData(data));
+    }
+    async authPlain(user, password) {
+        const credentials = Buffer.from(`\0${user}\0${password}`).toString("base64");
+        await this.sendCommand(`AUTH PLAIN ${credentials}`, [235]);
+    }
+    async mailFrom(address) {
+        validateAddress(address);
+        await this.sendCommand(`MAIL FROM:<${address}>`, [250]);
+    }
+    async rcptTo(address) {
+        validateAddress(address);
+        await this.sendCommand(`RCPT TO:<${address}>`, [250]);
+    }
+    async data(content) {
+        await this.sendCommand("DATA", [354]);
+        // Normalize line endings to CRLF
+        let body = content.replace(/\r\n/g, "\n").replace(/\n/g, "\r\n");
+        // Dot-stuffing: any line starting with "." gets an extra "." prepended (RFC 5321 §4.5.2)
+        body = body.replace(/\r\n\./g, "\r\n..");
+        // Also handle if the body itself starts with a dot
+        if (body.startsWith(".")) {
+            body = "." + body;
+        }
+        // Send body followed by terminating sequence
+        this.writeRaw(body + "\r\n.\r\n");
+        await this.readResponse([250]);
+    }
+    async quit() {
+        try {
+            await this.sendCommand("QUIT", [221]);
+        }
+        catch {
+            // Ignore errors during quit
+        }
+        this.destroySocket();
+    }
+    disconnect() {
+        this.destroySocket();
+    }
+    // --- Private ---
+    async sendCommand(cmd, expectedCodes) {
+        if (!this.socket) {
+            throw new SmtpError("disconnected", "Not connected");
+        }
+        this.writeRaw(cmd + "\r\n");
+        return this.readResponse(expectedCodes);
+    }
+    readResponse(expectedCodes) {
+        return new Promise((resolve, reject) => {
+            this.responseLines = [];
+            this.responseResolve = (resp) => {
+                if (expectedCodes.includes(resp.code)) {
+                    resolve(resp.lines);
+                }
+                else {
+                    reject(new SmtpError(String(resp.code), resp.lines.join(" ") || `Unexpected response code ${resp.code}`));
+                }
+            };
+            this.responseReject = reject;
+            // Process any data already in the buffer
+            this.processBuffer();
+        });
+    }
+    writeRaw(data) {
+        if (!this.socket) {
+            throw new SmtpError("disconnected", "Not connected");
+        }
+        this.socket.write(data);
+    }
+    onData(data) {
+        this.buffer += data;
+        this.processBuffer();
+    }
+    processBuffer() {
+        while (this.buffer.length > 0) {
+            const crlfIdx = this.buffer.indexOf("\r\n");
+            if (crlfIdx === -1)
+                return;
+            const line = this.buffer.substring(0, crlfIdx);
+            this.buffer = this.buffer.substring(crlfIdx + 2);
+            this.handleLine(line);
+        }
+    }
+    handleLine(line) {
+        // SMTP responses: "NNN-text" (continuation) or "NNN text" (final)
+        const match = line.match(/^(\d{3})([ -])(.*)/);
+        if (!match)
+            return;
+        const code = parseInt(match[1], 10);
+        const isContinuation = match[2] === "-";
+        const text = match[3];
+        this.responseLines.push(text);
+        if (!isContinuation && this.responseResolve) {
+            const resolve = this.responseResolve;
+            this.responseResolve = null;
+            this.responseReject = null;
+            resolve({ code, lines: this.responseLines });
+            this.responseLines = [];
+        }
+    }
+    destroySocket() {
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+        this.responseResolve = null;
+        this.responseReject = null;
+    }
+}
+exports.SmtpClient = SmtpClient;
+//# sourceMappingURL=client.js.map

package/dist/smtp/client.js.map

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

package/dist/tools/register.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EmailBackend } from "../types.js";
+export declare function registerEmailTools(server: McpServer, backend: EmailBackend): void;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkC3C,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,GACpB,IAAI,CAmJN"}

package/dist/tools/register.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEmailTools = registerEmailTools;
+const zod_1 = require("zod");
+function errorResult(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+function jsonResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function parseDisabledTools() {
+    const raw = process.env.DISABLED_TOOLS ?? "";
+    if (!raw.trim())
+        return new Set();
+    return new Set(raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean));
+}
+function toolEnabled(name, disabled) {
+    return !disabled.has(name.toLowerCase());
+}
+function parseEmailFormat() {
+    const raw = (process.env.EMAIL_FORMAT ?? "plain").trim().toLowerCase();
+    if (raw === "html")
+        return "html";
+    return "plain";
+}
+function registerEmailTools(server, backend) {
+    const disabled = parseDisabledTools();
+    if (toolEnabled("list_folders", disabled)) {
+        server.tool("list_folders", "List all email folders/mailboxes", {}, async () => {
+            try {
+                const folders = await backend.listFolders();
+                return jsonResult(folders);
+            }
+            catch (err) {
+                return errorResult(err);
+            }
+        });
+    }
+    if (toolEnabled("list_messages", disabled)) {
+        server.tool("list_messages", "List recent email messages, optionally filtered by folder", {
+            folder: zod_1.z
+                .string()
+                .optional()
+                .describe("Folder name to filter by (e.g. 'Inbox')"),
+            limit: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Max messages to return (default 25)"),
+            offset: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Number of messages to skip for pagination"),
+        }, async ({ folder, limit, offset }) => {
+            try {
+                const messages = await backend.listMessages({ folder, limit, offset });
+                return jsonResult(messages);
+            }
+            catch (err) {
+                return errorResult(err);
+            }
+        });
+    }
+    if (toolEnabled("get_message", disabled)) {
+        server.tool("get_message", "Get a single email message by ID, including its full body text", {
+            id: zod_1.z.string().describe("The message ID"),
+        }, async ({ id }) => {
+            try {
+                const msg = await backend.getMessage(id);
+                if (!msg) {
+                    return {
+                        content: [{ type: "text", text: "Message not found" }],
+                        isError: true,
+                    };
+                }
+                return jsonResult(msg);
+            }
+            catch (err) {
+                return errorResult(err);
+            }
+        });
+    }
+    if (toolEnabled("search_messages", disabled)) {
+        server.tool("search_messages", "Search email messages by text query", {
+            query: zod_1.z.string().describe("Search query text"),
+            folder: zod_1.z.string().optional().describe("Folder to search within"),
+            limit: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Max results (default 25)"),
+        }, async ({ query, folder, limit }) => {
+            try {
+                const messages = await backend.searchMessages({ query, folder, limit });
+                return jsonResult(messages);
+            }
+            catch (err) {
+                return errorResult(err);
+            }
+        });
+    }
+    if (backend.sendMessage && toolEnabled("send_message", disabled)) {
+        const sendFn = backend.sendMessage.bind(backend);
+        const emailFormat = parseEmailFormat();
+        const sendParams = {
+            to: zod_1.z.array(zod_1.z.string()).describe("Recipient email addresses"),
+            cc: zod_1.z.array(zod_1.z.string()).optional().describe("CC recipient email addresses"),
+            bcc: zod_1.z.array(zod_1.z.string()).optional().describe("BCC recipient email addresses"),
+            subject: zod_1.z.string().describe("Email subject"),
+            textBody: zod_1.z.string().describe("Plain text body of the email"),
+            inReplyTo: zod_1.z
+                .string()
+                .optional()
+                .describe("Message ID to reply to, for threading"),
+        };
+        if (emailFormat === "html") {
+            sendParams.htmlBody = zod_1.z
+                .string()
+                .describe("HTML body of the email. The message is sent as multipart with both plain text and HTML.");
+        }
+        server.tool("send_message", "Send an email message", sendParams, async (args) => {
+            try {
+                const result = await sendFn({
+                    to: args.to,
+                    cc: args.cc,
+                    bcc: args.bcc,
+                    subject: args.subject,
+                    textBody: args.textBody,
+                    htmlBody: args.htmlBody,
+                    inReplyTo: args.inReplyTo,
+                });
+                return jsonResult({ sent: true, id: result.id });
+            }
+            catch (err) {
+                return errorResult(err);
+            }
+        });
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/tools/register.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shared interface that both IMAP and JMAP backends implement.
+ * The MCP tool layer depends only on this interface, never on a specific backend.
+ */
+export interface EmailMessage {
+    id: string;
+    subject: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    date: string;
+    snippet: string;
+    body?: string;
+    isRead: boolean;
+    folder: string;
+}
+export interface ListMessagesOptions {
+    folder?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchOptions {
+    query: string;
+    folder?: string;
+    limit?: number;
+}
+export interface SendMessageOptions {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    textBody: string;
+    htmlBody?: string;
+    inReplyTo?: string;
+}
+export interface EmailBackend {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    listFolders(): Promise<string[]>;
+    listMessages(options?: ListMessagesOptions): Promise<EmailMessage[]>;
+    getMessage(id: string): Promise<EmailMessage | null>;
+    searchMessages(options: SearchOptions): Promise<EmailMessage[]>;
+    sendMessage?(options: SendMessageOptions): Promise<{
+        id: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,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,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrD,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChE,WAAW,CAAC,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE"}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Shared interface that both IMAP and JMAP backends implement.
+ * The MCP tool layer depends only on this interface, never on a specific backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "better-email-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for email access via IMAP and Fastmail JMAP",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "better-email-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samteezy/better-email-mcp"
+  },
+  "keywords": [
+    "mcp",
+    "email",
+    "imap",
+    "jmap",
+    "fastmail"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "eslint": "^10.1.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.2"
+  }
+}