@mcp-z/mcp-outlook 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kevin Malakoff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,165 @@
+# @mcp-z/mcp-outlook
+
+Docs: https://mcp-z.github.io/mcp-outlook
+Outlook MCP server for searching, reading, and sending Microsoft 365 mail.
+
+## Common uses
+
+- Search and read messages
+- Send and reply to emails
+- Manage categories and export messages to CSV
+
+## Transports
+
+MCP supports stdio and HTTP.
+
+**Stdio**
+```json
+{
+  "mcpServers": {
+    "outlook": {
+      "command": "npx",
+      "args": ["-y", "@mcp-z/mcp-outlook"]
+    }
+  }
+}
+```
+
+**HTTP**
+```json
+{
+  "mcpServers": {
+    "outlook": {
+      "type": "http",
+      "url": "http://localhost:9003/mcp",
+      "start": {
+        "command": "npx",
+        "args": ["-y", "@mcp-z/mcp-outlook", "--port=9003"]
+      }
+    }
+  }
+}
+```
+
+`start` is an extension used by `npx @mcp-z/cli up` to launch HTTP servers for you.
+
+## Create a Microsoft app
+
+1. Go to [Azure Portal](https://portal.azure.com/).
+2. Navigate to Azure Active Directory > App registrations.
+3. Click New registration.
+4. Choose a name and select a supported account type.
+5. Copy the Application (client) ID and Directory (tenant) ID.
+
+## OAuth configuration
+
+Configure via environment variables or the `env` block in `.mcp.json`. Use `server.json` for the full list of options.
+
+### Loopback OAuth (default)
+
+Environment variables:
+
+```bash
+MS_CLIENT_ID=your-client-id
+MS_TENANT_ID=common
+MS_CLIENT_SECRET=your-client-secret
+```
+
+Example:
+```json
+{
+  "mcpServers": {
+    "outlook": {
+      "command": "npx",
+      "args": ["-y", "@mcp-z/mcp-outlook"],
+      "env": {
+        "MS_CLIENT_ID": "your-client-id",
+        "MS_TENANT_ID": "common",
+        "MS_CLIENT_SECRET": "your-client-secret"
+      }
+    }
+  }
+}
+```
+
+### Device code
+
+Useful for headless or remote environments.
+
+```json
+{
+  "mcpServers": {
+    "outlook": {
+      "command": "npx",
+      "args": ["-y", "@mcp-z/mcp-outlook", "--auth=device-code"],
+      "env": {
+        "MS_CLIENT_ID": "your-client-id",
+        "MS_TENANT_ID": "common"
+      }
+    }
+  }
+}
+```
+
+### DCR (Dynamic Client Registration)
+
+HTTP only. Requires a public base URL.
+
+```json
+{
+  "mcpServers": {
+    "outlook-dcr": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mcp-z/mcp-outlook",
+        "--auth=dcr",
+        "--port=3456",
+        "--base-url=https://oauth.example.com"
+      ],
+      "env": {
+        "MS_CLIENT_ID": "your-client-id",
+        "MS_TENANT_ID": "common",
+        "MS_CLIENT_SECRET": "your-client-secret"
+      }
+    }
+  }
+}
+```
+
+## How to use
+
+```bash
+# List tools
+mcp-z inspect --servers outlook --tools
+
+# Call a tool
+mcp-z call outlook message-search '{"query":"from:alice@example.com"}'
+```
+
+## Tools
+
+1. categories-list
+2. label-add
+3. label-delete
+4. labels-list
+5. message-get
+6. message-mark-read
+7. message-move-to-trash
+8. message-respond
+9. message-search
+10. message-send
+11. messages-export-csv
+
+## Resources
+
+1. email
+
+## Prompts
+
+1. draft-email
+2. query-syntax
+
+## Configuration reference
+
+See `server.json` for all supported environment variables, CLI arguments, and defaults.

package/bin/server.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+// biome-ignore lint/security/noGlobalEval: dual esm and cjs
+if (typeof require === 'undefined') eval("import('../dist/esm/index.js').then((cli) => cli.default(process.argv.slice(2), 'mcp-outlook')).catch((err) => { console.log(err); process.exit(-1); });");
+else require('../dist/cjs/index.js')(process.argv.slice(2), 'mcp-outlook');

package/dist/cjs/constants.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Outlook MCP Server Constants
+ *
+ * These scopes are required for Microsoft Outlook functionality and are hardcoded
+ * rather than externally configured since this server knows its own requirements.
+ */
+export declare const MS_SCOPE = "openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite";
+export declare const CHUNK_SIZE = 10;
+export declare const MAX_BATCH_SIZE = 500;
+export declare const MAX_PAGE_SIZE = 1000;

package/dist/cjs/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Outlook MCP Server Constants
+ *
+ * These scopes are required for Microsoft Outlook functionality and are hardcoded
+ * rather than externally configured since this server knows its own requirements.
+ */
+export declare const MS_SCOPE = "openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite";
+export declare const CHUNK_SIZE = 10;
+export declare const MAX_BATCH_SIZE = 500;
+export declare const MAX_PAGE_SIZE = 1000;

package/dist/cjs/constants.js

@@ -0,0 +1,35 @@
+/**
+ * Outlook MCP Server Constants
+ *
+ * These scopes are required for Microsoft Outlook functionality and are hardcoded
+ * rather than externally configured since this server knows its own requirements.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get CHUNK_SIZE () {
+        return CHUNK_SIZE;
+    },
+    get MAX_BATCH_SIZE () {
+        return MAX_BATCH_SIZE;
+    },
+    get MAX_PAGE_SIZE () {
+        return MAX_PAGE_SIZE;
+    },
+    get MS_SCOPE () {
+        return MS_SCOPE;
+    }
+});
+var _email = require("@mcp-z/email");
+var MS_SCOPE = 'openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite';
+var CHUNK_SIZE = _email.EMAIL_CHUNK_SIZE;
+var MAX_BATCH_SIZE = _email.EMAIL_MAX_BATCH_SIZE;
+var MAX_PAGE_SIZE = 1000; // Maximum number of items per page
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/constants.ts"],"sourcesContent":["/**\n * Outlook MCP Server Constants\n *\n * These scopes are required for Microsoft Outlook functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\nimport { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';\n\n// Microsoft OAuth scopes required for Outlook operations\nexport const MS_SCOPE = 'openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite';\n\n// Batch processing configuration (from shared email constants)\nexport const CHUNK_SIZE = EMAIL_CHUNK_SIZE;\nexport const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;\n\n// Pagination configuration\nexport const MAX_PAGE_SIZE = 1000; // Maximum number of items per page\n"],"names":["CHUNK_SIZE","MAX_BATCH_SIZE","MAX_PAGE_SIZE","MS_SCOPE","EMAIL_CHUNK_SIZE","EMAIL_MAX_BATCH_SIZE"],"mappings":"AAAA;;;;;CAKC;;;;;;;;;;;QAQYA;eAAAA;;QACAC;eAAAA;;QAGAC;eAAAA;;QAPAC;eAAAA;;;qBAH0C;AAGhD,IAAMA,WAAW;AAGjB,IAAMH,aAAaI,uBAAgB;AACnC,IAAMH,iBAAiBI,2BAAoB;AAG3C,IAAMH,gBAAgB,MAAM,mCAAmC"}

package/dist/cjs/email/composition/outlook-message-builder.d.cts

@@ -0,0 +1,36 @@
+/**
+ * Outlook-specific message builder for composing emails using Microsoft Graph API format
+ * This is the Outlook equivalent of Gmail's RFC822 builder
+ */
+export interface OutlookRecipient {
+    emailAddress: {
+        address: string;
+        name?: string;
+    };
+}
+export interface OutlookMessageArgs {
+    to?: string | string[] | undefined;
+    cc?: string | string[] | undefined;
+    bcc?: string | string[] | undefined;
+    subject?: string;
+    body?: string;
+    from?: string;
+    importance?: 'Low' | 'Normal' | 'High';
+    contentType?: 'Text' | 'HTML';
+}
+export interface OutlookMessage {
+    subject?: string;
+    body?: {
+        contentType: string;
+        content: string;
+    };
+    toRecipients?: OutlookRecipient[];
+    ccRecipients?: OutlookRecipient[];
+    bccRecipients?: OutlookRecipient[];
+    importance?: string;
+}
+/**
+ * Build an Outlook message object from email arguments for Microsoft Graph API
+ * This is the Outlook equivalent of buildRfc822FromArgs for Gmail
+ */
+export declare function buildOutlookMessage(args: OutlookMessageArgs): OutlookMessage;

package/dist/cjs/email/composition/outlook-message-builder.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Outlook-specific message builder for composing emails using Microsoft Graph API format
+ * This is the Outlook equivalent of Gmail's RFC822 builder
+ */
+export interface OutlookRecipient {
+    emailAddress: {
+        address: string;
+        name?: string;
+    };
+}
+export interface OutlookMessageArgs {
+    to?: string | string[] | undefined;
+    cc?: string | string[] | undefined;
+    bcc?: string | string[] | undefined;
+    subject?: string;
+    body?: string;
+    from?: string;
+    importance?: 'Low' | 'Normal' | 'High';
+    contentType?: 'Text' | 'HTML';
+}
+export interface OutlookMessage {
+    subject?: string;
+    body?: {
+        contentType: string;
+        content: string;
+    };
+    toRecipients?: OutlookRecipient[];
+    ccRecipients?: OutlookRecipient[];
+    bccRecipients?: OutlookRecipient[];
+    importance?: string;
+}
+/**
+ * Build an Outlook message object from email arguments for Microsoft Graph API
+ * This is the Outlook equivalent of buildRfc822FromArgs for Gmail
+ */
+export declare function buildOutlookMessage(args: OutlookMessageArgs): OutlookMessage;

package/dist/cjs/email/composition/outlook-message-builder.js

@@ -0,0 +1,56 @@
+/**
+ * Outlook-specific message builder for composing emails using Microsoft Graph API format
+ * This is the Outlook equivalent of Gmail's RFC822 builder
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "buildOutlookMessage", {
+    enumerable: true,
+    get: function() {
+        return buildOutlookMessage;
+    }
+});
+function buildOutlookMessage(args) {
+    var _args_to = args.to, to = _args_to === void 0 ? [] : _args_to, _args_cc = args.cc, cc = _args_cc === void 0 ? [] : _args_cc, _args_bcc = args.bcc, bcc = _args_bcc === void 0 ? [] : _args_bcc, _args_subject = args.subject, subject = _args_subject === void 0 ? '' : _args_subject, _args_body = args.body, body = _args_body === void 0 ? '' : _args_body, _args_importance = args.importance, importance = _args_importance === void 0 ? 'Normal' : _args_importance, _args_contentType = args.contentType, contentType = _args_contentType === void 0 ? 'Text' : _args_contentType;
+    var message = {};
+    if (subject) {
+        message.subject = subject;
+    }
+    if (body) {
+        message.body = {
+            contentType: contentType,
+            content: body
+        };
+    }
+    function parseEmailAddresses(emails) {
+        var emailArray = Array.isArray(emails) ? emails : [
+            emails
+        ];
+        return emailArray.filter(function(email) {
+            return email && email.trim();
+        }).map(function(email) {
+            var trimmed = email.trim();
+            // Simple email parsing - could be enhanced for name parsing
+            return {
+                emailAddress: {
+                    address: trimmed
+                }
+            };
+        });
+    }
+    if (to && (Array.isArray(to) ? to.length > 0 : to.trim())) {
+        message.toRecipients = parseEmailAddresses(to);
+    }
+    if (cc && (Array.isArray(cc) ? cc.length > 0 : cc.trim())) {
+        message.ccRecipients = parseEmailAddresses(cc);
+    }
+    if (bcc && (Array.isArray(bcc) ? bcc.length > 0 : bcc.trim())) {
+        message.bccRecipients = parseEmailAddresses(bcc);
+    }
+    if (importance && importance !== 'Normal') {
+        message.importance = importance;
+    }
+    return message;
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/email/composition/outlook-message-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/composition/outlook-message-builder.ts"],"sourcesContent":["/**\n * Outlook-specific message builder for composing emails using Microsoft Graph API format\n * This is the Outlook equivalent of Gmail's RFC822 builder\n */\n\nexport interface OutlookRecipient {\n  emailAddress: {\n    address: string;\n    name?: string;\n  };\n}\n\nexport interface OutlookMessageArgs {\n  to?: string | string[] | undefined;\n  cc?: string | string[] | undefined;\n  bcc?: string | string[] | undefined;\n  subject?: string;\n  body?: string;\n  from?: string;\n  importance?: 'Low' | 'Normal' | 'High';\n  contentType?: 'Text' | 'HTML';\n}\n\nexport interface OutlookMessage {\n  subject?: string;\n  body?: {\n    contentType: string;\n    content: string;\n  };\n  toRecipients?: OutlookRecipient[];\n  ccRecipients?: OutlookRecipient[];\n  bccRecipients?: OutlookRecipient[];\n  importance?: string;\n}\n\n/**\n * Build an Outlook message object from email arguments for Microsoft Graph API\n * This is the Outlook equivalent of buildRfc822FromArgs for Gmail\n */\nexport function buildOutlookMessage(args: OutlookMessageArgs): OutlookMessage {\n  const { to = [], cc = [], bcc = [], subject = '', body = '', importance = 'Normal', contentType = 'Text' } = args;\n\n  const message: OutlookMessage = {};\n\n  if (subject) {\n    message.subject = subject;\n  }\n\n  if (body) {\n    message.body = {\n      contentType: contentType,\n      content: body,\n    };\n  }\n\n  function parseEmailAddresses(emails: string | string[]): OutlookRecipient[] {\n    const emailArray = Array.isArray(emails) ? emails : [emails];\n    return emailArray\n      .filter((email) => email && email.trim())\n      .map((email) => {\n        const trimmed = email.trim();\n        // Simple email parsing - could be enhanced for name parsing\n        return {\n          emailAddress: {\n            address: trimmed,\n          },\n        };\n      });\n  }\n\n  if (to && (Array.isArray(to) ? to.length > 0 : to.trim())) {\n    message.toRecipients = parseEmailAddresses(to);\n  }\n\n  if (cc && (Array.isArray(cc) ? cc.length > 0 : cc.trim())) {\n    message.ccRecipients = parseEmailAddresses(cc);\n  }\n\n  if (bcc && (Array.isArray(bcc) ? bcc.length > 0 : bcc.trim())) {\n    message.bccRecipients = parseEmailAddresses(bcc);\n  }\n\n  if (importance && importance !== 'Normal') {\n    message.importance = importance;\n  }\n\n  return message;\n}\n"],"names":["buildOutlookMessage","args","to","cc","bcc","subject","body","importance","contentType","message","content","parseEmailAddresses","emails","emailArray","Array","isArray","filter","email","trim","map","trimmed","emailAddress","address","length","toRecipients","ccRecipients","bccRecipients"],"mappings":"AAAA;;;CAGC;;;;+BAoCeA;;;eAAAA;;;AAAT,SAASA,oBAAoBC,IAAwB;IAC1D,eAA6GA,KAArGC,IAAAA,2BAAK,EAAE,wBAA8FD,KAA5FE,IAAAA,2BAAK,EAAE,yBAAqFF,KAAnFG,KAAAA,6BAAM,EAAE,8BAA2EH,KAAzEI,SAAAA,qCAAU,iCAA+DJ,KAA3DK,MAAAA,+BAAO,oCAAoDL,KAAhDM,YAAAA,2CAAa,iDAAmCN,KAAzBO,aAAAA,6CAAc;IAElG,IAAMC,UAA0B,CAAC;IAEjC,IAAIJ,SAAS;QACXI,QAAQJ,OAAO,GAAGA;IACpB;IAEA,IAAIC,MAAM;QACRG,QAAQH,IAAI,GAAG;YACbE,aAAaA;YACbE,SAASJ;QACX;IACF;IAEA,SAASK,oBAAoBC,MAAyB;QACpD,IAAMC,aAAaC,MAAMC,OAAO,CAACH,UAAUA,SAAS;YAACA;SAAO;QAC5D,OAAOC,WACJG,MAAM,CAAC,SAACC;mBAAUA,SAASA,MAAMC,IAAI;WACrCC,GAAG,CAAC,SAACF;YACJ,IAAMG,UAAUH,MAAMC,IAAI;YAC1B,4DAA4D;YAC5D,OAAO;gBACLG,cAAc;oBACZC,SAASF;gBACX;YACF;QACF;IACJ;IAEA,IAAIlB,MAAOY,CAAAA,MAAMC,OAAO,CAACb,MAAMA,GAAGqB,MAAM,GAAG,IAAIrB,GAAGgB,IAAI,EAAC,GAAI;QACzDT,QAAQe,YAAY,GAAGb,oBAAoBT;IAC7C;IAEA,IAAIC,MAAOW,CAAAA,MAAMC,OAAO,CAACZ,MAAMA,GAAGoB,MAAM,GAAG,IAAIpB,GAAGe,IAAI,EAAC,GAAI;QACzDT,QAAQgB,YAAY,GAAGd,oBAAoBR;IAC7C;IAEA,IAAIC,OAAQU,CAAAA,MAAMC,OAAO,CAACX,OAAOA,IAAImB,MAAM,GAAG,IAAInB,IAAIc,IAAI,EAAC,GAAI;QAC7DT,QAAQiB,aAAa,GAAGf,oBAAoBP;IAC9C;IAEA,IAAIG,cAAcA,eAAe,UAAU;QACzCE,QAAQF,UAAU,GAAGA;IACvB;IAEA,OAAOE;AACT"}

package/dist/cjs/email/messages/messages.d.cts

@@ -0,0 +1,7 @@
+import { buildContentForItems } from '@mcp-z/email';
+import type { OutlookMessage } from '../../lib/outlook/types.js';
+export { buildContentForItems };
+export declare function toRowFromOutlook(msg: OutlookMessage, opts?: {
+    body?: boolean;
+    addressFormat?: 'email' | 'name' | 'raw';
+}): string[];

package/dist/cjs/email/messages/messages.d.ts

@@ -0,0 +1,7 @@
+import { buildContentForItems } from '@mcp-z/email';
+import type { OutlookMessage } from '../../lib/outlook/types.js';
+export { buildContentForItems };
+export declare function toRowFromOutlook(msg: OutlookMessage, opts?: {
+    body?: boolean;
+    addressFormat?: 'email' | 'name' | 'raw';
+}): string[];

package/dist/cjs/email/messages/messages.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get buildContentForItems () {
+        return _email.buildContentForItems;
+    },
+    get toRowFromOutlook () {
+        return toRowFromOutlook;
+    }
+});
+var _email = require("@mcp-z/email");
+var _headerparsing = require("../parsing/header-parsing.js");
+function toRowFromOutlook(msg) {
+    var opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {
+        body: false,
+        addressFormat: 'email'
+    };
+    var _msg_id, _msg_conversationId, _extractFrom, _msg_subject, _msg_bodyPreview;
+    var id = (_msg_id = msg.id) !== null && _msg_id !== void 0 ? _msg_id : '';
+    var provider = 'outlook';
+    var threadId = (_msg_conversationId = msg.conversationId) !== null && _msg_conversationId !== void 0 ? _msg_conversationId : '';
+    var to = msg.toRecipients ? (0, _headerparsing.formatAddressList)(msg.toRecipients, opts.addressFormat) : '';
+    var from = msg.from ? (_extractFrom = (0, _headerparsing.extractFrom)(msg.from)) !== null && _extractFrom !== void 0 ? _extractFrom : '' : '';
+    var cc = msg.ccRecipients ? (0, _headerparsing.formatAddressList)(msg.ccRecipients, opts.addressFormat) : '';
+    var bcc = msg.bccRecipients ? (0, _headerparsing.formatAddressList)(msg.bccRecipients, opts.addressFormat) : '';
+    var date = msg.receivedDateTime ? (0, _email.normalizeDateToISO)(msg.receivedDateTime) || msg.receivedDateTime : '';
+    var subject = (_msg_subject = msg.subject) !== null && _msg_subject !== void 0 ? _msg_subject : '';
+    var labels = msg.categories ? msg.categories.join(';') : '';
+    var snippet = (_msg_bodyPreview = msg.bodyPreview) !== null && _msg_bodyPreview !== void 0 ? _msg_bodyPreview : '';
+    var bodyFull = '';
+    if (opts.body && msg.body) {
+        var _msg_body_content;
+        var raw = (_msg_body_content = msg.body.content) !== null && _msg_body_content !== void 0 ? _msg_body_content : '';
+        if (raw) {
+            bodyFull = msg.body.contentType && msg.body.contentType.toLowerCase() === 'html' ? (0, _email.stripHtml)(raw) : String(raw);
+        }
+    }
+    return [
+        id,
+        provider,
+        threadId,
+        to,
+        from,
+        cc,
+        bcc,
+        date,
+        subject,
+        labels,
+        snippet,
+        bodyFull
+    ];
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/email/messages/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/messages/messages.ts"],"sourcesContent":["import { buildContentForItems, stripHtml, normalizeDateToISO as toIsoUtc } from '@mcp-z/email';\nimport type { OutlookMessage } from '../../lib/outlook/types.js';\nimport { extractFrom, formatAddressList } from '../parsing/header-parsing.js';\n\nexport { buildContentForItems };\n\nexport function toRowFromOutlook(msg: OutlookMessage, opts: { body?: boolean; addressFormat?: 'email' | 'name' | 'raw' } = { body: false, addressFormat: 'email' }) {\n  const id = msg.id ?? '';\n  const provider = 'outlook';\n  const threadId = msg.conversationId ?? '';\n  const to = msg.toRecipients ? formatAddressList(msg.toRecipients, opts.addressFormat) : '';\n  const from = msg.from ? (extractFrom(msg.from) ?? '') : '';\n  const cc = msg.ccRecipients ? formatAddressList(msg.ccRecipients, opts.addressFormat) : '';\n  const bcc = msg.bccRecipients ? formatAddressList(msg.bccRecipients, opts.addressFormat) : '';\n  const date = msg.receivedDateTime ? toIsoUtc(msg.receivedDateTime) || msg.receivedDateTime : '';\n  const subject = msg.subject ?? '';\n  const labels = msg.categories ? msg.categories.join(';') : '';\n  const snippet = msg.bodyPreview ?? '';\n  let bodyFull = '';\n  if (opts.body && msg.body) {\n    const raw = msg.body.content ?? '';\n    if (raw) {\n      bodyFull = msg.body.contentType && msg.body.contentType.toLowerCase() === 'html' ? stripHtml(raw) : String(raw);\n    }\n  }\n  return [id, provider, threadId, to, from, cc, bcc, date, subject, labels, snippet, bodyFull];\n}\n"],"names":["buildContentForItems","toRowFromOutlook","msg","opts","body","addressFormat","extractFrom","id","provider","threadId","conversationId","to","toRecipients","formatAddressList","from","cc","ccRecipients","bcc","bccRecipients","date","receivedDateTime","toIsoUtc","subject","labels","categories","join","snippet","bodyPreview","bodyFull","raw","content","contentType","toLowerCase","stripHtml","String"],"mappings":";;;;;;;;;;;QAISA;eAAAA,2BAAoB;;QAEbC;eAAAA;;;qBANgE;6BAEjC;AAIxC,SAASA,iBAAiBC,GAAmB;QAAEC,OAAAA,iEAAqE;QAAEC,MAAM;QAAOC,eAAe;IAAQ;QACpJH,SAEMA,qBAEQI,cAITJ,cAEAA;IAVhB,IAAMK,MAAKL,UAAAA,IAAIK,EAAE,cAANL,qBAAAA,UAAU;IACrB,IAAMM,WAAW;IACjB,IAAMC,YAAWP,sBAAAA,IAAIQ,cAAc,cAAlBR,iCAAAA,sBAAsB;IACvC,IAAMS,KAAKT,IAAIU,YAAY,GAAGC,IAAAA,gCAAiB,EAACX,IAAIU,YAAY,EAAET,KAAKE,aAAa,IAAI;IACxF,IAAMS,OAAOZ,IAAIY,IAAI,IAAIR,eAAAA,IAAAA,0BAAW,EAACJ,IAAIY,IAAI,eAApBR,0BAAAA,eAAyB,KAAM;IACxD,IAAMS,KAAKb,IAAIc,YAAY,GAAGH,IAAAA,gCAAiB,EAACX,IAAIc,YAAY,EAAEb,KAAKE,aAAa,IAAI;IACxF,IAAMY,MAAMf,IAAIgB,aAAa,GAAGL,IAAAA,gCAAiB,EAACX,IAAIgB,aAAa,EAAEf,KAAKE,aAAa,IAAI;IAC3F,IAAMc,OAAOjB,IAAIkB,gBAAgB,GAAGC,IAAAA,yBAAQ,EAACnB,IAAIkB,gBAAgB,KAAKlB,IAAIkB,gBAAgB,GAAG;IAC7F,IAAME,WAAUpB,eAAAA,IAAIoB,OAAO,cAAXpB,0BAAAA,eAAe;IAC/B,IAAMqB,SAASrB,IAAIsB,UAAU,GAAGtB,IAAIsB,UAAU,CAACC,IAAI,CAAC,OAAO;IAC3D,IAAMC,WAAUxB,mBAAAA,IAAIyB,WAAW,cAAfzB,8BAAAA,mBAAmB;IACnC,IAAI0B,WAAW;IACf,IAAIzB,KAAKC,IAAI,IAAIF,IAAIE,IAAI,EAAE;YACbF;QAAZ,IAAM2B,OAAM3B,oBAAAA,IAAIE,IAAI,CAAC0B,OAAO,cAAhB5B,+BAAAA,oBAAoB;QAChC,IAAI2B,KAAK;YACPD,WAAW1B,IAAIE,IAAI,CAAC2B,WAAW,IAAI7B,IAAIE,IAAI,CAAC2B,WAAW,CAACC,WAAW,OAAO,SAASC,IAAAA,gBAAS,EAACJ,OAAOK,OAAOL;QAC7G;IACF;IACA,OAAO;QAACtB;QAAIC;QAAUC;QAAUE;QAAIG;QAAMC;QAAIE;QAAKE;QAAMG;QAASC;QAAQG;QAASE;KAAS;AAC9F"}

package/dist/cjs/email/parsing/header-parsing.d.cts

@@ -0,0 +1,18 @@
+export declare function extractEmailsFromRecipients(recipients: Array<{
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+}>, mode?: 'email' | 'name' | 'raw'): string[];
+export declare function formatAddressList(recipients: Array<{
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+}>, mode?: 'email' | 'name' | 'raw'): string;
+export declare function extractFrom(from: {
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+} | undefined): string | undefined;

package/dist/cjs/email/parsing/header-parsing.d.ts

@@ -0,0 +1,18 @@
+export declare function extractEmailsFromRecipients(recipients: Array<{
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+}>, mode?: 'email' | 'name' | 'raw'): string[];
+export declare function formatAddressList(recipients: Array<{
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+}>, mode?: 'email' | 'name' | 'raw'): string;
+export declare function extractFrom(from: {
+    emailAddress?: {
+        address?: string;
+        name?: string;
+    };
+} | undefined): string | undefined;

package/dist/cjs/email/parsing/header-parsing.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get extractEmailsFromRecipients () {
+        return extractEmailsFromRecipients;
+    },
+    get extractFrom () {
+        return extractFrom;
+    },
+    get formatAddressList () {
+        return formatAddressList;
+    }
+});
+function extractEmailsFromRecipients(recipients) {
+    var mode = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 'email';
+    if (!Array.isArray(recipients)) return [];
+    return recipients.map(function(r) {
+        var _ref, _ref1;
+        var _r_emailAddress, _r_emailAddress1;
+        var name = (_ref = r === null || r === void 0 ? void 0 : (_r_emailAddress = r.emailAddress) === null || _r_emailAddress === void 0 ? void 0 : _r_emailAddress.name) !== null && _ref !== void 0 ? _ref : '';
+        var email = (_ref1 = r === null || r === void 0 ? void 0 : (_r_emailAddress1 = r.emailAddress) === null || _r_emailAddress1 === void 0 ? void 0 : _r_emailAddress1.address) !== null && _ref1 !== void 0 ? _ref1 : '';
+        return mode === 'email' ? email : mode === 'name' ? name || email : "".concat(name, " <").concat(email, ">");
+    }).filter(Boolean);
+}
+function formatAddressList(recipients) {
+    var mode = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 'email';
+    return extractEmailsFromRecipients(recipients, mode).join(', ');
+}
+function extractFrom(from) {
+    var _from_emailAddress, _from_emailAddress1;
+    if (!from) return undefined;
+    return ((_from_emailAddress = from.emailAddress) === null || _from_emailAddress === void 0 ? void 0 : _from_emailAddress.address) || ((_from_emailAddress1 = from.emailAddress) === null || _from_emailAddress1 === void 0 ? void 0 : _from_emailAddress1.name) || undefined;
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/email/parsing/header-parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-outlook/src/email/parsing/header-parsing.ts"],"sourcesContent":["export function extractEmailsFromRecipients(recipients: Array<{ emailAddress?: { address?: string; name?: string } }>, mode: 'email' | 'name' | 'raw' = 'email'): string[] {\n  if (!Array.isArray(recipients)) return [];\n  return recipients\n    .map((r) => {\n      const name = r?.emailAddress?.name ?? '';\n      const email = r?.emailAddress?.address ?? '';\n      return mode === 'email' ? email : mode === 'name' ? name || email : `${name} <${email}>`;\n    })\n    .filter(Boolean);\n}\n\nexport function formatAddressList(recipients: Array<{ emailAddress?: { address?: string; name?: string } }>, mode: 'email' | 'name' | 'raw' = 'email'): string {\n  return extractEmailsFromRecipients(recipients, mode).join(', ');\n}\n\nexport function extractFrom(from: { emailAddress?: { address?: string; name?: string } } | undefined): string | undefined {\n  if (!from) return undefined;\n  return from.emailAddress?.address || from.emailAddress?.name || undefined;\n}\n"],"names":["extractEmailsFromRecipients","extractFrom","formatAddressList","recipients","mode","Array","isArray","map","r","name","emailAddress","email","address","filter","Boolean","join","from","undefined"],"mappings":";;;;;;;;;;;QAAgBA;eAAAA;;QAeAC;eAAAA;;QAJAC;eAAAA;;;AAXT,SAASF,4BAA4BG,UAAyE;QAAEC,OAAAA,iEAAiC;IACtJ,IAAI,CAACC,MAAMC,OAAO,CAACH,aAAa,OAAO,EAAE;IACzC,OAAOA,WACJI,GAAG,CAAC,SAACC;;YACSA,iBACCA;QADd,IAAMC,eAAOD,cAAAA,yBAAAA,kBAAAA,EAAGE,YAAY,cAAfF,sCAAAA,gBAAiBC,IAAI,uCAAI;QACtC,IAAME,iBAAQH,cAAAA,yBAAAA,mBAAAA,EAAGE,YAAY,cAAfF,uCAAAA,iBAAiBI,OAAO,yCAAI;QAC1C,OAAOR,SAAS,UAAUO,QAAQP,SAAS,SAASK,QAAQE,QAAQ,AAAC,GAAWA,OAATF,MAAK,MAAU,OAANE,OAAM;IACxF,GACCE,MAAM,CAACC;AACZ;AAEO,SAASZ,kBAAkBC,UAAyE;QAAEC,OAAAA,iEAAiC;IAC5I,OAAOJ,4BAA4BG,YAAYC,MAAMW,IAAI,CAAC;AAC5D;AAEO,SAASd,YAAYe,IAAwE;QAE3FA,oBAA8BA;IADrC,IAAI,CAACA,MAAM,OAAOC;IAClB,OAAOD,EAAAA,qBAAAA,KAAKN,YAAY,cAAjBM,yCAAAA,mBAAmBJ,OAAO,OAAII,sBAAAA,KAAKN,YAAY,cAAjBM,0CAAAA,oBAAmBP,IAAI,KAAIQ;AAClE"}

package/dist/cjs/email/parsing/message-extraction.d.cts

@@ -0,0 +1,4 @@
+import type { Client } from '@microsoft/microsoft-graph-client';
+import { type NormalizedMessage } from './message-mapping.js';
+/** Fetch a single Outlook message. Throws on non-OK Graph responses. */
+export declare function fetchOutlookMessage(graph: Client, id: string): Promise<NormalizedMessage>;

package/dist/cjs/email/parsing/message-extraction.d.ts

@@ -0,0 +1,4 @@
+import type { Client } from '@microsoft/microsoft-graph-client';
+import { type NormalizedMessage } from './message-mapping.js';
+/** Fetch a single Outlook message. Throws on non-OK Graph responses. */
+export declare function fetchOutlookMessage(graph: Client, id: string): Promise<NormalizedMessage>;