@softeria/ms-365-mcp-server 0.87.1 → 0.88.1

package/bin/modules/simplified-openapi.mjs

@@ -14,6 +14,46 @@ export function createAndSaveSimplifiedOpenAPI(endpointsFile, openapiFile, opena
     }
   }
 
+  // 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).
+  for (const endpoint of endpoints) {
+    const pathSpec = openApiSpec.paths[endpoint.pathPattern];
+    const methodLower = endpoint.method.toLowerCase();
+    if (pathSpec && !pathSpec[methodLower]) {
+      pathSpec[methodLower] = {
+        tags: ['drives.driveItem'],
+        summary: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
+        description: endpoint.llmTip || `${endpoint.toolName} (synthesized)`,
+        operationId: endpoint.toolName,
+        requestBody:
+          methodLower === 'get' || methodLower === 'delete'
+            ? undefined
+            : {
+                description: 'Operation payload',
+                required: true,
+                content: {
+                  'application/json': {
+                    schema: { type: 'object', additionalProperties: true },
+                  },
+                },
+              },
+        responses: {
+          '2XX': {
+            description: 'Success',
+            content: {
+              'application/json': {
+                schema: { type: 'object', additionalProperties: true },
+              },
+            },
+          },
+          '4XX': { $ref: '#/components/responses/error' },
+          '5XX': { $ref: '#/components/responses/error' },
+        },
+      };
+    }
+  }
+
   for (const [key, value] of Object.entries(openApiSpec.paths)) {
     const e = endpoints.filter((ep) => ep.pathPattern === key);
     if (e.length === 0) {

package/dist/__tests__/graph-tools.test.js

@@ -395,4 +395,50 @@ describe("graph-tools", () => {
       expect(tool.schema["timezone"]).toBeUndefined();
     });
   });
+  describe("outlook.body-content-type Prefer header", () => {
+    it('should set Prefer: outlook.body-content-type="text" on GET requests', async () => {
+      const endpoint = makeEndpoint({ method: "get" });
+      const config = makeConfig({ method: "get" });
+      mockEndpoints.push(endpoint);
+      mockEndpointsJson = [config];
+      const graphClient = createMockGraphClient([
+        { content: [{ type: "text", text: JSON.stringify({ value: [] }) }] }
+      ]);
+      const server = createMockServer();
+      const { registerGraphTools } = await loadModule();
+      registerGraphTools(server, graphClient);
+      await server.tools.get("test-tool").handler({});
+      const [, options] = graphClient.graphRequest.mock.calls[0];
+      expect(options.headers["Prefer"]).toContain('outlook.body-content-type="text"');
+    });
+    it("should NOT set Prefer: outlook.body-content-type on POST requests", async () => {
+      const endpoint = makeEndpoint({
+        alias: "create-reply-draft",
+        method: "post",
+        path: "/me/messages/:messageId/createReply",
+        parameters: [
+          { name: "messageId", type: "Path", schema: z.string() },
+          { name: "body", type: "Body", schema: z.any() }
+        ]
+      });
+      const config = makeConfig({
+        toolName: "create-reply-draft",
+        method: "post",
+        pathPattern: "/me/messages/{message-id}/createReply"
+      });
+      mockEndpoints.push(endpoint);
+      mockEndpointsJson = [config];
+      const graphClient = createMockGraphClient([{ content: [{ type: "text", text: "{}" }] }]);
+      const server = createMockServer();
+      const { registerGraphTools } = await loadModule();
+      registerGraphTools(server, graphClient);
+      await server.tools.get("create-reply-draft").handler({
+        messageId: "AAMk123",
+        body: { Message: { body: { contentType: "html", content: "<p>hi</p>" } } }
+      });
+      const [, options] = graphClient.graphRequest.mock.calls[0];
+      const prefer = options.headers["Prefer"];
+      expect(prefer === void 0 || !prefer.includes("outlook.body-content-type")).toBe(true);
+    });
+  });
 });

package/dist/endpoints.json

@@ -190,13 +190,15 @@
     "pathPattern": "/me/messages/{message-id}/createReply",
     "method": "post",
     "toolName": "create-reply-draft",
