@mcp-z/mcp-gmail 1.0.0

package/dist/cjs/mcp/tools/label-add.js

@@ -0,0 +1,280 @@
+"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");
+var _gmaillabels = require("../../labels/gmail-labels.js");
+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;
+var inputSchema = _zod.z.object({
+    id: _zod.z.coerce.string().trim().min(1).describe('Gmail message ID to add label to'),
+    label: _zod.z.coerce.string().trim().min(1).describe('Label name or ID (use gmail-labels-list to discover available labels)')
+});
+// Success branch schema
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    item: _zod.z.object({
+        id: _zod.z.string().describe('Message ID the label was added to'),
+        label: _zod.z.string().describe('Label that was added')
+    })
+});
+// Output schema with auth_required support
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Add a label to a Gmail message',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, label, logger, gmail, labelId, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, label = param.label;
+                    logger = extra.logger;
+                    logger.info('gmail.label.add called', {
+                        id: id,
+                        label: label
+                    });
+                    if (!id || !label) {
+                        logger.info('gmail.label.add missing parameters', {
+                            id: id,
+                            label: label
+                        });
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Missing id or label');
+                    }
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        4,
+                        ,
+                        5
+                    ]);
+                    gmail = _googleapis.google.gmail({
+                        version: 'v1',
+                        auth: extra.authContext.auth
+                    });
+                    return [
+                        4,
+                        (0, _gmaillabels.ensureLabelId)(gmail, 'me', label)
+                    ];
+                case 2:
+                    labelId = _state.sent();
+                    return [
+                        4,
+                        gmail.users.messages.modify({
+                            userId: 'me',
+                            id: id,
+                            requestBody: {
+                                addLabelIds: [
+                                    labelId
+                                ]
+                            }
+                        })
+                    ];
+                case 3:
+                    _state.sent();
+                    logger.info('gmail.label.add success', {
+                        id: id,
+                        label: label
+                    });
+                    logger.info('gmail.label.add result (typed)', {
+                        id: id,
+                        label: label
+                    });
+                    result = {
+                        type: 'success',
+                        item: {
+                            id: id,
+                            label: label
+                        }
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 4:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('gmail.label.add error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error adding label to message: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 5:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'label-add',
+        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/label-add.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/label-add.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 { ensureLabelId } from '../../labels/gmail-labels.js';\n\nconst inputSchema = z.object({\n  id: z.coerce.string().trim().min(1).describe('Gmail message ID to add label to'),\n  label: z.coerce.string().trim().min(1).describe('Label name or ID (use gmail-labels-list to discover available labels)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  item: z.object({\n    id: z.string().describe('Message ID the label was added to'),\n    label: z.string().describe('Label that was added'),\n  }),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add a label to a Gmail message',\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, label }: Input, extra: EnrichedExtra) {\n  const logger = extra.logger;\n  logger.info('gmail.label.add called', { id, label });\n\n  if (!id || !label) {\n    logger.info('gmail.label.add missing parameters', { id, label });\n    throw new McpError(ErrorCode.InvalidParams, 'Missing id or label');\n  }\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    const labelId = await ensureLabelId(gmail, 'me', label);\n    await gmail.users.messages.modify({\n      userId: 'me',\n      id: id,\n      requestBody: {\n        addLabelIds: [labelId],\n      },\n    });\n\n    logger.info('gmail.label.add success', { id, label });\n    logger.info('gmail.label.add result (typed)', { id, label });\n\n    const result: Output = {\n      type: 'success' as const,\n      item: { id, label },\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.add error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error adding label to message: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'label-add',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","coerce","string","trim","min","describe","label","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","gmail","labelId","error","message","info","McpError","ErrorCode","InvalidParams","google","version","auth","authContext","ensureLabelId","users","messages","modify","userId","requestBody","addLabelIds","content","text","JSON","stringify","structuredContent","Error","String","InternalError","stack","undefined","name"],"mappings":";;;;+BAuFA;;;eAAwBA;;;2BAtFA;qBAKY;0BACb;mBACL;2BACY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAN9B,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAQR,IAAME,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,IAAIF,MAAC,CAACG,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAC7CC,OAAOR,MAAC,CAACG,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,IAAME,sBAAsBT,MAAC,CAACC,MAAM,CAAC;IACnCS,MAAMV,MAAC,CAACW,OAAO,CAAC;IAChBC,MAAMZ,MAAC,CAACC,MAAM,CAAC;QACbC,IAAIF,MAAC,CAACI,MAAM,GAAGG,QAAQ,CAAC;QACxBC,OAAOR,MAAC,CAACI,MAAM,GAAGG,QAAQ,CAAC;IAC7B;AACF;AAEA,2CAA2C;AAC3C,IAAMM,eAAeb,MAAC,CAACc,kBAAkB,CAAC,QAAQ;IAACL;IAAqBZ;CAAyB;AAEjG,IAAMkB,SAAS;IACbC,aAAa;IACbjB,aAAaA;IACbc,cAAcb,MAAC,CAACC,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAAoB,EAAEC,KAAoB;YAAxCjB,IAAIM,OACrBY,QASEC,OAEAC,SAYAL,QAcCM,OACDC;;;;oBAvCetB,KAAF,MAAEA,IAAIM,QAAN,MAAMA;oBACrBY,SAASD,MAAMC,MAAM;oBAC3BA,OAAOK,IAAI,CAAC,0BAA0B;wBAAEvB,IAAAA;wBAAIM,OAAAA;oBAAM;oBAElD,IAAI,CAACN,MAAM,CAACM,OAAO;wBACjBY,OAAOK,IAAI,CAAC,sCAAsC;4BAAEvB,IAAAA;4BAAIM,OAAAA;wBAAM;wBAC9D,MAAM,IAAIkB,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE;oBAC9C;;;;;;;;;oBAGQP,QAAQQ,kBAAM,CAACR,KAAK,CAAC;wBAAES,SAAS;wBAAMC,MAAMZ,MAAMa,WAAW,CAACD,IAAI;oBAAC;oBAEzD;;wBAAME,IAAAA,0BAAa,EAACZ,OAAO,MAAMb;;;oBAA3Cc,UAAU;oBAChB;;wBAAMD,MAAMa,KAAK,CAACC,QAAQ,CAACC,MAAM,CAAC;4BAChCC,QAAQ;4BACRnC,IAAIA;4BACJoC,aAAa;gCACXC,WAAW;oCAAGjB;;4BAChB;wBACF;;;oBANA;oBAQAF,OAAOK,IAAI,CAAC,2BAA2B;wBAAEvB,IAAAA;wBAAIM,OAAAA;oBAAM;oBACnDY,OAAOK,IAAI,CAAC,kCAAkC;wBAAEvB,IAAAA;wBAAIM,OAAAA;oBAAM;oBAEpDS,SAAiB;wBACrBP,MAAM;wBACNE,MAAM;4BAAEV,IAAAA;4BAAIM,OAAAA;wBAAM;oBACpB;oBAEA;;wBAAO;4BACLgC,OAAO;gCACL;oCACE9B,MAAM;oCACN+B,MAAMC,KAAKC,SAAS,CAAC1B;gCACvB;;4BAEF2B,mBAAmB;gCAAE3B,QAAAA;4BAAO;wBAC9B;;;oBACOM;oBACDC,UAAUD,AAAK,YAALA,OAAiBsB,SAAQtB,MAAMC,OAAO,GAAGsB,OAAOvB;oBAChEH,OAAOG,KAAK,CAAC,yBAAyB;wBAAEA,OAAOC;oBAAQ;oBAEvD,MAAM,IAAIE,eAAQ,CAACC,gBAAS,CAACoB,aAAa,EAAE,AAAC,kCAAyC,OAARvB,UAAW;wBACvFwB,OAAOzB,AAAK,YAALA,OAAiBsB,SAAQtB,MAAMyB,KAAK,GAAGC;oBAChD;;;;;;;IAEJ;;AAEe,SAASrD;IACtB,OAAO;QACLsD,MAAM;QACNnC,QAAAA;QACAG,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/tools/label-delete.d.cts

@@ -0,0 +1,71 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, 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({ ids }: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            totalRequested: number;
+            successCount: number;
+            failureCount: number;
+            results: {
+                id: string;
+                success: boolean;
+                error?: string;
+            }[];
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.";
+        readonly inputSchema: z.ZodObject<{
+            ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                totalRequested: z.ZodNumber;
+                successCount: z.ZodNumber;
+                failureCount: z.ZodNumber;
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    success: z.ZodBoolean;
+                    error: z.ZodOptional<z.ZodString>;
+                }, 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/label-delete.d.ts

@@ -0,0 +1,71 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    totalRequested: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, 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({ ids }: Input, extra: EnrichedExtra): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        result: {
+            type: "success";
+            totalRequested: number;
+            successCount: number;
+            failureCount: number;
+            results: {
+                id: string;
+                success: boolean;
+                error?: string;
+            }[];
+        };
+    };
+}>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Delete Gmail labels permanently (irreversible). System labels (INBOX, SENT, etc.) cannot be deleted.";
+        readonly inputSchema: z.ZodObject<{
+            ids: z.ZodArray<z.ZodCoercedString<unknown>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                totalRequested: z.ZodNumber;
+                successCount: z.ZodNumber;
+                failureCount: z.ZodNumber;
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    success: z.ZodBoolean;
+                    error: z.ZodOptional<z.ZodString>;
+                }, 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 {};