@mcp-z/mcp-gmail 1.0.0

package/dist/esm/mcp/tools/label-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/label-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { CHUNK_SIZE, MAX_BATCH_SIZE } from '../../constants.ts';\n\nconst inputSchema = z.object({\n  ids: z.array(z.coerce.string().trim().min(1)).min(1).describe('Gmail label IDs to delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  totalRequested: z.number().describe('Total number of labels requested to delete'),\n  successCount: z.number().describe('Number of labels successfully deleted'),\n  failureCount: z.number().describe('Number of labels that failed to delete'),\n  results: z\n    .array(\n      z.object({\n        id: z.string().describe('Label ID'),\n        success: z.boolean().describe('Whether the operation succeeded'),\n        error: z.string().optional().describe('Error message if operation failed'),\n      })\n    )\n    .describe('Individual results for each label'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ ids }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail-label-delete called', { count: ids.length });\n\n  if (!ids || ids.length === 0) {\n    throw new McpError(ErrorCode.InvalidParams, 'Missing ids');\n  }\n\n  // Validate batch size to prevent memory exhaustion\n  if (ids.length > MAX_BATCH_SIZE) {\n    throw new McpError(ErrorCode.InvalidParams, `Batch size ${ids.length} exceeds maximum allowed size of ${MAX_BATCH_SIZE}`);\n  }\n\n  // Validate and sanitize IDs\n  const validatedIds: string[] = [];\n  const invalidIds: string[] = [];\n\n  for (const id of ids) {\n    const trimmedId = id.trim();\n    if (!trimmedId) {\n      invalidIds.push(id);\n      continue;\n    }\n    // Basic Gmail label ID validation - should not contain certain characters\n    if (trimmedId.includes('/') || trimmedId.includes('\\\\') || trimmedId.includes('<') || trimmedId.includes('>')) {\n      invalidIds.push(id);\n      continue;\n    }\n    validatedIds.push(trimmedId);\n  }\n\n  if (invalidIds.length > 0) {\n    throw new McpError(ErrorCode.InvalidParams, `Found ${invalidIds.length} invalid IDs: ${invalidIds.join(', ')}`);\n  }\n\n  if (validatedIds.length === 0) {\n    throw new McpError(ErrorCode.InvalidParams, 'No valid IDs found after validation');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    // Get all labels first to check for system labels\n    const labelsResponse = await gmail.users.labels.list({ userId: 'me' });\n    const allLabels = labelsResponse.data.labels || [];\n    const labelMap = new Map(allLabels.map((label) => [label.id || '', label]));\n\n    // Process deletions in chunks to prevent memory exhaustion\n    const allResults: Array<{ id: string; success: boolean; error?: string }> = [];\n\n    for (let i = 0; i < validatedIds.length; i += CHUNK_SIZE) {\n      const chunk = validatedIds.slice(i, i + CHUNK_SIZE);\n      logger.info('Processing chunk', { chunkIndex: i / CHUNK_SIZE + 1, chunkSize: chunk.length, totalChunks: Math.ceil(validatedIds.length / CHUNK_SIZE) });\n\n      const chunkResults = await Promise.allSettled(\n        chunk.map(async (id) => {\n          const label = labelMap.get(id);\n\n          // Check if label exists\n          if (!label) {\n            throw new Error(`Label not found: ${id}`);\n          }\n\n          // Check if it's a system label\n          if (label.type === 'system') {\n            throw new Error(`Cannot delete system label: ${label.name} (${id})`);\n          }\n\n          // Delete the label\n          await gmail.users.labels.delete({\n            userId: 'me',\n            id: id,\n          });\n          return { id, success: true };\n        })\n      );\n\n      // Process chunk results\n      const processedChunkResults = chunkResults.map((result, chunkIndex) => {\n        const id = chunk[chunkIndex];\n        if (!id) {\n          throw new Error(`Chunk index ${chunkIndex} is out of bounds for chunk of size ${chunk.length}`);\n        }\n        if (result.status === 'fulfilled') {\n          return { id, success: true };\n        }\n\n        // Extract error message more robustly\n        let errorMessage = 'Unknown error';\n        if (result.reason) {\n          if (typeof result.reason === 'string') {\n            errorMessage = result.reason;\n          } else if (result.reason instanceof Error) {\n            errorMessage = result.reason.message;\n          } else if (result.reason && typeof result.reason === 'object' && 'message' in result.reason) {\n            errorMessage = String(result.reason.message);\n          } else if (result.reason && typeof result.reason === 'object' && 'error' in result.reason) {\n            errorMessage = String(result.reason.error);\n          } else {\n            errorMessage = String(result.reason);\n          }\n        }\n\n        return { id, success: false, error: errorMessage };\n      });\n\n      allResults.push(...processedChunkResults);\n    }\n\n    const successCount = allResults.filter((r) => r.success).length;\n    const failureCount = allResults.filter((r) => !r.success).length;\n\n    logger.info('gmail-label-delete completed', {\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      chunksProcessed: Math.ceil(validatedIds.length / CHUNK_SIZE),\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      totalRequested: validatedIds.length,\n      successCount,\n      failureCount,\n      results: allResults,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail-label-delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","CHUNK_SIZE","MAX_BATCH_SIZE","inputSchema","object","ids","array","coerce","string","trim","min","describe","successBranchSchema","type","literal","totalRequested","number","successCount","failureCount","results","id","success","boolean","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","InvalidParams","validatedIds","invalidIds","trimmedId","push","includes","join","gmail","version","auth","authContext","labelsResponse","users","labels","list","userId","allLabels","data","labelMap","Map","map","label","allResults","i","chunk","slice","chunkIndex","chunkSize","totalChunks","Math","ceil","chunkResults","Promise","allSettled","get","Error","name","delete","processedChunkResults","status","errorMessage","reason","message","String","filter","r","chunksProcessed","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/labels-list.d.ts

@@ -0,0 +1,75 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            user: "user";
+            system: "system";
+        }>;
+        visibility: z.ZodEnum<{
+            labelShow: "labelShow";
+            labelHide: "labelHide";
+            labelShowIfUnread: "labelShowIfUnread";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler(_args: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            items: {
+                id: string;
+                name: string;
+                type: "user" | "system";
+                visibility: "labelShow" | "labelHide" | "labelShowIfUnread";
+            }[];
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "List Gmail labels for label: query syntax. Case-sensitive.";
+        readonly inputSchema: z.ZodObject<{}, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        user: "user";
+                        system: "system";
+                    }>;
+                    visibility: z.ZodEnum<{
+                        labelShow: "labelShow";
+                        labelHide: "labelHide";
+                        labelShowIfUnread: "labelShowIfUnread";
+                    }>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/labels-list.js

@@ -0,0 +1,122 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+// Schema for individual label items
+const LabelSchema = z.object({
+    id: z.string().describe('Gmail label ID'),
+    name: z.string().describe('Label name for use in queries (case-sensitive)'),
+    type: z.enum([
+        'user',
+        'system'
+    ]).describe('Whether this is a user-created or system label'),
+    visibility: z.enum([
+        'labelShow',
+        'labelHide',
+        'labelShowIfUnread'
+    ]).describe('Label visibility in Gmail UI')
+});
+const inputSchema = z.object({});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    items: z.array(LabelSchema)
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'List Gmail labels for label: query syntax. Case-sensitive.',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler(_args, extra) {
+    const logger = extra.logger;
+    logger.info('gmail.labels.list called');
+    try {
+        const gmail = google.gmail({
+            version: 'v1',
+            auth: extra.authContext.auth
+        });
+        const started = Date.now();
+        // Fetch all labels from Gmail API
+        const response = await gmail.users.labels.list({
+            userId: 'me'
+        });
+        const labels = response.data.labels || [];
+        // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema
+        const availableLabels = labels.filter((label)=>{
+            var _label_id;
+            // Exclude CATEGORY_* labels as they're handled by the categories tool
+            return !((_label_id = label.id) === null || _label_id === void 0 ? void 0 : _label_id.startsWith('CATEGORY_'));
+        }).map((label)=>{
+            const id = label.id;
+            const name = label.name || id;
+            // Determine label type
+            const type = label.type === 'user' ? 'user' : 'system';
+            // Map label visibility
+            let visibility = 'labelShow';
+            if (label.labelListVisibility === 'labelHide') {
+                visibility = 'labelHide';
+            } else if (label.labelListVisibility === 'labelShowIfUnread') {
+                visibility = 'labelShowIfUnread';
+            }
+            return {
+                id,
+                name,
+                type,
+                visibility
+            };
+        }).sort((a, b)=>{
+            // Sort user labels first, then system labels, both alphabetically
+            if (a.type !== b.type) {
+                return a.type === 'user' ? -1 : 1;
+            }
+            // Use simple ASCII comparison for consistent, case-sensitive sorting
+            return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+        });
+        const durationMs = Date.now() - started;
+        logger.info('gmail.labels.list results', {
+            labelCount: availableLabels.length,
+            userLabels: availableLabels.filter((l)=>l.type === 'user').length,
+            systemLabels: availableLabels.filter((l)=>l.type === 'system').length,
+            totalLabels: labels.length
+        });
+        logger.info('gmail.labels.list metrics', {
+            durationMs
+        });
+        const result = {
+            type: 'success',
+            items: availableLabels
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('gmail.labels.list error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'labels-list',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/labels-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/labels-list.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\n\n// Schema for individual label items\nconst LabelSchema = z.object({\n  id: z.string().describe('Gmail label ID'),\n  name: z.string().describe('Label name for use in queries (case-sensitive)'),\n  type: z.enum(['user', 'system']).describe('Whether this is a user-created or system label'),\n  visibility: z.enum(['labelShow', 'labelHide', 'labelShowIfUnread']).describe('Label visibility in Gmail UI'),\n});\n\nconst inputSchema = z.object({});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z.array(LabelSchema),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'List Gmail labels for label: query syntax. Case-sensitive.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(_args: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.labels.list called');\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    const started = Date.now();\n\n    // Fetch all labels from Gmail API\n    const response = await gmail.users.labels.list({ userId: 'me' });\n    const labels = response.data.labels || [];\n\n    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema\n    const availableLabels = labels\n      .filter((label) => {\n        // Exclude CATEGORY_* labels as they're handled by the categories tool\n        return !label.id?.startsWith('CATEGORY_');\n      })\n      .map((label) => {\n        const id = label.id as string;\n        const name = label.name || id;\n\n        // Determine label type\n        const type: 'user' | 'system' = label.type === 'user' ? 'user' : 'system';\n\n        // Map label visibility\n        let visibility: 'labelShow' | 'labelHide' | 'labelShowIfUnread' = 'labelShow';\n        if (label.labelListVisibility === 'labelHide') {\n          visibility = 'labelHide';\n        } else if (label.labelListVisibility === 'labelShowIfUnread') {\n          visibility = 'labelShowIfUnread';\n        }\n\n        return {\n          id,\n          name,\n          type,\n          visibility,\n        };\n      })\n      .sort((a, b) => {\n        // Sort user labels first, then system labels, both alphabetically\n        if (a.type !== b.type) {\n          return a.type === 'user' ? -1 : 1;\n        }\n        // Use simple ASCII comparison for consistent, case-sensitive sorting\n        return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;\n      });\n\n    const durationMs = Date.now() - started;\n\n    logger.info('gmail.labels.list results', {\n      labelCount: availableLabels.length,\n      userLabels: availableLabels.filter((l) => l.type === 'user').length,\n      systemLabels: availableLabels.filter((l) => l.type === 'system').length,\n      totalLabels: labels.length,\n    });\n    logger.info('gmail.labels.list metrics', { durationMs });\n\n    const result: Output = {\n      type: 'success' as const,\n      items: availableLabels,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.labels.list error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error listing labels: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'labels-list',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","LabelSchema","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_args","extra","logger","info","gmail","version","auth","authContext","started","Date","now","response","users","labels","list","userId","data","availableLabels","filter","label","startsWith","map","labelListVisibility","sort","a","b","durationMs","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/message-get.d.ts

@@ -0,0 +1,146 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodCoercedString<unknown>;
+    fields: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>>>;
+    excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    item: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodString>;
+        fromName: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        cc: z.ZodOptional<z.ZodString>;
+        bcc: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        receivedDateTime: z.ZodOptional<z.ZodString>;
+        snippet: z.ZodOptional<z.ZodString>;
+        isRead: z.ZodOptional<z.ZodBoolean>;
+        isImportant: z.ZodOptional<z.ZodBoolean>;
+        hasAttachments: z.ZodOptional<z.ZodBoolean>;
+        attachmentCount: z.ZodOptional<z.ZodNumber>;
+        labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        folderName: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyContentType: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            html: "html";
+        }>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            filename: z.ZodString;
+            mimeType: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, fields, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            item: {
+                id?: string;
+                threadId?: string;
+                subject?: string;
+                from?: string;
+                fromName?: string;
+                to?: string;
+                cc?: string;
+                bcc?: string;
+                date?: string;
+                receivedDateTime?: string;
+                snippet?: string;
+                isRead?: boolean;
+                isImportant?: boolean;
+                hasAttachments?: boolean;
+                attachmentCount?: number;
+                labelIds?: string[];
+                folderName?: string;
+                body?: string;
+                bodyContentType?: "text" | "html";
+                attachments?: {
+                    id: string;
+                    filename: string;
+                    mimeType: string;
+                    size?: number;
+                }[];
+            };
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Get a Gmail message by ID with flexible field selection";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodCoercedString<unknown>;
+            fields: z.ZodOptional<z.ZodString>;
+            contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                text: "text";
+                html: "html";
+            }>>>;
+            excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                item: z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    threadId: z.ZodOptional<z.ZodString>;
+                    subject: z.ZodOptional<z.ZodString>;
+                    from: z.ZodOptional<z.ZodString>;
+                    fromName: z.ZodOptional<z.ZodString>;
+                    to: z.ZodOptional<z.ZodString>;
+                    cc: z.ZodOptional<z.ZodString>;
+                    bcc: z.ZodOptional<z.ZodString>;
+                    date: z.ZodOptional<z.ZodString>;
+                    receivedDateTime: z.ZodOptional<z.ZodString>;
+                    snippet: z.ZodOptional<z.ZodString>;
+                    isRead: z.ZodOptional<z.ZodBoolean>;
+                    isImportant: z.ZodOptional<z.ZodBoolean>;
+                    hasAttachments: z.ZodOptional<z.ZodBoolean>;
+                    attachmentCount: z.ZodOptional<z.ZodNumber>;
+                    labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    folderName: z.ZodOptional<z.ZodString>;
+                    body: z.ZodOptional<z.ZodString>;
+                    bodyContentType: z.ZodOptional<z.ZodEnum<{
+                        text: "text";
+                        html: "html";
+                    }>>;
+                    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        filename: z.ZodString;
+                        mimeType: z.ZodString;
+                        size: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/message-get.js

@@ -0,0 +1,145 @@
+import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { createFieldsSchema, filterFields, parseFields } from '@mcp-z/server';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';
+import { toIsoUtc } from '../../lib/date-conversion.js';
+const inputSchema = z.object({
+    id: z.coerce.string().trim().min(1).describe('Gmail message ID to retrieve'),
+    fields: createFieldsSchema({
+        availableFields: EMAIL_FIELDS,
+        fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,
+        commonPatterns: EMAIL_COMMON_PATTERNS,
+        resourceName: 'email message'
+    }),
+    contentType: EmailContentTypeSchema,
+    excludeThreadHistory: ExcludeThreadHistorySchema
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    item: EmailDetailSchema
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Get a Gmail message by ID with flexible field selection',
+    inputSchema: inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, fields, contentType, excludeThreadHistory }, extra) {
+    const logger = extra.logger;
+    const requestedFields = parseFields(fields, EMAIL_FIELDS);
+    logger.info('gmail.message.get called', {
+        id: Boolean(id),
+        fields: fields || 'all'
+    });
+    try {
+        var _fullData_id, _fullData_threadId, _headersMap_Subject, _fullData_snippet;
+        var _fullData_payload;
+        if (!id) {
+            throw new McpError(ErrorCode.InvalidParams, 'Missing id');
+        }
+        const gmail = google.gmail({
+            version: 'v1',
+            auth: extra.authContext.auth
+        });
+        const response = await gmail.users.messages.get({
+            userId: 'me',
+            id: id,
+            format: 'full',
+            metadataHeaders: [
+                'From',
+                'To',
+                'Cc',
+                'Bcc',
+                'Subject',
+                'Date'
+            ]
+        });
+        const fullData = response.data;
+        if (!fullData) {
+            throw new McpError(ErrorCode.InvalidRequest, 'Message not found');
+        }
+        // Build full message data with type guards
+        const headers = fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers;
+        const headersArray = Array.isArray(headers) ? headers : [];
+        const headersMap = Object.fromEntries(headersArray.map((h)=>{
+            var _header_name, _header_value;
+            const header = h;
+            return [
+                String((_header_name = header.name) !== null && _header_name !== void 0 ? _header_name : ''),
+                String((_header_value = header.value) !== null && _header_value !== void 0 ? _header_value : '')
+            ];
+        }));
+        const fromInfo = extractFrom(headersMap.From);
+        const toStr = extractEmails(headersMap.To).join(', ');
+        const ccStr = extractEmails(headersMap.Cc).join(', ');
+        const bccStr = extractEmails(headersMap.Bcc).join(', ');
+        const messagePayload = fullData === null || fullData === void 0 ? void 0 : fullData.payload;
+        const bodyContent = messagePayload ? extractBodyFromPayload(messagePayload, {
+            contentType,
+            excludeThreadHistory
+        }) : '';
+        const payload = {
+            id: (_fullData_id = fullData.id) !== null && _fullData_id !== void 0 ? _fullData_id : undefined,
+            threadId: (_fullData_threadId = fullData.threadId) !== null && _fullData_threadId !== void 0 ? _fullData_threadId : undefined,
+            date: toIsoUtc(headersMap.Date) || headersMap.Date,
+            from: (fromInfo === null || fromInfo === void 0 ? void 0 : fromInfo.address) || headersMap.From,
+            fromName: fromInfo === null || fromInfo === void 0 ? void 0 : fromInfo.name,
+            to: toStr,
+            cc: ccStr,
+            bcc: bccStr,
+            subject: (_headersMap_Subject = headersMap.Subject) !== null && _headersMap_Subject !== void 0 ? _headersMap_Subject : '',
+            snippet: (_fullData_snippet = fullData.snippet) !== null && _fullData_snippet !== void 0 ? _fullData_snippet : undefined,
+            body: bodyContent,
+            bodyContentType: contentType
+        };
+        // Filter based on requested fields
+        const filteredPayload = filterFields(payload, requestedFields);
+        logger.info('gmail.message.get result', {
+            id: fullData.id,
+            subject: payload.subject,
+            from: payload.from,
+            fields: fields || 'all'
+        });
+        const result = {
+            type: 'success',
+            item: filteredPayload
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('gmail.message.get error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error getting message: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'message-get',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/message-get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-get.ts"],"sourcesContent":["import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, filterFields, parseFields, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { extractBodyFromPayload, extractEmails, extractFrom } from '../../email/parsing/message-extraction.js';\nimport { toIsoUtc } from '../../lib/date-conversion.js';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to retrieve'),\n  fields: createFieldsSchema({\n    availableFields: EMAIL_FIELDS,\n    fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n    commonPatterns: EMAIL_COMMON_PATTERNS,\n    resourceName: 'email message',\n  }),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: EmailDetailSchema,\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get a Gmail message by ID with flexible field selection',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, fields, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, EMAIL_FIELDS);\n\n  logger.info('gmail.message.get called', { id: Boolean(id), fields: fields || 'all' });\n\n  try {\n    if (!id) {\n      throw new McpError(ErrorCode.InvalidParams, 'Missing id');\n    }\n\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n    const response = await gmail.users.messages.get({\n      userId: 'me',\n      id: id,\n      format: 'full',\n      metadataHeaders: ['From', 'To', 'Cc', 'Bcc', 'Subject', 'Date'],\n    });\n    const fullData = response.data;\n    if (!fullData) {\n      throw new McpError(ErrorCode.InvalidRequest, 'Message not found');\n    }\n\n    // Build full message data with type guards\n    const headers = fullData?.payload?.headers;\n    const headersArray = Array.isArray(headers) ? headers : [];\n    const headersMap: Record<string, string> = Object.fromEntries(\n      headersArray.map((h: unknown) => {\n        const header = h as gmail_v1.Schema$MessagePartHeader;\n        return [String(header.name ?? ''), String(header.value ?? '')];\n      })\n    );\n    const fromInfo = extractFrom(headersMap.From);\n    const toStr = extractEmails(headersMap.To).join(', ');\n    const ccStr = extractEmails(headersMap.Cc).join(', ');\n    const bccStr = extractEmails(headersMap.Bcc).join(', ');\n    const messagePayload = fullData?.payload;\n    const bodyContent = messagePayload ? extractBodyFromPayload(messagePayload, { contentType, excludeThreadHistory }) : '';\n    const payload: Partial<EmailDetail> = {\n      id: fullData.id ?? undefined,\n      threadId: fullData.threadId ?? undefined,\n      date: toIsoUtc(headersMap.Date) || headersMap.Date,\n      from: fromInfo?.address || headersMap.From,\n      fromName: fromInfo?.name,\n      to: toStr,\n      cc: ccStr,\n      bcc: bccStr,\n      subject: headersMap.Subject ?? '',\n      snippet: fullData.snippet ?? undefined,\n      body: bodyContent,\n      bodyContentType: contentType,\n    };\n\n    // Filter based on requested fields\n    const filteredPayload = filterFields(payload, requestedFields);\n\n    logger.info('gmail.message.get result', { id: fullData.id, subject: payload.subject, from: payload.from, fields: fields || 'all' });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: filteredPayload,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.message.get error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error getting message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'message-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","filterFields","parseFields","ErrorCode","McpError","google","z","extractBodyFromPayload","extractEmails","extractFrom","toIsoUtc","inputSchema","object","id","coerce","string","trim","min","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","contentType","excludeThreadHistory","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","requestedFields","info","Boolean","fullData","headersMap","InvalidParams","gmail","version","auth","authContext","response","users","messages","get","userId","format","metadataHeaders","data","InvalidRequest","headers","payload","headersArray","Array","isArray","Object","fromEntries","map","h","header","String","name","value","fromInfo","From","toStr","To","join","ccStr","Cc","bccStr","Bcc","messagePayload","bodyContent","undefined","threadId","date","Date","from","address","fromName","to","cc","bcc","subject","Subject","snippet","body","bodyContentType","filteredPayload","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/message-mark-read.d.ts

@@ -0,0 +1,50 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodCoercedString<unknown>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id }: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            id: string;
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Mark a Gmail message as read";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodCoercedString<unknown>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};