-    "scopes": ["Mail.ReadWrite"]
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph."
   },
   {
     "pathPattern": "/me/messages/{message-id}/createReplyAll",
     "method": "post",
     "toolName": "create-reply-all-draft",
-    "scopes": ["Mail.ReadWrite"]
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph."
   },
   {
     "pathPattern": "/me/messages/{message-id}/send",
@@ -556,6 +558,59 @@
     "scopes": ["Files.Read"],
     "skipEncoding": ["address"]
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')",
+    "method": "patch",
+    "toolName": "update-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set cell values, formulas, or number format on any range — does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/insert",
+    "method": "post",
+    "toolName": "insert-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Insert blank cells at the given range, shifting existing content. Body: { shift: 'Down' } or { shift: 'Right' }. Use 'Down' to insert blank rows above existing data."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/delete",
+    "method": "post",
+    "toolName": "delete-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "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/tables/{workbookTable-id}/rows/itemAt(index={index})",
+    "method": "patch",
+    "toolName": "update-excel-table-row",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["index"],
+    "llmTip": "Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/tables/{workbookTable-id}/rows/itemAt(index={index})",
+    "method": "delete",
+    "toolName": "delete-excel-table-row",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["index"],
+    "llmTip": "Delete a single row from a formal Excel table by zero-based row index."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/tables/add",
+    "method": "post",
+    "toolName": "create-excel-table",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Convert a worksheet range into a formal Excel table. Body: { address: 'A1:H171', hasHeaders: true }. Required before using add-excel-table-rows / update-excel-table-row / delete-excel-table-row on a plain-cells sheet."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets",
     "method": "get",

package/dist/generated/client.js

@@ -1358,6 +1358,7 @@ const microsoft_graph_workbookRange = z.object({
   sort: microsoft_graph_workbookRangeSort.optional(),
   worksheet: microsoft_graph_workbookWorksheet.optional()
 }).passthrough();
+const create_excel_table_Body = z.object({ address: z.string().nullable(), hasHeaders: z.boolean().default(false) }).partial().passthrough();
 const microsoft_graph_assignedLabel = z.object({
   displayName: z.string().describe("The display name of the label. Read-only.").nullish(),
   labelId: z.string().describe("The unique identifier of the label.").nullish()
@@ -4461,6 +4462,7 @@ const schemas = {
   microsoft_graph_workbookRangeFormat,
   microsoft_graph_workbookRangeSort,
   microsoft_graph_workbookRange,
+  create_excel_table_Body,
   microsoft_graph_assignedLabel,
   microsoft_graph_licenseProcessingState,
   microsoft_graph_group,
@@ -5737,6 +5739,30 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "patch",
+    path: "/drives/:driveId/items/:driveItemId/workbook/tables/:workbookTableId/rows/itemAt(index=:index)",
+    alias: "update-excel-table-row",
+    description: `Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: z.object({}).partial().passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/drives/:driveId/items/:driveItemId/workbook/tables/:workbookTableId/rows/itemAt(index=:index)",
+    alias: "delete-excel-table-row",
+    description: `Delete a single row from a formal Excel table by zero-based row index.`,
+    requestFormat: "json",
+    response: z.void()
+  },
   {
     method: "get",
     path: "/drives/:driveId/items/:driveItemId/workbook/worksheets",
@@ -5845,6 +5871,70 @@ Items with this property set should be removed from your local state.`,
     requestFormat: "json",
     response: z.void()
   },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')`,
+    alias: "update-excel-range",
+    description: `Set cell values, formulas, or number format on any range \u2014 does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: z.object({}).partial().passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/delete`,
+    alias: "delete-excel-range",
+    description: `Invoke action delete`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ shift: z.string() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/insert`,
+    alias: "insert-excel-range",
+    description: `Invoke action insert`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ shift: z.string() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/tables/add",
+    alias: "create-excel-table",
+    description: `Create a new table. The range source address determines the worksheet under which the table will be added. If the table can't be added (for example, because the address is invalid, or the table would overlap with another table), an error is generated.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: create_excel_table_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/drives/:driveId/root",

package/dist/graph-tools.js

@@ -142,7 +142,7 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
       logger.info(`Setting timezone preference: outlook.timezone="${params.timezone}"`);
     }
     const bodyFormat = process.env.MS365_MCP_BODY_FORMAT || "text";
-    if (bodyFormat !== "html") {
+    if (bodyFormat !== "html" && tool.method.toUpperCase() === "GET") {
       preferValues.push(`outlook.body-content-type="${bodyFormat}"`);
     }
     if (preferValues.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.87.1",
+  "version": "0.88.1",
   "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

@@ -190,13 +190,15 @@
     "pathPattern": "/me/messages/{message-id}/createReply",
     "method": "post",
     "toolName": "create-reply-draft",
-    "scopes": ["Mail.ReadWrite"]
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph."
   },
   {
     "pathPattern": "/me/messages/{message-id}/createReplyAll",
     "method": "post",
     "toolName": "create-reply-all-draft",
-    "scopes": ["Mail.ReadWrite"]
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so the original quoted history is not included. Specifying both 'comment' and Message.body returns 400. Signatures are added by the Outlook client only, not via Graph."
   },
   {
     "pathPattern": "/me/messages/{message-id}/send",
@@ -556,6 +558,59 @@
     "scopes": ["Files.Read"],
     "skipEncoding": ["address"]
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')",
+    "method": "patch",
+    "toolName": "update-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set cell values, formulas, or number format on any range — does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/insert",
+    "method": "post",
+    "toolName": "insert-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Insert blank cells at the given range, shifting existing content. Body: { shift: 'Down' } or { shift: 'Right' }. Use 'Down' to insert blank rows above existing data."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/delete",
+    "method": "post",
+    "toolName": "delete-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "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/tables/{workbookTable-id}/rows/itemAt(index={index})",
+    "method": "patch",
+    "toolName": "update-excel-table-row",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["index"],
+    "llmTip": "Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/tables/{workbookTable-id}/rows/itemAt(index={index})",
+    "method": "delete",
+    "toolName": "delete-excel-table-row",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["index"],
+    "llmTip": "Delete a single row from a formal Excel table by zero-based row index."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/tables/add",
+    "method": "post",
+    "toolName": "create-excel-table",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Convert a worksheet range into a formal Excel table. Body: { address: 'A1:H171', hasHeaders: true }. Required before using add-excel-table-rows / update-excel-table-row / delete-excel-table-row on a plain-cells sheet."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets",
     "method": "get",