gmail-workspace-mcp-server 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmail-workspace-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server for Gmail integration with OAuth2 and service account support",
   "main": "build/index.js",
   "type": "module",

package/shared/gmail-client/lib/mime-utils.d.ts

@@ -11,6 +11,16 @@ export interface MimeMessageOptions {
     inReplyTo?: string;
     references?: string;
 }
+/**
+ * Encodes a string as an RFC 2047 encoded-word using UTF-8 and Base64.
+ * Only encodes if the string contains non-ASCII characters.
+ *
+ * Note: RFC 2047 limits encoded-words to 75 characters. Very long non-ASCII
+ * subjects should technically be split into multiple encoded-words separated
+ * by folding whitespace. In practice, Gmail handles oversized encoded-words
+ * correctly, so we encode as a single word for simplicity.
+ */
+export declare function encodeSubject(subject: string): string;
 /**
  * Builds a MIME message from email options.
  * If both plaintextBody and htmlBody are provided, creates a multipart/alternative message.

package/shared/gmail-client/lib/mime-utils.js

@@ -1,6 +1,30 @@
 /**
  * MIME message utilities for building and encoding email messages
  */
+/**
+ * Encodes a string as an RFC 2047 encoded-word using UTF-8 and Base64.
+ * Only encodes if the string contains non-ASCII characters.
+ *
+ * Note: RFC 2047 limits encoded-words to 75 characters. Very long non-ASCII
+ * subjects should technically be split into multiple encoded-words separated
+ * by folding whitespace. In practice, Gmail handles oversized encoded-words
+ * correctly, so we encode as a single word for simplicity.
+ */
+export function encodeSubject(subject) {
+    // eslint-disable-next-line no-control-regex
+    if (!/[^\x00-\x7F]/.test(subject)) {
+        return subject;
+    }
+    const encoded = Buffer.from(subject, 'utf-8').toString('base64');
+    return `=?UTF-8?B?${encoded}?=`;
+}
+/**
+ * Strips leading newline characters (\r\n, \n, and bare \r) from email body content.
+ * Prevents extra blank lines at the top of the email when displayed in Gmail.
+ */
+function stripLeadingNewlines(body) {
+    return body.replace(/^[\r\n]+/, '');
+}
 /**
  * Builds a MIME message from email options.
  * If both plaintextBody and htmlBody are provided, creates a multipart/alternative message.
@@ -10,7 +34,7 @@ export function buildMimeMessage(from, options) {
     const headers = [
         `From: ${from}`,
         `To: ${options.to}`,
-        `Subject: ${options.subject}`,
+        `Subject: ${encodeSubject(options.subject)}`,
         'MIME-Version: 1.0',
     ];
     if (options.cc) {
@@ -29,9 +53,11 @@ export function buildMimeMessage(from, options) {
     if (options.plaintextBody && options.htmlBody) {
         const boundary = `boundary_${Date.now()}_${Math.random().toString(36).substring(2)}`;
         headers.push(`Content-Type: multipart/alternative; boundary="${boundary}"`);
+        const plainBody = stripLeadingNewlines(options.plaintextBody);
+        const htmlBody = stripLeadingNewlines(options.htmlBody);
         const parts = [
-            `--${boundary}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${options.plaintextBody}`,
-            `--${boundary}\r\nContent-Type: text/html; charset=utf-8\r\n\r\n${options.htmlBody}`,
+            `--${boundary}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${plainBody}`,
+            `--${boundary}\r\nContent-Type: text/html; charset=utf-8\r\n\r\n${htmlBody}`,
             `--${boundary}--`,
         ];
         return headers.join('\r\n') + '\r\n\r\n' + parts.join('\r\n');
@@ -39,10 +65,10 @@ export function buildMimeMessage(from, options) {
     // Single content type
     if (options.htmlBody) {
         headers.push('Content-Type: text/html; charset=utf-8');
-        return headers.join('\r\n') + '\r\n\r\n' + options.htmlBody;
+        return headers.join('\r\n') + '\r\n\r\n' + stripLeadingNewlines(options.htmlBody);
     }
     headers.push('Content-Type: text/plain; charset=utf-8');
-    return headers.join('\r\n') + '\r\n\r\n' + (options.plaintextBody ?? '');
+    return headers.join('\r\n') + '\r\n\r\n' + stripLeadingNewlines(options.plaintextBody ?? '');
 }
 /**
  * Converts a string to base64url encoding (RFC 4648)