@mcp-z/mcp-gmail 1.0.0

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

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+// Schema for individual label items
+var LabelSchema = _zod.z.object({
+    id: _zod.z.string().describe('Gmail label ID'),
+    name: _zod.z.string().describe('Label name for use in queries (case-sensitive)'),
+    type: _zod.z.enum([
+        'user',
+        'system'
+    ]).describe('Whether this is a user-created or system label'),
+    visibility: _zod.z.enum([
+        'labelShow',
+        'labelHide',
+        'labelShowIfUnread'
+    ]).describe('Label visibility in Gmail UI')
+});
+var inputSchema = _zod.z.object({});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    items: _zod.z.array(LabelSchema)
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'List Gmail labels for label: query syntax. Case-sensitive.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_args, extra) {
+    return _async_to_generator(function() {
+        var logger, gmail, started, response, labels, availableLabels, durationMs, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    logger = extra.logger;
+                    logger.info('gmail.labels.list called');
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    gmail = _googleapis.google.gmail({
+                        version: 'v1',
+                        auth: extra.authContext.auth
+                    });
+                    started = Date.now();
+                    return [
+                        4,
+                        gmail.users.labels.list({
+                            userId: 'me'
+                        })
+                    ];
+                case 2:
+                    response = _state.sent();
+                    labels = response.data.labels || [];
+                    // Filter out CATEGORY_* labels (handled by categories tool) and map to our schema
+                    availableLabels = labels.filter(function(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(function(label) {
+                        var id = label.id;
+                        var name = label.name || id;
+                        // Determine label type
+                        var type = label.type === 'user' ? 'user' : 'system';
+                        // Map label visibility
+                        var visibility = 'labelShow';
+                        if (label.labelListVisibility === 'labelHide') {
+                            visibility = 'labelHide';
+                        } else if (label.labelListVisibility === 'labelShowIfUnread') {
+                            visibility = 'labelShowIfUnread';
+                        }
+                        return {
+                            id: id,
+                            name: name,
+                            type: type,
+                            visibility: visibility
+                        };
+                    }).sort(function(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;
+                    });
+                    durationMs = Date.now() - started;
+                    logger.info('gmail.labels.list results', {
+                        labelCount: availableLabels.length,
+                        userLabels: availableLabels.filter(function(l) {
+                            return l.type === 'user';
+                        }).length,
+                        systemLabels: availableLabels.filter(function(l) {
+                            return l.type === 'system';
+                        }).length,
+                        totalLabels: labels.length
+                    });
+                    logger.info('gmail.labels.list metrics', {
+                        durationMs: durationMs
+                    });
+                    result = {
+                        type: 'success',
+                        items: availableLabels
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 3:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('gmail.labels.list error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error listing labels: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
+function createTool() {
+    return {
+        name: 'labels-list',
+        config: config,
+        handler: handler
+    };
+}
+/* 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/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":["createTool","AuthRequiredBranchSchema","schemas","LabelSchema","z","object","id","string","describe","name","type","enum","visibility","inputSchema","successBranchSchema","literal","items","array","outputSchema","discriminatedUnion","config","description","result","handler","_args","extra","logger","gmail","started","response","labels","availableLabels","durationMs","error","message","info","google","version","auth","authContext","Date","now","users","list","userId","data","filter","label","startsWith","map","labelListVisibility","sort","a","b","labelCount","length","userLabels","l","systemLabels","totalLabels","content","text","JSON","stringify","structuredContent","Error","String","McpError","ErrorCode","InternalError","stack","undefined"],"mappings":";;;;+BAyHA;;;eAAwBA;;;2BAxHA;qBAKY;0BACb;mBACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AALlB,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAOR,oCAAoC;AACpC,IAAME,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,IAAIF,MAAC,CAACG,MAAM,GAAGC,QAAQ,CAAC;IACxBC,MAAML,MAAC,CAACG,MAAM,GAAGC,QAAQ,CAAC;IAC1BE,MAAMN,MAAC,CAACO,IAAI,CAAC;QAAC;QAAQ;KAAS,EAAEH,QAAQ,CAAC;IAC1CI,YAAYR,MAAC,CAACO,IAAI,CAAC;QAAC;QAAa;QAAa;KAAoB,EAAEH,QAAQ,CAAC;AAC/E;AAEA,IAAMK,cAAcT,MAAC,CAACC,MAAM,CAAC,CAAC;AAE9B,IAAMS,sBAAsBV,MAAC,CAACC,MAAM,CAAC;IACnCK,MAAMN,MAAC,CAACW,OAAO,CAAC;IAChBC,OAAOZ,MAAC,CAACa,KAAK,CAACd;AACjB;AAEA,IAAMe,eAAed,MAAC,CAACe,kBAAkB,CAAC,QAAQ;IAACL;IAAqBb;CAAyB;AAEjG,IAAMmB,SAAS;IACbC,aAAa;IACbR,aAAaA;IACbK,cAAcd,MAAC,CAACC,MAAM,CAAC;QACrBiB,QAAQJ;IACV;AACF;AAKA,SAAeK,QAAQC,KAAY,EAAEC,KAAoB;;YACjDC,QAIEC,OACAC,SAGAC,UACAC,QAGAC,iBAoCAC,YAUAV,QAcCW,OACDC;;;;oBAzEFR,SAASD,MAAMC,MAAM;oBAC3BA,OAAOS,IAAI,CAAC;;;;;;;;;oBAGJR,QAAQS,kBAAM,CAACT,KAAK,CAAC;wBAAEU,SAAS;wBAAMC,MAAMb,MAAMc,WAAW,CAACD,IAAI;oBAAC;oBACnEV,UAAUY,KAAKC,GAAG;oBAGP;;wBAAMd,MAAMe,KAAK,CAACZ,MAAM,CAACa,IAAI,CAAC;4BAAEC,QAAQ;wBAAK;;;oBAAxDf,WAAW;oBACXC,SAASD,SAASgB,IAAI,CAACf,MAAM;oBAEnC,kFAAkF;oBAC5EC,kBAAkBD,OACrBgB,MAAM,CAAC,SAACC;4BAECA;wBADR,sEAAsE;wBACtE,OAAO,GAACA,YAAAA,MAAMzC,EAAE,cAARyC,gCAAAA,UAAUC,UAAU,CAAC;oBAC/B,GACCC,GAAG,CAAC,SAACF;wBACJ,IAAMzC,KAAKyC,MAAMzC,EAAE;wBACnB,IAAMG,OAAOsC,MAAMtC,IAAI,IAAIH;wBAE3B,uBAAuB;wBACvB,IAAMI,OAA0BqC,MAAMrC,IAAI,KAAK,SAAS,SAAS;wBAEjE,uBAAuB;wBACvB,IAAIE,aAA8D;wBAClE,IAAImC,MAAMG,mBAAmB,KAAK,aAAa;4BAC7CtC,aAAa;wBACf,OAAO,IAAImC,MAAMG,mBAAmB,KAAK,qBAAqB;4BAC5DtC,aAAa;wBACf;wBAEA,OAAO;4BACLN,IAAAA;4BACAG,MAAAA;4BACAC,MAAAA;4BACAE,YAAAA;wBACF;oBACF,GACCuC,IAAI,CAAC,SAACC,GAAGC;wBACR,kEAAkE;wBAClE,IAAID,EAAE1C,IAAI,KAAK2C,EAAE3C,IAAI,EAAE;4BACrB,OAAO0C,EAAE1C,IAAI,KAAK,SAAS,CAAC,IAAI;wBAClC;wBACA,qEAAqE;wBACrE,OAAO0C,EAAE3C,IAAI,GAAG4C,EAAE5C,IAAI,GAAG,CAAC,IAAI2C,EAAE3C,IAAI,GAAG4C,EAAE5C,IAAI,GAAG,IAAI;oBACtD;oBAEIuB,aAAaQ,KAAKC,GAAG,KAAKb;oBAEhCF,OAAOS,IAAI,CAAC,6BAA6B;wBACvCmB,YAAYvB,gBAAgBwB,MAAM;wBAClCC,YAAYzB,gBAAgBe,MAAM,CAAC,SAACW;mCAAMA,EAAE/C,IAAI,KAAK;2BAAQ6C,MAAM;wBACnEG,cAAc3B,gBAAgBe,MAAM,CAAC,SAACW;mCAAMA,EAAE/C,IAAI,KAAK;2BAAU6C,MAAM;wBACvEI,aAAa7B,OAAOyB,MAAM;oBAC5B;oBACA7B,OAAOS,IAAI,CAAC,6BAA6B;wBAAEH,YAAAA;oBAAW;oBAEhDV,SAAiB;wBACrBZ,MAAM;wBACNM,OAAOe;oBACT;oBAEA;;wBAAO;4BACL6B,OAAO;gCACL;oCACElD,MAAM;oCACNmD,MAAMC,KAAKC,SAAS,CAACzC;gCACvB;;4BAEF0C,mBAAmB;gCAAE1C,QAAAA;4BAAO;wBAC9B;;;oBACOW;oBACDC,UAAUD,AAAK,YAALA,OAAiBgC,SAAQhC,MAAMC,OAAO,GAAGgC,OAAOjC;oBAChEP,OAAOO,KAAK,CAAC,2BAA2B;wBAAEA,OAAOC;oBAAQ;oBAEzD,MAAM,IAAIiC,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE,AAAC,yBAAgC,OAARnC,UAAW;wBAC9EoC,OAAOrC,AAAK,YAALA,OAAiBgC,SAAQhC,MAAMqC,KAAK,GAAGC;oBAChD;;;;;;;IAEJ;;AAEe,SAASvE;IACtB,OAAO;QACLS,MAAM;QACNW,QAAAA;QACAG,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/tools/message-get.d.cts

@@ -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/cjs/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 {};