@mcp-z/mcp-outlook 1.1.0 → 1.1.2

package/README.md

@@ -1,7 +1,6 @@
 # @mcp-z/mcp-outlook
 
-Docs: https://mcp-z.github.io/mcp-outlook
-Outlook MCP server for searching, reading, and sending Microsoft 365 mail.
+Docs: https://mcp-z.github.io/mcp-outlook Outlook MCP server for searching, reading, and sending Microsoft 365 mail.
 
 ## Common uses
 
@@ -106,8 +105,7 @@ Example (http) - Create .mcp.json:
 }
 ```
 
-Local (default): omit REDIRECT_URI → ephemeral loopback.
-Cloud: set REDIRECT_URI to your public /oauth/callback and expose the service publicly.
+Local (default): omit REDIRECT_URI → ephemeral loopback. Cloud: set REDIRECT_URI to your public /oauth/callback and expose the service publicly.
 
 Note: start block is a helper in "npx @mcp-z/cli up" for starting an http server from your .mpc.json. See [@mcp-z/cli](https://github.com/mcp-z/cli) for details.
 
@@ -132,8 +130,7 @@ Useful for headless or remote environments.
 
 ### DCR (self-hosted)
 
-HTTP only. Requires a public base URL.
-CSV export and `/files` are disabled in DCR mode; `resourceStoreUri` is ignored.
+HTTP only. Requires a public base URL. CSV export and `/files` are disabled in DCR mode; `resourceStoreUri` is ignored.
 
 ```json
 {
@@ -193,3 +190,19 @@ mcp-z call outlook message-search '{"query":"from:alice@example.com"}'
 ## Configuration reference
 
 See `server.json` for all supported environment variables, CLI arguments, and defaults.
+
+## Storage backends
+
+OAuth tokens (`TOKEN_STORE_URI`) and DCR registrations (`DCR_STORE_URI`) are stored through [keyv-registry](https://www.npmjs.com/package/keyv-registry), which picks an adapter from the URI protocol.
+
+`file://` (the default, under `~/.mcp-z/`) and `memory://` work with no extra setup.
+
+Any other backend needs its adapter installed alongside this server. Adapters are resolved with `require()`, so a globally installed server finds a globally installed adapter:
+
+```bash
+npm install -g @mcp-z/mcp-outlook @keyv/redis
+
+TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook
+```
+
+A protocol whose adapter is missing fails at startup naming the package to install.

package/dist/cjs/lib/create-store.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "default", {
+Object.defineProperty(exports, // keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry
+// loads adapters with require() rather than depending on any of them itself.
+"default", {
     enumerable: true,
     get: function() {
         return createStore;

package/dist/cjs/lib/create-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["createStore","uri","store","keyvRegistry","Error"],"mappings":";;;;+BAGA;;;eAA8BA;;;mEAFL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEV,SAAeA,YAAeC,GAAW;;YAChDC;;;;oBAAQ;;wBAAMC,IAAAA,qBAAY,EAAIF;;;oBAA9BC,QAAQ;oBACd,IAAI,CAACA,OAAO,MAAM,IAAIE,MAAM,AAAC,mCAAsC,OAAJH;oBAC/D;;wBAAOC;;;;IACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["createStore","uri","store","keyvRegistry","Error"],"mappings":";;;;+BAGA,sFAAsF;AACtF,6EAA6E;AAE7E;;;eAA8BA;;;mEALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKV,SAAeA,YAAeC,GAAW;;YAChDC;;;;oBAAQ;;wBAAMC,IAAAA,qBAAY,EAAIF;;;oBAA9BC,QAAQ;oBACd,IAAI,CAACA,OAAO,MAAM,IAAIE,MAAM,AAAC,mCAAsC,OAAJH;oBAC/D;;wBAAOC;;;;IACT"}

package/dist/cjs/setup/version-help.d.cts

@@ -7,7 +7,7 @@ export declare function readPkg(): {
     };
 };
 /**
- * Handle --version/--help flags and the `version` subcommand before config parsing.
+ * Handle --version/--help flags before config parsing.
  * These must work without requiring any configuration or heavy dependency.
  */
 export declare function handleVersionHelp(args: string[]): {

package/dist/cjs/setup/version-help.d.ts

@@ -7,7 +7,7 @@ export declare function readPkg(): {
     };
 };
 /**
- * Handle --version/--help flags and the `version` subcommand before config parsing.
+ * Handle --version/--help flags before config parsing.
  * These must work without requiring any configuration or heavy dependency.
  */
 export declare function handleVersionHelp(args: string[]): {

package/dist/cjs/setup/version-help.js

@@ -56,29 +56,31 @@ function _interop_require_wildcard(obj, nodeInterop) {
     if (cache) cache.set(obj, newObj);
     return newObj;
 }
-// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`/`version`
+// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`
 // resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft
 // and @mcp-z/server, which this path must not touch.
 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-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nCommands:\n  version                Show version number\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook version                   # Print version number\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n".trim();
+var HELP_TEXT = "\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nStorage Backends:\n  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n  file:// (the default) and memory:// work out of the box. Any other backend\n  needs its adapter installed alongside this server:\n    npm install -g @keyv/redis\n    TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n".trim();
 function readPkg() {
     return pkg;
 }
 function handleVersionHelp(args) {
-    var _parseArgs = (0, _util.parseArgs)({
+    var values = (0, _util.parseArgs)({
         args: args,
         options: {
             version: {
-                type: 'boolean'
+                type: 'boolean',
+                short: 'v'
             },
             help: {
-                type: 'boolean'
+                type: 'boolean',
+                short: 'h'
             }
         },
         strict: false,
         allowPositionals: true
-    }), values = _parseArgs.values, positionals = _parseArgs.positionals;
-    if (values.version || positionals[0] === 'version') return {
+    }).values;
+    if (values.version) return {
         handled: true,
         output: pkg.version
     };

package/dist/cjs/setup/version-help.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`/`version`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nCommands:\n  version                Show version number\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook version                   # Print version number\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags and the `version` subcommand before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values, positionals } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n    allowPositionals: true,\n  });\n\n  if (values.version || positionals[0] === 'version') return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n"],"names":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","parseArgs","options","version","type","help","strict","allowPositionals","values","positionals","handled","output"],"mappings":";;;;;;;;;;;QAyEgBA;eAAAA;;QARAC;eAAAA;;;0DAjEI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,6FAA6F;AAC7F,+FAA+F;AAC/F,qDAAqD;AACrD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,g1FAmDhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAgCC,aAAAA,IAAAA,eAAS,EAAC;QACxCD,MAAAA;QACAE,SAAS;YACPC,SAAS;gBAAEC,MAAM;YAAU;YAC3BC,MAAM;gBAAED,MAAM;YAAU;QAC1B;QACAE,QAAQ;QACRC,kBAAkB;IACpB,IARQC,SAAwBP,WAAxBO,QAAQC,cAAgBR,WAAhBQ;IAUhB,IAAID,OAAOL,OAAO,IAAIM,WAAW,CAAC,EAAE,KAAK,WAAW,OAAO;QAAEC,SAAS;QAAMC,QAAQvB,IAAIe,OAAO;IAAC;IAChG,IAAIK,OAAOH,IAAI,EAAE,OAAO;QAAEK,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nStorage Backends:\n  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n  file:// (the default) and memory:// work out of the box. Any other backend\n  needs its adapter installed alongside this server:\n    npm install -g @keyv/redis\n    TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean', short: 'v' },\n      help: { type: 'boolean', short: 'h' },\n    },\n    strict: false,\n    allowPositionals: true,\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"],"names":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":";;;;;;;;;;;QA4EgBA;eAAAA;;QARAC;eAAAA;;;0DApEI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,mFAAmF;AACnF,+FAA+F;AAC/F,qDAAqD;AACrD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,8gGAsDhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAM,AAAEC,SAAWC,IAAAA,eAAS,EAAC;QAC3BF,MAAAA;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB,GARQR;IAUR,IAAIA,OAAOG,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQvB,IAAIgB,OAAO;IAAC;IAChE,IAAIH,OAAOM,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}

package/dist/esm/lib/create-store.js

@@ -1,4 +1,6 @@
 import keyvRegistry from 'keyv-registry';
+// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry
+// loads adapters with require() rather than depending on any of them itself.
 export default async function createStore(uri) {
     const store = await keyvRegistry(uri);
     if (!store) throw new Error(`Failed to create store for URI: ${uri}`);

package/dist/esm/lib/create-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,sFAAsF;AACtF,6EAA6E;AAE7E,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}

package/dist/esm/setup/version-help.d.ts

@@ -7,7 +7,7 @@ export declare function readPkg(): {
     };
 };
 /**
- * Handle --version/--help flags and the `version` subcommand before config parsing.
+ * Handle --version/--help flags before config parsing.
  * These must work without requiring any configuration or heavy dependency.
  */
 export declare function handleVersionHelp(args: string[]): {

package/dist/esm/setup/version-help.js

@@ -3,7 +3,7 @@ import moduleRoot from 'module-root-sync';
 import * as path from 'path';
 import * as url from 'url';
 import { parseArgs } from 'util';
-// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`/`version`
+// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`
 // resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft
 // and @mcp-z/server, which this path must not touch.
 const pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));
@@ -29,9 +29,6 @@ Options:
   --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)
   --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)
 
-Commands:
-  version                Show version number
-
 Environment Variables:
   MS_CLIENT_ID           OAuth client ID (REQUIRED)
   MS_TENANT_ID           Microsoft tenant ID (REQUIRED)
@@ -47,12 +44,18 @@ Environment Variables:
   RESOURCE_STORE_URI            Resource store URI (optional, file://)
   BASE_URL               Base URL for HTTP file serving (optional)
 
+Storage Backends:
+  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.
+  file:// (the default) and memory:// work out of the box. Any other backend
+  needs its adapter installed alongside this server:
+    npm install -g @keyv/redis
+    TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook
+
 OAuth Scopes:
   openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite
 
 Examples:
   mcp-outlook                           # Use default settings
-  mcp-outlook version                   # Print version number
   mcp-outlook --auth=device-code        # Use device code auth
   mcp-outlook --port=3000               # HTTP transport on port 3000
   mcp-outlook --tenant-id=xxx           # Set tenant ID
@@ -63,23 +66,25 @@ Examples:
     return pkg;
 }
 /**
- * Handle --version/--help flags and the `version` subcommand before config parsing.
+ * Handle --version/--help flags before config parsing.
  * These must work without requiring any configuration or heavy dependency.
  */ export function handleVersionHelp(args) {
-    const { values, positionals } = parseArgs({
+    const { values } = parseArgs({
         args,
         options: {
             version: {
-                type: 'boolean'
+                type: 'boolean',
+                short: 'v'
             },
             help: {
-                type: 'boolean'
+                type: 'boolean',
+                short: 'h'
             }
         },
         strict: false,
         allowPositionals: true
     });
-    if (values.version || positionals[0] === 'version') return {
+    if (values.version) return {
         handled: true,
         output: pkg.version
     };

package/dist/esm/setup/version-help.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`/`version`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nCommands:\n  version                Show version number\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook version                   # Print version number\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags and the `version` subcommand before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values, positionals } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n    allowPositionals: true,\n  });\n\n  if (values.version || positionals[0] === 'version') return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n"],"names":["fs","moduleRoot","path","url","parseArgs","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","readPkg","handleVersionHelp","args","values","positionals","options","version","type","help","strict","allowPositionals","handled","output"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,OAAOC,gBAAgB,mBAAmB;AAC1C,YAAYC,UAAU,OAAO;AAC7B,YAAYC,SAAS,MAAM;AAC3B,SAASC,SAAS,QAAQ,OAAO;AAEjC,6FAA6F;AAC7F,+FAA+F;AAC/F,qDAAqD;AACrD,MAAMC,MAAMC,KAAKC,KAAK,CAACP,GAAGQ,YAAY,CAACN,KAAKO,IAAI,CAACR,WAAWE,IAAIO,aAAa,CAAC,YAAYP,GAAG,IAAI,iBAAiB;AAElH,MAAMQ,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnB,CAAC,CAACC,IAAI;AAEN,6EAA6E,GAC7E,OAAO,SAASC;IACd,OAAOR;AACT;AAEA;;;CAGC,GACD,OAAO,SAASS,kBAAkBC,IAAc;IAC9C,MAAM,EAAEC,MAAM,EAAEC,WAAW,EAAE,GAAGb,UAAU;QACxCW;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;YAAU;YAC3BC,MAAM;gBAAED,MAAM;YAAU;QAC1B;QACAE,QAAQ;QACRC,kBAAkB;IACpB;IAEA,IAAIP,OAAOG,OAAO,IAAIF,WAAW,CAAC,EAAE,KAAK,WAAW,OAAO;QAAEO,SAAS;QAAMC,QAAQpB,IAAIc,OAAO;IAAC;IAChG,IAAIH,OAAOK,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQd;IAAU;IAC3D,OAAO;QAAEa,SAAS;IAAM;AAC1B"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --tenant-id=<id>       Microsoft tenant ID (overrides MS_TENANT_ID env var)\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-outlook/files)\n  --base-url=<url>       Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n  MS_CLIENT_ID           OAuth client ID (REQUIRED)\n  MS_TENANT_ID           Microsoft tenant ID (REQUIRED)\n  MS_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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nStorage Backends:\n  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n  file:// (the default) and memory:// work out of the box. Any other backend\n  needs its adapter installed alongside this server:\n    npm install -g @keyv/redis\n    TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n  openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n  mcp-outlook                           # Use default settings\n  mcp-outlook --auth=device-code        # Use device code auth\n  mcp-outlook --port=3000               # HTTP transport on port 3000\n  mcp-outlook --tenant-id=xxx           # Set tenant ID\n  mcp-outlook --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  MS_CLIENT_ID=xxx mcp-outlook          # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean', short: 'v' },\n      help: { type: 'boolean', short: 'h' },\n    },\n    strict: false,\n    allowPositionals: true,\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"],"names":["fs","moduleRoot","path","url","parseArgs","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","readPkg","handleVersionHelp","args","values","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,OAAOC,gBAAgB,mBAAmB;AAC1C,YAAYC,UAAU,OAAO;AAC7B,YAAYC,SAAS,MAAM;AAC3B,SAASC,SAAS,QAAQ,OAAO;AAEjC,mFAAmF;AACnF,+FAA+F;AAC/F,qDAAqD;AACrD,MAAMC,MAAMC,KAAKC,KAAK,CAACP,GAAGQ,YAAY,CAACN,KAAKO,IAAI,CAACR,WAAWE,IAAIO,aAAa,CAAC,YAAYP,GAAG,IAAI,iBAAiB;AAElH,MAAMQ,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDnB,CAAC,CAACC,IAAI;AAEN,6EAA6E,GAC7E,OAAO,SAASC;IACd,OAAOR;AACT;AAEA;;;CAGC,GACD,OAAO,SAASS,kBAAkBC,IAAc;IAC9C,MAAM,EAAEC,MAAM,EAAE,GAAGZ,UAAU;QAC3BW;QACAE,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB;IAEA,IAAIP,OAAOE,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQpB,IAAIa,OAAO;IAAC;IAChE,IAAIF,OAAOK,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQd;IAAU;IAC3D,OAAO;QAAEa,SAAS;IAAM;AAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-z/mcp-outlook",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "MCP server for Outlook integration with OAuth authentication, message search, and batch operations",
   "keywords": [
     "outlook",
@@ -78,7 +78,8 @@
     "cors": "^2.0.0",
     "csv-stringify": "^6.0.0",
     "express": "^5.0.0",
-    "keyv-registry": "^1.0.0",
+    "keyv-file": "5.3.3",
+    "keyv-registry": "^2.0.0",
     "module-root-sync": "^2.0.0",
     "pino": "^10.0.0",
     "zod": "^4.0.0"
@@ -90,6 +91,7 @@
     "@types/mocha": "^10.0.10",
     "@types/node": "^26.2.0",
     "dotenv": "^17.2.3",
+    "fs-remove-compat": "^1.0.4",
     "get-port": "5.1.1",
     "keyv": "^5.0.0",
     "node-version-use": "^2.4.7",