@kononenko-e/email-mcp 0.2.3

package/dist/tools/analytics.tool.js

@@ -0,0 +1,27 @@
+/**
+ * MCP Tool: get_email_stats
+ *
+ * Provides email analytics and statistics for a mailbox.
+ */
+import { z } from 'zod';
+export default function registerAnalyticsTools(server, imapService) {
+    server.tool('get_email_stats', 'Get email statistics and analytics for a mailbox. Shows volume, top senders, daily trends, and read/flagged counts.', {
+        account: z.string().describe('Account name'),
+        period: z
+            .enum(['day', 'week', 'month'])
+            .default('week')
+            .describe('Time period: day, week, or month'),
+        mailbox: z.string().default('INBOX').describe('Mailbox path (default: INBOX)'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account, period, mailbox }) => {
+        const stats = await imapService.getEmailStats(account, mailbox, period);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(stats, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=analytics.tool.js.map

package/dist/tools/analytics.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.tool.js","sourceRoot":"","sources":["../../src/tools/analytics.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,MAAiB,EAAE,WAAwB;IACxF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,qHAAqH,EACrH;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC5C,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;aAC9B,OAAO,CAAC,MAAM,CAAC;aACf,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KAC/E,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAExE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/attachments.tool.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool: download_attachment
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerAttachmentTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=attachments.tool.d.ts.map

package/dist/tools/attachments.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.tool.d.ts","sourceRoot":"","sources":["../../src/tools/attachments.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAE3D,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAiDjG"}

package/dist/tools/attachments.tool.js

@@ -0,0 +1,45 @@
+/**
+ * MCP tool: download_attachment
+ */
+import { z } from 'zod';
+export default function registerAttachmentTools(server, imapService) {
+    server.tool('download_attachment', 'Download an email attachment by filename. First use get_email to see available attachments and their filenames. Returns base64-encoded content for files ≤5MB.', {
+        account: z.string().describe('Account name from list_accounts'),
+        id: z.string().describe('Email ID (UID) from list_emails or get_email'),
+        mailbox: z.string().default('INBOX').describe('Mailbox containing the email'),
+        filename: z.string().describe('Exact attachment filename (from get_email metadata)'),
+    }, { readOnlyHint: true, destructiveHint: false }, async ({ account, id, mailbox, filename }) => {
+        try {
+            const result = await imapService.downloadAttachment(account, id, mailbox, filename);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            filename: result.filename,
+                            mimeType: result.mimeType,
+                            size: result.size,
+                            sizeHuman: `${Math.round(result.size / 1024)}KB`,
+                        }, null, 2),
+                    },
+                    {
+                        type: 'text',
+                        text: `\n--- Base64 Content ---\n${result.contentBase64}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to download attachment: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=attachments.tool.js.map

package/dist/tools/attachments.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.tool.js","sourceRoot":"","sources":["../../src/tools/attachments.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,MAAiB,EAAE,WAAwB;IACzF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,gKAAgK,EAChK;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KACrF,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEpF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI;yBACjD,EACD,IAAI,EACJ,CAAC,CACF;qBACF;oBACD;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,MAAM,CAAC,aAAa,EAAE;qBAC1D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAC3F;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/bulk.tool.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool: bulk_action — batch operations on multiple emails.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type ImapService from '../services/imap.service.js';
+export default function registerBulkTools(server: McpServer, imapService: ImapService): void;
+//# sourceMappingURL=bulk.tool.d.ts.map

package/dist/tools/bulk.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.tool.d.ts","sourceRoot":"","sources":["../../src/tools/bulk.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAG3D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAqF3F"}

package/dist/tools/bulk.tool.js

@@ -0,0 +1,75 @@
+/**
+ * MCP tool: bulk_action — batch operations on multiple emails.
+ */
+import { z } from 'zod';
+import audit from '../safety/audit.js';
+export default function registerBulkTools(server, imapService) {
+    server.tool('bulk_action', 'Batch operation on multiple emails by UID list. Supports mark_read, mark_unread, flag, unflag, move, and delete. Max 100 IDs per call. Returns success/failure counts.', {
+        account: z.string().describe('Account name from list_accounts'),
+        mailbox: z.string().default('INBOX').describe('Source mailbox containing the emails'),
+        action: z
+            .enum(['mark_read', 'mark_unread', 'flag', 'unflag', 'move', 'delete'])
+            .describe('Bulk action to perform'),
+        ids: z
+            .array(z.number().int())
+            .min(1)
+            .max(100)
+            .describe('Array of email UIDs (max 100). Get UIDs from list_emails or search_emails.'),
+        destination: z
+            .string()
+            .optional()
+            .describe("Destination mailbox — required when action is 'move'"),
+    }, { readOnlyHint: false, destructiveHint: true }, async ({ account, mailbox, action, ids, destination }) => {
+        try {
+            if (action === 'move' && !destination) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Destination mailbox is required for "move" action.`,
+                        },
+                    ],
+                };
+            }
+            let result;
+            if (action === 'move') {
+                result = await imapService.bulkMove(account, ids, mailbox, destination);
+            }
+            else if (action === 'delete') {
+                result = await imapService.bulkDelete(account, ids, mailbox);
+            }
+            else {
+                result = await imapService.bulkSetFlags(account, ids, mailbox, action);
+            }
+            await audit.log('bulk_action', account, {
+                mailbox,
+                action,
+                ids: ids.length,
+                destination,
+            }, 'ok');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await audit.log('bulk_action', account, { mailbox, action, ids: ids.length }, 'error', errMsg);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Bulk action failed: ${errMsg}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=bulk.tool.js.map

package/dist/tools/bulk.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.tool.js","sourceRoot":"","sources":["../../src/tools/bulk.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,oBAAoB,CAAC;AAKvC,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAiB,EAAE,WAAwB;IACnF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,wKAAwK,EACxK;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACrF,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;aACtE,QAAQ,CAAC,wBAAwB,CAAC;QACrC,GAAG,EAAE,CAAC;aACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,4EAA4E,CAAC;QACzF,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sDAAsD,CAAC;KACpE,EACD,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAC9C,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,oDAAoD;yBAC3D;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,MAAkB,CAAC;YACvB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAqB,CAAC,CAAC;YACpF,CAAC;iBAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,KAAK,CAAC,GAAG,CACb,aAAa,EACb,OAAO,EACP;gBACE,OAAO;gBACP,MAAM;gBACN,GAAG,EAAE,GAAG,CAAC,MAAM;gBACf,WAAW;aACZ,EACD,IAAI,CACL,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,GAAG,CACb,aAAa,EACb,OAAO,EACP,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,EACpC,OAAO,EACP,MAAM,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,MAAM,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/calendar.tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP Tools: calendar operations
+ *
+ * - extract_calendar            — parse ICS/iCalendar from email
+ * - add_to_calendar             — add email event to local calendar (with confirmation dialog + dedup)
+ * - check_calendar_permissions  — check OS calendar/reminders access
+ * - list_calendars              — list available local calendars
+ * - list_events                 — search/list local calendar events
+ * - list_reminders              — search/list reminders from Reminders.app
+ * - create_reminder             — create a reminder in macOS Reminders.app from email
+ * - analyze_email_for_scheduling — detect events + reminders in email; AI decides what to create
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type CalendarService from '../services/calendar.service.js';
+import type ImapService from '../services/imap.service.js';
+import type LocalCalendarService from '../services/local-calendar.service.js';
+import type RemindersService from '../services/reminders.service.js';
+export default function registerCalendarTools(server: McpServer, imapService: ImapService, calendarService: CalendarService, localCalendarService: LocalCalendarService, remindersService: RemindersService): void;
+//# sourceMappingURL=calendar.tool.d.ts.map

package/dist/tools/calendar.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.tool.d.ts","sourceRoot":"","sources":["../../src/tools/calendar.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,eAAe,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,WAAW,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AASrE,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,oBAAoB,EAAE,oBAAoB,EAC1C,gBAAgB,EAAE,gBAAgB,GACjC,IAAI,CA6pBN"}