@softeria/ms-365-mcp-server 0.95.0 → 0.96.0

package/bin/modules/simplified-openapi.mjs

@@ -8,24 +8,34 @@ export function createAndSaveSimplifiedOpenAPI(endpointsFile, openapiFile, opena
   const spec = fs.readFileSync(openapiFile, 'utf8');
   const openApiSpec = yaml.load(spec);
 
+  // Synthesize paths that the Graph REST API supports but are missing from
+  // Microsoft's published OpenAPI metadata (e.g. range(address='{address}')/format
+  // — documented in Excel API but not in the OpenAPI spec).
   for (const endpoint of endpoints) {
     if (!openApiSpec.paths[endpoint.pathPattern]) {
-      throw new Error(`Path "${endpoint.pathPattern}" not found in OpenAPI spec.`);
+      openApiSpec.paths[endpoint.pathPattern] = {};
     }
   }
 
-  // Synthesize operations that the Graph REST API supports but are missing from
-  // Microsoft's published OpenAPI metadata (e.g. PATCH on range(address='{address}')
-  // for cell-value writes — documented in Excel API but not in the OpenAPI spec).
+  // Synthesize operations on existing paths when the method is missing.
   for (const endpoint of endpoints) {
     const pathSpec = openApiSpec.paths[endpoint.pathPattern];
     const methodLower = endpoint.method.toLowerCase();
     if (pathSpec && !pathSpec[methodLower]) {
+      const pathParamMatches = [...endpoint.pathPattern.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+      const synthesizedParameters = pathParamMatches.map((paramName) => ({
+        name: paramName,
+        in: 'path',
+        required: true,
+        description: `Path parameter: ${paramName}`,
+        schema: { type: 'string' },
+      }));
       pathSpec[methodLower] = {
         tags: ['drives.driveItem'],
         summary: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
         description: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
         operationId: endpoint.toolName,
+        parameters: synthesizedParameters,
         requestBody:
           methodLower === 'get' || methodLower === 'delete'
             ? undefined

package/dist/endpoints.json

@@ -1,4 +1,11 @@
 [
+  {
+    "pathPattern": "/$batch",
+    "method": "post",
+    "toolName": "graph-batch",
+    "scopes": [],
+    "llmTip": "Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...)."
+  },
   {
     "pathPattern": "/me/messages",
     "method": "get",
@@ -593,11 +600,13 @@
     "scopes": ["Files.ReadWrite"]
   },
   {
-    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/format",
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
     "method": "patch",
     "toolName": "format-excel-range",
     "isExcelOp": true,
-    "scopes": ["Files.ReadWrite"]
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Apply font/fill/borders/alignment/wrapText/columnWidth/rowHeight to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { font: {bold,color,size,italic,name,underline}, fill: {color}, borders: [{sideIndex,style,color,weight}], horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }."
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",
@@ -614,6 +623,14 @@
     "scopes": ["Files.Read"],
     "skipEncoding": ["address"]
   },
+  {
+    "pathPattern": "/me/messages/{message-id}/$value",
+    "method": "get",
+    "toolName": "get-mail-message-mime",
+    "scopes": ["Mail.Read"],
+    "acceptType": "text/plain",
+    "llmTip": "Download an email message as raw RFC 5322 MIME content (.eml format). Use this when archiving an email to disk preserving all original headers, body, and inline-encoded attachments. Returns the MIME stream as text. Find the message id with list-mail-messages first."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')",
     "method": "patch",
@@ -641,6 +658,41 @@
     "skipEncoding": ["address"],
     "llmTip": "Delete cells at the given range, shifting remaining content. Body: { shift: 'Up' } or { shift: 'Left' }. Use 'Up' to delete entire rows."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/merge",
+    "method": "post",
+    "toolName": "merge-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Merge the cells in the given range into a single cell. Body: { across: false } merges the entire range into one cell; { across: true } merges each row separately. Useful for building styled headers, banner rows, and report layouts."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/unmerge",
+    "method": "post",
+    "toolName": "unmerge-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Unmerge any merged cells within the given range back into individual cells. No request body. Inverse of merge-excel-range."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/clear",
+    "method": "post",
+    "toolName": "clear-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Clear cell contents and/or formatting on the given range. Body: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' wipes values but keeps formatting; 'Formats' resets styling but keeps values; 'All' wipes both. Use this to reset a worksheet section before a fresh write rather than overwriting cell-by-cell."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/usedRange()",
+    "method": "get",
+    "toolName": "get-excel-used-range",
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "llmTip": "Get the smallest range that encompasses any cells with values or formatting on the worksheet. Returns address, values, formulas, numberFormat, rowCount, columnCount. Use this to discover the populated bounds of a sheet before reading or appending — avoids guessing how far data extends. Optional $select to trim the response."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/tables/{workbookTable-id}/rows/itemAt(index={index})",
     "method": "patch",

package/dist/generated/client.js

@@ -1320,6 +1320,7 @@ const microsoft_graph_workbookWorksheetCollectionResponse = z.object({
   value: z.array(microsoft_graph_workbookWorksheet)
 }).partial().passthrough();
 const create_excel_chart_Body = z.object({ type: z.string(), sourceData: z.unknown(), seriesBy: z.string() }).partial().passthrough();
+const microsoft_graph_workbookRangeSort = z.object({ id: z.string().describe("The unique identifier for an entity. Read-only.").optional() }).passthrough();
 const microsoft_graph_workbookRangeBorder = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
   color: z.string().describe(
@@ -1385,7 +1386,6 @@ const microsoft_graph_workbookRangeFormat = z.object({
   font: microsoft_graph_workbookRangeFont.optional(),
   protection: microsoft_graph_workbookFormatProtection.optional()
 }).passthrough();
-const microsoft_graph_workbookRangeSort = z.object({ id: z.string().describe("The unique identifier for an entity. Read-only.").optional() }).passthrough();
 const microsoft_graph_workbookRange = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
   address: z.string().describe(
@@ -4646,12 +4646,12 @@ const schemas = {
   microsoft_graph_workbookTableRowCollectionResponse,
   microsoft_graph_workbookWorksheetCollectionResponse,
   create_excel_chart_Body,
+  microsoft_graph_workbookRangeSort,
   microsoft_graph_workbookRangeBorder,
   microsoft_graph_workbookRangeFill,
   microsoft_graph_workbookRangeFont,
   microsoft_graph_workbookFormatProtection,
   microsoft_graph_workbookRangeFormat,
-  microsoft_graph_workbookRangeSort,
   microsoft_graph_workbookRange,
   create_excel_table_Body,
   microsoft_graph_assignedLabel,
@@ -4962,6 +4962,22 @@ const schemas = {
   microsoft_graph_userCollectionResponse
 };
 const endpoints = makeApi([
+  {
+    method: "post",
+    path: "/$batch",
+    alias: "graph-batch",
+    description: `Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order \u2014 match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...).`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: z.object({}).partial().passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/chats",
@@ -6059,6 +6075,26 @@ Items with this property set should be removed from your local state.`,
         description: `Operation payload`,
         type: "Body",
         schema: z.object({}).partial().passthrough().passthrough()
+      },
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookTableId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookTable-id")
+      },
+      {
+        name: "index",
+        type: "Path",
+        schema: z.string().describe("Path parameter: index")
       }
     ],
     response: z.void()
@@ -6069,6 +6105,28 @@ Items with this property set should be removed from your local state.`,
     alias: "delete-excel-table-row",
     description: `Delete a single row from a formal Excel table by zero-based row index.`,
     requestFormat: "json",
+    parameters: [
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookTableId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookTable-id")
+      },
+      {
+        name: "index",
+        type: "Path",
+        schema: z.string().describe("Path parameter: index")
+      }
+    ],
     response: z.void()
   },
   {
@@ -6137,22 +6195,6 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
-  {
-    method: "patch",
-    path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range()/format",
-    alias: "format-excel-range",
-    description: `Update the navigation property format in drives`,
-    requestFormat: "json",
-    parameters: [
-      {
-        name: "body",
-        description: `New navigation property values`,
-        type: "Body",
-        schema: microsoft_graph_workbookRangeFormat
-      }
-    ],
-    response: z.void()
-  },
   {
     method: "patch",
     path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range()/sort",
@@ -6191,6 +6233,42 @@ Items with this property set should be removed from your local state.`,
         description: `Operation payload`,
         type: "Body",
         schema: z.object({}).partial().passthrough().passthrough()
+      },
+      {
+        name: "driveId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: drive-id")
+      },
+      {
+        name: "driveItemId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: driveItem-id")
+      },
+      {
+        name: "workbookWorksheetId",
+        type: "Path",
+        schema: z.string().describe("Path parameter: workbookWorksheet-id")
+      },
+      {
+        name: "address",
+        type: "Path",
+        schema: z.string().describe("Path parameter: address")
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/clear`,
+    alias: "clear-excel-range",
+    description: `Invoke action clear`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ applyTo: z.string() }).partial().passthrough()
       }
     ],
     response: z.void()
@@ -6211,6 +6289,22 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format`,
+    alias: "format-excel-range",
+    description: `Update the navigation property format in drives`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property values`,
+        type: "Body",
+        schema: microsoft_graph_workbookRangeFormat
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/insert`,
@@ -6227,6 +6321,30 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/merge`,
+    alias: "merge-excel-range",
+    description: `Invoke action merge`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ across: z.boolean().default(false) }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/unmerge`,
+    alias: "unmerge-excel-range",
+    description: `Invoke action unmerge`,
+    requestFormat: "json",
+    response: z.void()
+  },
   {
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/tables/add",
@@ -6243,6 +6361,14 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/usedRange()",
+    alias: "get-excel-used-range",
+    description: `Invoke function usedRange`,
+    requestFormat: "json",
+    response: z.void()
+  },
   {
     method: "get",
     path: "/drives/:driveId/root",
@@ -9385,6 +9511,21 @@ having to fetch the entire set of messages from the server every time.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/messages/:messageId/$value",
+    alias: "get-mail-message-mime",
+    description: `Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "includeHiddenMessages",
+        type: "Query",
+        schema: z.string().describe("Include Hidden Messages").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/messages/:messageId/attachments",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.95.0",
+  "version": "0.96.0",
   "description": " A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API",
   "type": "module",
   "main": "dist/index.js",

package/src/endpoints.json

@@ -1,4 +1,11 @@
 [
+  {
+    "pathPattern": "/$batch",
+    "method": "post",
+    "toolName": "graph-batch",
+    "scopes": [],
+    "llmTip": "Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...)."
+  },
   {
     "pathPattern": "/me/messages",
     "method": "get",
@@ -593,11 +600,13 @@
     "scopes": ["Files.ReadWrite"]
   },
   {
-    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/format",
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
     "method": "patch",
     "toolName": "format-excel-range",
     "isExcelOp": true,
-    "scopes": ["Files.ReadWrite"]
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Apply font/fill/borders/alignment/wrapText/columnWidth/rowHeight to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { font: {bold,color,size,italic,name,underline}, fill: {color}, borders: [{sideIndex,style,color,weight}], horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }."
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",
@@ -614,6 +623,14 @@
     "scopes": ["Files.Read"],
     "skipEncoding": ["address"]
   },
+  {
+    "pathPattern": "/me/messages/{message-id}/$value",
+    "method": "get",
+    "toolName": "get-mail-message-mime",
+    "scopes": ["Mail.Read"],
+    "acceptType": "text/plain",
+    "llmTip": "Download an email message as raw RFC 5322 MIME content (.eml format). Use this when archiving an email to disk preserving all original headers, body, and inline-encoded attachments. Returns the MIME stream as text. Find the message id with list-mail-messages first."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')",
     "method": "patch",
@@ -641,6 +658,41 @@
     "skipEncoding": ["address"],
     "llmTip": "Delete cells at the given range, shifting remaining content. Body: { shift: 'Up' } or { shift: 'Left' }. Use 'Up' to delete entire rows."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/merge",
+    "method": "post",
+    "toolName": "merge-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Merge the cells in the given range into a single cell. Body: { across: false } merges the entire range into one cell; { across: true } merges each row separately. Useful for building styled headers, banner rows, and report layouts."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/unmerge",
+    "method": "post",
+    "toolName": "unmerge-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Unmerge any merged cells within the given range back into individual cells. No request body. Inverse of merge-excel-range."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/clear",
+    "method": "post",
+    "toolName": "clear-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Clear cell contents and/or formatting on the given range. Body: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' wipes values but keeps formatting; 'Formats' resets styling but keeps values; 'All' wipes both. Use this to reset a worksheet section before a fresh write rather than overwriting cell-by-cell."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/usedRange()",
+    "method": "get",
+    "toolName": "get-excel-used-range",
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "llmTip": "Get the smallest range that encompasses any cells with values or formatting on the worksheet. Returns address, values, formulas, numberFormat, rowCount, columnCount. Use this to discover the populated bounds of a sheet before reading or appending — avoids guessing how far data extends. Optional $select to trim the response."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/tables/{workbookTable-id}/rows/itemAt(index={index})",
     "method": "patch",