hypermail-mcp 0.4.3 → 0.5.0

package/README.md

@@ -3,6 +3,11 @@
 A **Model Context Protocol** server that lets an agent operate any of the user's
 inboxes through a single, unified tool surface.
 
+> **v0.5.0** — Replaced optional `isHtml` boolean with required `format`
+> parameter (`"html"` | `"markdown"`) on `send_email`, `draft_email`, and
+> `edit_draft`. Markdown bodies are converted to HTML via `marked` so
+> recipients always see clean HTML.
+>
 > **v0.4.3** — Upgraded Zod to v4.4.3. Fixed MCP SDK v1.29.0 compatibility
 > by wrapping all tool schemas in `z.object()` and replacing discriminated
 > union output schemas that caused `validateToolOutput` crashes.
@@ -121,9 +126,9 @@ account store.
 | `archive_email` | `account`, `id` | Move a message to the Archive folder. Disabled under `--read-only`. |
 | `trash_email` | `account`, `id` | Move a message to Deleted Items (trash). Disabled under `--read-only`. |
 | `move_email` | `account`, `id`, `destination` | Move to any folder by well-known name (`inbox`, `drafts`, etc.) or custom folder ID. Disabled under `--read-only`. |
-| `send_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `isHtml?`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Send an email. Appends signature when `include_signature` is true. `inReplyTo` sends as threaded reply; `forwardMessageId` sends as forward. Disabled under `--read-only`. |
-| `draft_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `isHtml?`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Save as draft instead of sending. Returns the draft message ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
-| `edit_draft` | `account`, `id`, `to?`, `cc?`, `bcc?`, `subject?`, `body?`, `isHtml?`, `include_signature?` | Edit an existing draft by ID. Only provided fields are updated. Returns the updated draft ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
+| `send_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Send an email. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Appends signature when `include_signature` is true. `inReplyTo` sends as threaded reply; `forwardMessageId` sends as forward. Disabled under `--read-only`. |
+| `draft_email` | `account`, `to[]`, `cc?`, `bcc?`, `subject`, `body`, `format`, `include_signature?`, `inReplyTo?`, `replyAll?`, `forwardMessageId?` | Save as draft instead of sending. `format` (`"html"` or `"markdown"`) controls body format — Markdown is converted to HTML via `marked`. Returns the draft message ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
+| `edit_draft` | `account`, `id`, `to?`, `cc?`, `bcc?`, `subject?`, `body?`, `format?`, `include_signature?` | Edit an existing draft by ID. Only provided fields are updated. `format` only meaningful when `body` is provided. Returns the updated draft ID and HTML body (`draftHtml`). Disabled under `--read-only`. |
 | `send_draft` | `account`, `id` | Send an existing draft email by ID. Use with draft IDs returned by `draft_email` or `edit_draft`. Disabled under `--read-only`. |
 | `add_attachment_to_draft` | `account`, `id`, `path` | Attach a local file to an existing draft email. Disabled under `--read-only`. |
 | `list_folders` | `account`, `parentFolderId?` | List available mail folders. Returns top-level folders by default, or children of `parentFolderId`. |

package/dist/cli.js

@@ -2459,6 +2459,14 @@ function buildRegistry(opts) {
 
 // src/tools/shared.ts
 import { z } from "zod";
+
+// src/markdown-to-html.ts
+import { marked } from "marked";
+function markdownToHtml(md) {
+  return marked.parse(md, { async: false });
+}
+
+// src/tools/shared.ts
 function ok(data, structuredContent) {
   const result = {
     content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -2535,21 +2543,15 @@ var folderInfoOutputSchema = z.object({
   unreadItemCount: z.number()
 });
 function composeBody(input) {
-  const { body, isHtml = false, signature, style, includeSignature } = input;
+  const { body, format, signature, style, includeSignature } = input;
+  const htmlBody = format === "markdown" ? markdownToHtml(body) : body;
   const hasSignature = includeSignature && !!signature;
   const hasStyle = !!(style && (style.fontFamily || style.fontSize || style.fontColor));
   if (!hasSignature && !hasStyle) {
-    return { body, isHtml };
+    return { body: htmlBody, isHtml: true };
   }
   const styleAttr = hasStyle ? buildStyleAttr(style) : "";
-  if (isHtml) {
-    let result2 = hasStyle ? `<div style="${styleAttr}">${body}</div>` : body;
-    if (hasSignature) result2 += `
-<div class="signature">${signature}</div>`;
-    return { body: result2, isHtml: true };
-  }
-  const escaped = escapeHtml(body);
-  let result = `<div style="${styleAttr}">${escaped}</div>`;
+  let result = hasStyle ? `<div style="${styleAttr}">${htmlBody}</div>` : htmlBody;
   if (hasSignature) result += `
 <div class="signature">${signature}</div>`;
   return { body: result, isHtml: true };
@@ -2561,9 +2563,6 @@ function buildStyleAttr(style) {
   if (style.fontColor) parts.push(`color: ${style.fontColor}`);
   return parts.join("; ");
 }
-function escapeHtml(text) {
-  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/\n/g, "<br>");
-}
 function shouldRegister(name, tools) {
   if (tools.enabledTools) {
     return tools.enabledTools.has(name);
@@ -3258,7 +3257,9 @@ function registerComposeTools(server, ctx) {
     bcc: z6.array(emailAddrSchema).optional(),
     subject: z6.string(),
     body: z6.string(),
-    isHtml: z6.boolean().optional(),
+    format: z6.enum(["html", "markdown"]).describe(
+      "Body format. 'html' sends the body as-is (must be valid HTML). 'markdown' converts the body from Markdown to HTML for clean rendering on the recipient side."
+    ),
     include_signature: z6.boolean().describe(
       "Whether to append the account's saved HTML signature to the email. If true, don't include a signature in the body param to avoid double signature. Returns an error if true but no signature is configured for this account."
     ),
@@ -3282,7 +3283,7 @@ function registerComposeTools(server, ctx) {
       }
       const composed = composeBody({
         body: args.body,
-        isHtml: args.isHtml,
+        format: args.format,
         signature: account.signature,
         style: account.style,
         includeSignature: args.include_signature
@@ -3362,7 +3363,9 @@ function registerComposeTools(server, ctx) {
     bcc: z6.array(emailAddrSchema).optional(),
     subject: z6.string().optional(),
     body: z6.string().optional(),
-    isHtml: z6.boolean().optional(),
+    format: z6.enum(["html", "markdown"]).optional().describe(
+      "Body format. Only meaningful when `body` is also provided. 'html' sends the body as-is (must be valid HTML). 'markdown' converts the body from Markdown to HTML for clean rendering on the recipient side."
+    ),
     include_signature: z6.boolean().optional().describe(
       "Whether to re-apply the account's saved HTML signature to the body. If true, don't include a signature in the body param. Only meaningful when `body` is also provided. Returns an error if true but no signature is configured for this account."
     )
@@ -3394,7 +3397,7 @@ function registerComposeTools(server, ctx) {
           if (a.body !== void 0) {
             const composed = composeBody({
               body: a.body,
-              isHtml: a.isHtml,
+              format: a.format ?? "html",
               signature: account.signature,
               style: account.style,
               includeSignature: !!a.include_signature