@softeria/ms-365-mcp-server 0.26.0 → 0.27.1

package/README.md

@@ -308,13 +308,13 @@ registration:
 4. **Get Credentials**:
 
 - Copy the **Application (client) ID** from Overview page
-- Go to Certificates & secrets → New client secret → Copy the secret value
+- Go to Certificates & secrets → New client secret → Copy the secret value (optional for public apps)
 
 5. **Configure Environment Variables**:
    Create a `.env` file in your project root:
    ```env
    MS365_MCP_CLIENT_ID=your-azure-ad-app-client-id-here
-   MS365_MCP_CLIENT_SECRET=your-azure-ad-app-client-secret-here
+   MS365_MCP_CLIENT_SECRET=your-secret-here  # Optional for public apps
    MS365_MCP_TENANT_ID=common
    ```
 
@@ -340,6 +340,19 @@ This method:
 > **Authentication Tools**: In HTTP mode, login/logout tools are disabled by default since OAuth handles authentication.
 > Use `--enable-auth-tools` if you need them available.
 
+## Tool Presets
+
+To reduce initial connection overhead, use preset tool categories instead of loading all 90+ tools:
+
+```bash
+npx @softeria/ms-365-mcp-server --preset mail
+npx @softeria/ms-365-mcp-server --list-presets  # See all available presets
+```
+
+Available presets: `mail`, `calendar`, `files`, `personal`, `work`, `excel`, `contacts`, `tasks`, `onenote`, `search`, `users`, `all`
+
+**Experimental:** `--discovery` starts with only 2 tools (`search-tools`, `execute-tool`) for minimal token usage.
+
 ## CLI Options
 
 The following options can be used when running ms-365-mcp-server directly from the command line:
@@ -364,7 +377,10 @@ When running as an MCP server, the following options can be used:
                   Starts Express.js server with MCP endpoint at /mcp
 --enable-auth-tools Enable login/logout tools when using HTTP mode (disabled by default in HTTP mode)
 --enabled-tools <pattern> Filter tools using regex pattern (e.g., "excel|contact" to enable Excel and Contact tools)
+--preset <names>  Use preset tool categories (comma-separated). See "Tool Presets" section above
+--list-presets    List all available presets and exit
 --toon            (experimental) Enable TOON output format for 30-60% token reduction
+--discovery       (experimental) Start with search-tools + execute-tool only
 ```
 
 Environment variables:

package/bin/modules/generate-mcp-tools.mjs

@@ -33,6 +33,10 @@ export function generateMcpTools(openApiSpec, outputDir) {
       (match) => match.replace(/\.strict\(\);/, '.passthrough();')
     );
 
+    console.log('Stripping unused errors arrays from endpoint definitions...');
+    // I didn't make up this crazy regex myself; you know who did. It seems works though.
+    clientCode = clientCode.replace(/,?\s*errors:\s*\[[\s\S]*?],?(?=\s*})/g, '');
+
     fs.writeFileSync(clientFilePath, clientCode);
 
     return true;

package/dist/cli.js

@@ -2,6 +2,7 @@ import { Command } from "commander";
 import { readFileSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import { getCombinedPresetPattern, listPresets, presetRequiresOrgMode } from "./tool-categories.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageJsonPath = path.join(__dirname, "..", "package.json");
 const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
@@ -17,12 +18,35 @@ program.name("ms-365-mcp-server").description("Microsoft 365 MCP Server").versio
   "--enabled-tools <pattern>",
   'Filter tools using regex pattern (e.g., "excel|contact" to enable Excel and Contact tools)'
 ).option(
+  "--preset <names>",
+  "Use preset tool categories (comma-separated). Available: mail, calendar, files, personal, work, excel, contacts, tasks, onenote, search, users, all"
+).option("--list-presets", "List all available presets and exit").option(
   "--org-mode",
   "Enable organization/work mode from start (includes Teams, SharePoint, etc.)"
-).option("--work-mode", "Alias for --org-mode").option("--force-work-scopes", "Backwards compatibility alias for --org-mode (deprecated)").option("--toon", "(experimental) Enable TOON output format for 30-60% token reduction");
+).option("--work-mode", "Alias for --org-mode").option("--force-work-scopes", "Backwards compatibility alias for --org-mode (deprecated)").option("--toon", "(experimental) Enable TOON output format for 30-60% token reduction").option("--discovery", "Enable runtime tool discovery and loading (experimental feature)");
 function parseArgs() {
   program.parse();
   const options = program.opts();
+  if (options.listPresets) {
+    const presets = listPresets();
+    console.log(JSON.stringify({ presets }, null, 2));
+    process.exit(0);
+  }
+  if (options.preset) {
+    const presetNames = options.preset.split(",").map((p) => p.trim());
+    try {
+      options.enabledTools = getCombinedPresetPattern(presetNames);
+      const requiresOrgMode = presetNames.some((preset) => presetRequiresOrgMode(preset));
+      if (requiresOrgMode && !options.orgMode) {
+        console.warn(
+          `Warning: Preset(s) [${presetNames.filter((p) => presetRequiresOrgMode(p)).join(", ")}] require --org-mode to function properly`
+        );
+      }
+    } catch (error) {
+      console.error(`Error: ${error.message}`);
+      process.exit(1);
+    }
+  }
   if (process.env.READ_ONLY === "true" || process.env.READ_ONLY === "1") {
     options.readOnly = true;
   }