@mcp-z/mcp-gmail 1.0.0

package/dist/cjs/schemas/gmail-query-schema.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "GmailQuerySchema", {
+    enumerable: true,
+    get: function() {
+        return GmailQuerySchema;
+    }
+});
+var _email = require("@mcp-z/email");
+var _zod = require("zod");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+var GmailQuerySchema = _zod.z.lazy(function() {
+    return _zod.z.object(_object_spread_props(_object_spread({
+        // Logical operators for combining conditions (recursive)
+        $and: _zod.z.array(GmailQuerySchema).optional().describe('Array of conditions that must ALL match'),
+        $or: _zod.z.array(GmailQuerySchema).optional().describe('Array of conditions where ANY must match'),
+        $not: GmailQuerySchema.optional().describe('Nested condition that must NOT match')
+    }, _email.baseEmailQueryFields), {
+        // Gmail-specific features
+        // Fuzzy phrase matching - Gmail's approximate search using quoted strings
+        fuzzyPhrase: _zod.z.string().min(1).optional().describe('Fuzzy phrase matching - words should appear together (approximate matching). Gmail uses relevance-based matching.'),
+        // Gmail system categories with field operator support
+        categories: _zod.z.union([
+            _zod.z.enum([
+                'primary',
+                'social',
+                'promotions',
+                'updates',
+                'forums'
+            ]),
+            _zod.z.object({
+                $any: _zod.z.array(_zod.z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional(),
+                $all: _zod.z.array(_zod.z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional(),
+                $none: _zod.z.array(_zod.z.enum([
+                    'primary',
+                    'social',
+                    'promotions',
+                    'updates',
+                    'forums'
+                ])).optional()
+            }).strict()
+        ]).optional().describe('Filter by Gmail system categories (primary, social, promotions, updates, forums)'),
+        // User-created labels
+        label: _zod.z.union([
+            _zod.z.string().min(1),
+            _email.FieldOperatorSchema
+        ]).optional().describe('Filter by user-created labels (case-sensitive). Use gmail-labels-list to see available labels'),
+        // Raw Gmail query string - escape hatch for advanced syntax
+        rawGmailQuery: _zod.z.string().min(1).optional().describe('Raw Gmail query syntax for advanced use cases. Bypasses schema validation - use sparingly.')
+    })).strict();
+});
+/* 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/schemas/gmail-query-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/schemas/gmail-query-schema.ts"],"sourcesContent":["import { type BaseEmailQueryFields, baseEmailQueryFields, type FieldOperator, FieldOperatorSchema } from '@mcp-z/email';\nimport { z } from 'zod';\n\n/**\n * Gmail-specific query schema with recursive operators and Gmail features.\n *\n * Includes Gmail-specific features:\n * - fuzzyPhrase: Approximate phrase matching (Gmail's quoted string behavior with relevance ranking)\n * - categories: Gmail system categories (primary, social, promotions, updates, forums)\n * - label: User-created Gmail labels (case-sensitive, discovered via gmail-labels-list)\n * - rawGmailQuery: Escape hatch for advanced Gmail query syntax\n *\n * Plus all base fields from baseEmailQueryFields:\n * - Email addresses: from, to, cc, bcc (support string or field operators)\n * - Content: subject, body, text\n * - Flags: hasAttachment, isRead\n * - Date range: date { $gte, $lt }\n * - Logical operators: $and, $or, $not (recursive)\n *\n * Note: Cast through unknown to work around Zod's lazy schema type inference issue\n * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures\n * TypeScript sees the strict GmailQuery type everywhere the schema is used.\n */\nexport const GmailQuerySchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(GmailQuerySchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(GmailQuerySchema).optional().describe('Array of conditions where ANY must match'),\n      $not: GmailQuerySchema.optional().describe('Nested condition that must NOT match'),\n\n      // Spread base email query fields (from, to, subject, body, etc.)\n      ...baseEmailQueryFields,\n\n      // Gmail-specific features\n\n      // Fuzzy phrase matching - Gmail's approximate search using quoted strings\n      fuzzyPhrase: z.string().min(1).optional().describe('Fuzzy phrase matching - words should appear together (approximate matching). Gmail uses relevance-based matching.'),\n\n      // Gmail system categories with field operator support\n      categories: z\n        .union([\n          z.enum(['primary', 'social', 'promotions', 'updates', 'forums']),\n          z\n            .object({\n              $any: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n              $all: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n              $none: z.array(z.enum(['primary', 'social', 'promotions', 'updates', 'forums'])).optional(),\n            })\n            .strict(),\n        ])\n        .optional()\n        .describe('Filter by Gmail system categories (primary, social, promotions, updates, forums)'),\n\n      // User-created labels\n      label: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by user-created labels (case-sensitive). Use gmail-labels-list to see available labels'),\n\n      // Raw Gmail query string - escape hatch for advanced syntax\n      rawGmailQuery: z.string().min(1).optional().describe('Raw Gmail query syntax for advanced use cases. Bypasses schema validation - use sparingly.'),\n    })\n    .strict()\n) as unknown as z.ZodType<GmailQuery>;\n\nexport type GmailQuery = BaseEmailQueryFields & {\n  $and?: GmailQuery[];\n  $or?: GmailQuery[];\n  $not?: GmailQuery;\n  fuzzyPhrase?: string;\n  categories?:\n    | 'primary'\n    | 'social'\n    | 'promotions'\n    | 'updates'\n    | 'forums'\n    | {\n        $any?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n        $all?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n        $none?: ('primary' | 'social' | 'promotions' | 'updates' | 'forums')[];\n      };\n  label?: string | FieldOperator;\n  rawGmailQuery?: string;\n};\n"],"names":["GmailQuerySchema","z","lazy","object","$and","array","optional","describe","$or","$not","baseEmailQueryFields","fuzzyPhrase","string","min","categories","union","enum","$any","$all","$none","strict","label","FieldOperatorSchema","rawGmailQuery"],"mappings":";;;;+BAuBaA;;;eAAAA;;;qBAvB4F;mBACvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBX,IAAMA,mBAAmBC,MAAC,CAACC,IAAI,CAAC;WACrCD,MAAC,CACEE,MAAM,CAAC;QACN,yDAAyD;QACzDC,MAAMH,MAAC,CAACI,KAAK,CAACL,kBAAkBM,QAAQ,GAAGC,QAAQ,CAAC;QACpDC,KAAKP,MAAC,CAACI,KAAK,CAACL,kBAAkBM,QAAQ,GAAGC,QAAQ,CAAC;QACnDE,MAAMT,iBAAiBM,QAAQ,GAAGC,QAAQ,CAAC;OAGxCG,2BAAoB;QAEvB,0BAA0B;QAE1B,0EAA0E;QAC1EC,aAAaV,MAAC,CAACW,MAAM,GAAGC,GAAG,CAAC,GAAGP,QAAQ,GAAGC,QAAQ,CAAC;QAEnD,sDAAsD;QACtDO,YAAYb,MAAC,CACVc,KAAK,CAAC;YACLd,MAAC,CAACe,IAAI,CAAC;gBAAC;gBAAW;gBAAU;gBAAc;gBAAW;aAAS;YAC/Df,MAAC,CACEE,MAAM,CAAC;gBACNc,MAAMhB,MAAC,CAACI,KAAK,CAACJ,MAAC,CAACe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGV,QAAQ;gBACxFY,MAAMjB,MAAC,CAACI,KAAK,CAACJ,MAAC,CAACe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGV,QAAQ;gBACxFa,OAAOlB,MAAC,CAACI,KAAK,CAACJ,MAAC,CAACe,IAAI,CAAC;oBAAC;oBAAW;oBAAU;oBAAc;oBAAW;iBAAS,GAAGV,QAAQ;YAC3F,GACCc,MAAM;SACV,EACAd,QAAQ,GACRC,QAAQ,CAAC;QAEZ,sBAAsB;QACtBc,OAAOpB,MAAC,CACLc,KAAK,CAAC;YAACd,MAAC,CAACW,MAAM,GAAGC,GAAG,CAAC;YAAIS,0BAAmB;SAAC,EAC9ChB,QAAQ,GACRC,QAAQ,CAAC;QAEZ,4DAA4D;QAC5DgB,eAAetB,MAAC,CAACW,MAAM,GAAGC,GAAG,CAAC,GAAGP,QAAQ,GAAGC,QAAQ,CAAC;QAEtDa,MAAM"}

package/dist/cjs/schemas/index.d.cts

@@ -0,0 +1 @@
+export * from './gmail-query-schema.js';

package/dist/cjs/schemas/index.d.ts

@@ -0,0 +1 @@
+export * from './gmail-query-schema.js';

package/dist/cjs/schemas/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./gmail-query-schema.js"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+/* 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/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/schemas/index.ts"],"sourcesContent":["export * from './gmail-query-schema.js';\n"],"names":[],"mappings":";;;;qBAAc"}

package/dist/cjs/setup/config.d.cts

@@ -0,0 +1,48 @@
+import type { ServerConfig } from '../types.js';
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */
+export declare function handleVersionHelp(args: string[]): {
+    handled: boolean;
+    output?: string;
+};
+/**
+ * Parse Gmail server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)
+ * - --base-url=<url>       Base URL for HTTP file serving (optional)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ * - STORAGE_DIR            Default storage directory (optional)
+ * - BASE_URL               Default base URL for file serving (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
+ */
+export declare function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig;
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */
+export declare function createConfig(): ServerConfig;

package/dist/cjs/setup/config.d.ts

@@ -0,0 +1,48 @@
+import type { ServerConfig } from '../types.js';
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */
+export declare function handleVersionHelp(args: string[]): {
+    handled: boolean;
+    output?: string;
+};
+/**
+ * Parse Gmail server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)
+ * - --base-url=<url>       Base URL for HTTP file serving (optional)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ * - STORAGE_DIR            Default storage directory (optional)
+ * - BASE_URL               Default base URL for file serving (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
+ */
+export declare function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig;
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */
+export declare function createConfig(): ServerConfig;

package/dist/cjs/setup/config.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get createConfig () {
+        return createConfig;
+    },
+    get handleVersionHelp () {
+        return handleVersionHelp;
+    },
+    get parseConfig () {
+        return parseConfig;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _server = require("@mcp-z/server");
+var _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
+var _modulerootsync = /*#__PURE__*/ _interop_require_default(require("module-root-sync"));
+var _os = require("os");
+var _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+var _url = /*#__PURE__*/ _interop_require_wildcard(require("url"));
+var _util = require("util");
+var _constantsts = require("../constants.js");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+var pkg = JSON.parse(_fs.readFileSync(_path.join((0, _modulerootsync.default)(_url.fileURLToPath(require("url").pathToFileURL(__filename).toString())), 'package.json'), 'utf-8'));
+var HELP_TEXT = "\nUsage: mcp-gmail [options]\n\nMCP server for Gmail email management with OAuth authentication.\n\nOptions:\n  --version              Show version number\n  --help                 Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  STORAGE_DIR            Default storage directory (optional)\n  BASE_URL               Default base URL for file serving (optional)\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n\nExamples:\n  mcp-gmail                           # Use default settings\n  mcp-gmail --auth=service-account    # Use service account auth\n  mcp-gmail --port=3000               # HTTP transport on port 3000\n  mcp-gmail --storage-dir=./emails    # Custom storage directory\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n".trim();
+function handleVersionHelp(args) {
+    var values = (0, _util.parseArgs)({
+        args: args,
+        options: {
+            version: {
+                type: 'boolean'
+            },
+            help: {
+                type: 'boolean'
+            }
+        },
+        strict: false
+    }).values;
+    if (values.version) return {
+        handled: true,
+        output: pkg.version
+    };
+    if (values.help) return {
+        handled: true,
+        output: HELP_TEXT
+    };
+    return {
+        handled: false
+    };
+}
+function parseConfig(args, env) {
+    var _ref, _ref1, _ref2;
+    var transportConfig = (0, _server.parseConfig)(args, env);
+    var oauthConfig = (0, _oauthgoogle.parseConfig)(args, env);
+    // Parse DCR configuration if DCR mode is enabled
+    var dcrConfig = oauthConfig.auth === 'dcr' ? (0, _oauthgoogle.parseDcrConfig)(args, env, _constantsts.GOOGLE_SCOPE) : undefined;
+    // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)
+    var values = (0, _util.parseArgs)({
+        args: args,
+        options: {
+            'log-level': {
+                type: 'string'
+            },
+            'storage-dir': {
+                type: 'string'
+            },
+            'base-url': {
+                type: 'string'
+            }
+        },
+        strict: false,
+        allowPositionals: true
+    }).values;
+    var name = pkg.name.replace(/^@[^/]+\//, '');
+    // Parse repository URL from package.json, stripping git+ prefix and .git suffix
+    var rawRepoUrl = _type_of(pkg.repository) === 'object' ? pkg.repository.url : pkg.repository;
+    var repositoryUrl = (_ref = rawRepoUrl === null || rawRepoUrl === void 0 ? void 0 : rawRepoUrl.replace(/^git\+/, '').replace(/\.git$/, '')) !== null && _ref !== void 0 ? _ref : "https://github.com/mcp-z/".concat(name);
+    var rootDir = process.cwd() === '/' ? (0, _os.homedir)() : process.cwd();
+    var baseDir = _path.join(rootDir, '.mcp-z');
+    var cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;
+    var envLogLevel = env.LOG_LEVEL;
+    var logLevel = (_ref1 = cliLogLevel !== null && cliLogLevel !== void 0 ? cliLogLevel : envLogLevel) !== null && _ref1 !== void 0 ? _ref1 : 'info';
+    // Parse storage configuration
+    var cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;
+    var envStorageDir = env.STORAGE_DIR;
+    var storageDir = (_ref2 = cliStorageDir !== null && cliStorageDir !== void 0 ? cliStorageDir : envStorageDir) !== null && _ref2 !== void 0 ? _ref2 : _path.join(baseDir, name, 'files');
+    if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, (0, _os.homedir)());
+    var cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;
+    var envBaseUrl = env.BASE_URL;
+    var baseUrl = cliBaseUrl !== null && cliBaseUrl !== void 0 ? cliBaseUrl : envBaseUrl;
+    // Combine configs
+    var result = _object_spread_props(_object_spread({}, oauthConfig), {
+        transport: transportConfig.transport,
+        logLevel: logLevel,
+        baseDir: baseDir,
+        name: name,
+        version: pkg.version,
+        repositoryUrl: repositoryUrl,
+        storageDir: _path.resolve(storageDir)
+    });
+    if (baseUrl) result.baseUrl = baseUrl;
+    if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;
+    return result;
+}
+function createConfig() {
+    return parseConfig(process.argv, process.env);
+}
+/* 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/setup/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { parseConfig as parseTransportConfig } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.js';\n\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-gmail [options]\n\nMCP server for Gmail email management with OAuth authentication.\n\nOptions:\n  --version              Show version number\n  --help                 Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  STORAGE_DIR            Default storage directory (optional)\n  BASE_URL               Default base URL for file serving (optional)\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n\nExamples:\n  mcp-gmail                           # Use default settings\n  mcp-gmail --auth=service-account    # Use service account auth\n  mcp-gmail --port=3000               # HTTP transport on port 3000\n  mcp-gmail --storage-dir=./emails    # Custom storage directory\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n`.trim();\n\n/**\n * Handle --version and --help flags before config parsing.\n * These should work without requiring any configuration.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n\n/**\n * Parse Gmail server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - STORAGE_DIR            Default storage directory (optional)\n * - BASE_URL               Default base URL for file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const transportConfig = parseTransportConfig(args, env);\n  const oauthConfig = parseOAuthConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'storage-dir': { type: 'string' },\n      'base-url': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  const rootDir = process.cwd() === '/' ? homedir() : process.cwd();\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;\n  const envStorageDir = env.STORAGE_DIR;\n  let storageDir = cliStorageDir ?? envStorageDir ?? path.join(baseDir, name, 'files');\n  if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, homedir());\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  const result: ServerConfig = {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri, serviceAccountKeyFile\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    storageDir: path.resolve(storageDir),\n  };\n  if (baseUrl) result.baseUrl = baseUrl;\n  if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;\n  return result;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["createConfig","handleVersionHelp","parseConfig","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","help","strict","handled","output","env","cliLogLevel","cliStorageDir","transportConfig","parseTransportConfig","oauthConfig","parseOAuthConfig","dcrConfig","auth","parseDcrConfig","GOOGLE_SCOPE","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","process","cwd","homedir","baseDir","envLogLevel","LOG_LEVEL","logLevel","envStorageDir","STORAGE_DIR","storageDir","startsWith","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","resolve","argv"],"mappings":"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"}

package/dist/cjs/setup/http.d.cts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RuntimeOverrides, ServerConfig } from '../types.js';
+export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
+    httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    mcpServer: McpServer;
+    logger: import("@mcp-z/server").Logger;
+    close: () => Promise<void>;
+}>;

package/dist/cjs/setup/http.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RuntimeOverrides, ServerConfig } from '../types.js';
+export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
+    httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    mcpServer: McpServer;
+    logger: import("@mcp-z/server").Logger;
+    close: () => Promise<void>;
+}>;