gmail-workspace-mcp-server 0.0.4 → 0.0.5

package/package.json

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

package/shared/tools/get-email-conversation.d.ts

@@ -3,10 +3,13 @@ import { z } from 'zod';
 import type { ClientFactory } from '../server.js';
 export declare const GetEmailConversationSchema: z.ZodObject<{
     email_id: z.ZodString;
+    include_html: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     email_id: string;
+    include_html?: boolean | undefined;
 }, {
     email_id: string;
+    include_html?: boolean | undefined;
 }>;
 export declare function getEmailConversationTool(server: Server, clientFactory: ClientFactory): {
     name: string;
@@ -18,6 +21,10 @@ export declare function getEmailConversationTool(server: Server, clientFactory:
                 type: string;
                 description: string;
             };
+            include_html: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/shared/tools/get-email-conversation.js

@@ -3,9 +3,12 @@ import { getHeader } from '../utils/email-helpers.js';
 const PARAM_DESCRIPTIONS = {
     email_id: 'The unique identifier of the email to retrieve. ' +
         'Obtain this from list_email_conversations or search_email_conversations.',
+    include_html: 'When true, includes the raw HTML body of the email (if available) in addition to the plain text. ' +
+        'Useful for rendering emails with original formatting, creating screenshots, or archival workflows.',
 };
 export const GetEmailConversationSchema = z.object({
     email_id: z.string().min(1).describe(PARAM_DESCRIPTIONS.email_id),
+    include_html: z.boolean().optional().describe(PARAM_DESCRIPTIONS.include_html),
 });
 const TOOL_DESCRIPTION = `Retrieve the full content of a specific email conversation by its ID.
 
@@ -13,11 +16,13 @@ Returns the complete email including headers, body content, and attachment infor
 
 **Parameters:**
 - email_id: The unique identifier of the email (required)
+- include_html: When true, includes raw HTML body in addition to plain text (optional)
 
 **Returns:**
 Full email details including:
 - Subject, From, To, Cc, Date headers
 - Full message body (plain text preferred, HTML as fallback)
+- Raw HTML body (when include_html is true and HTML content is available)
 - List of attachments (if any)
 - Labels assigned to the email
 
@@ -25,6 +30,8 @@ Full email details including:
 - Read the full content of an email after listing conversations
 - Extract specific information from an email body
 - Check attachment details
+- Render emails with original HTML formatting (use include_html: true)
+- Create email screenshots or archives with original styling
 
 **Note:** Use list_email_conversations or search_email_conversations first to get email IDs.`;
 /**
@@ -84,6 +91,22 @@ function getEmailBody(email) {
     }
     return '(No body content available)';
 }
+/**
+ * Gets the raw HTML body content from an email (if available)
+ */
+function getEmailHtmlBody(email) {
+    // Check if body is directly on payload and it's HTML
+    if (email.payload?.body?.data && email.payload.mimeType === 'text/html') {
+        return decodeBase64Url(email.payload.body.data);
+    }
+    // Try to extract HTML from parts
+    if (email.payload?.parts) {
+        const html = extractBodyContent(email.payload.parts, 'text/html');
+        if (html)
+            return html;
+    }
+    return null;
+}
 /**
  * Extracts attachment information from email parts
  */
@@ -108,7 +131,7 @@ function getAttachments(parts) {
 /**
  * Formats an email for display
  */
-function formatFullEmail(email) {
+function formatFullEmail(email, options) {
     const subject = getHeader(email, 'Subject') || '(No Subject)';
     const from = getHeader(email, 'From') || 'Unknown';
     const to = getHeader(email, 'To') || 'Unknown';
@@ -136,6 +159,26 @@ function formatFullEmail(email) {
 ## Body
 
 ${body}`;
+    // Include raw HTML body if requested
+    if (options?.includeHtml) {
+        const htmlBody = getEmailHtmlBody(email);
+        if (htmlBody) {
+            output += `
+
+## HTML Body
+
+\`\`\`html
+${htmlBody}
+\`\`\``;
+        }
+        else {
+            output += `
+
+## HTML Body
+
+(No HTML content available)`;
+        }
+    }
     if (attachments.length > 0) {
         output += `\n\n## Attachments (${attachments.length})\n`;
         attachments.forEach((att, i) => {
@@ -156,6 +199,10 @@ export function getEmailConversationTool(server, clientFactory) {
                     type: 'string',
                     description: PARAM_DESCRIPTIONS.email_id,
                 },
+                include_html: {
+                    type: 'boolean',
+                    description: PARAM_DESCRIPTIONS.include_html,
+                },
             },
             required: ['email_id'],
         },
@@ -166,7 +213,9 @@ export function getEmailConversationTool(server, clientFactory) {
                 const email = await client.getMessage(parsed.email_id, {
                     format: 'full',
                 });
-                const formattedEmail = formatFullEmail(email);
+                const formattedEmail = formatFullEmail(email, {
+                    includeHtml: parsed.include_html,
+                });
                 return {
                     content: [
                         {