@softeria/ms-365-mcp-server 0.131.3 → 0.132.0

package/dist/endpoints.json

@@ -702,7 +702,102 @@
     "isExcelOp": true,
     "scopes": ["Files.ReadWrite"],
     "skipEncoding": ["address"],
-    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Note: font, fill, and borders are sub-resources on rangeFormat — set them via /format/font, /format/fill, and /format/borders/{sideIndex} respectively, not on this endpoint."
+    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
+    "method": "get",
+    "toolName": "get-excel-range-format",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "skipEncoding": ["address"],
+    "llmTip": "Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/font",
+    "method": "patch",
+    "toolName": "format-excel-range-font",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set font formatting on a range: bold, italic, underline, size, color, and font name.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Font style applied to every cell in the range. Send only the properties you want to change.",
+      "properties": {
+        "bold": { "type": "boolean" },
+        "italic": { "type": "boolean" },
+        "underline": {
+          "type": "string",
+          "enum": ["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]
+        },
+        "size": { "type": "number", "description": "Font size in points." },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the text, e.g. #FF0000 or a named color like 'red'."
+        },
+        "name": { "type": "string", "description": "Font name, e.g. 'Calibri'." }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/fill",
+    "method": "patch",
+    "toolName": "format-excel-range-fill",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set the background fill color of a range's cells.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Background fill applied to every cell in the range.",
+      "properties": {
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+        }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/borders/{sideIndex}",
+    "method": "patch",
+    "toolName": "format-excel-range-border",
+    "presets": ["excel"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Line style for the chosen border side.",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enum": [
+            "None",
+            "Continuous",
+            "Dash",
+            "DashDot",
+            "DashDotDot",
+            "Dot",
+            "Double",
+            "SlantDashDot"
+          ]
+        },
+        "weight": {
+          "type": "string",
+          "enum": ["Hairline", "Thin", "Medium", "Thick"]
+        },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the line, e.g. #000000 or a named color like 'black'."
+        }
+      }
+    }
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",

package/dist/generated/client.js

@@ -2593,6 +2593,7 @@ const microsoft_graph_listItem = z.object({
   documentSetVersions: z.array(microsoft_graph_documentSetVersion).describe("Version information for a document set version created by a user.").optional(),
   driveItem: microsoft_graph_driveItem.describe("[Note: Simplified from 45 properties to 25 most common ones]").optional(),
   fields: microsoft_graph_fieldValueSet.optional(),
+  permissions: z.array(microsoft_graph_permission).optional(),
   versions: z.array(microsoft_graph_listItemVersion).describe("The list of previous versions of the list item.").optional()
 }).passthrough();
 const microsoft_graph_longRunningOperationStatus = z.enum([
@@ -2716,6 +2717,7 @@ const microsoft_graph_list = z.lazy(
     drive: microsoft_graph_drive.optional(),
     items: z.array(microsoft_graph_listItem).describe("All items contained in the list.").optional(),
     operations: z.array(microsoft_graph_richLongRunningOperation).describe("The collection of long-running operations on the list.").optional(),
+    permissions: z.array(microsoft_graph_permission).optional(),
     subscriptions: z.array(microsoft_graph_subscription).describe("The set of subscriptions on the list.").optional()
   }).passthrough()
 );
@@ -4160,6 +4162,7 @@ const microsoft_graph_place = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4181,6 +4184,7 @@ const microsoft_graph_room = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4194,7 +4198,6 @@ const microsoft_graph_room = z.object({
   floorLabel: z.string().describe("Specifies a descriptive label for the floor, for example, P.").nullish(),
   floorNumber: z.number().gte(-2147483648).lte(2147483647).describe("Specifies the floor number that the room is on.").nullish(),
   nickname: z.string().describe("Specifies a nickname for the room, for example, 'conf room'.").optional(),
-  placeId: z.string().describe("An alternative immutable unique identifier of the room. Read-only.").nullish(),
   teamsEnabledState: microsoft_graph_placeFeatureEnablement.optional(),
   videoDeviceName: z.string().describe("Specifies the name of the video device in the room.").nullish()
 }).passthrough();
@@ -4208,6 +4211,7 @@ const microsoft_graph_workspace = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4222,8 +4226,7 @@ const microsoft_graph_workspace = z.object({
   mode: microsoft_graph_placeMode.optional(),
   nickname: z.string().describe(
     "A short, friendly name for the workspace, often used for easier identification or display in the UI."
-  ).optional(),
-  placeId: z.string().describe("An alternative immutable unique identifier of the workspace. Read-only.").nullish()
+  ).optional()
 }).passthrough();
 const microsoft_graph_roomList = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
@@ -4234,6 +4237,7 @@ const microsoft_graph_roomList = z.object({
   label: z.string().describe("User-defined description of the place.").nullish(),
   parentId: z.string().describe("The ID of a parent place.").nullish(),
   phone: z.string().describe("The phone number of the place.").nullish(),
+  placeId: z.string().describe("A stable service-level identifier for the place object used by Places workloads.").nullish(),
   tags: z.array(z.string()).describe("Custom tags that are associated with the place for categorization or filtering.").optional(),
   checkIns: z.array(microsoft_graph_checkInClaim).describe(
     "A subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place."
@@ -4814,6 +4818,28 @@ const microsoft_graph_userCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_user)
 }).partial().passthrough();
+const format_excel_range_font_Body = z.object({
+  bold: z.boolean(),
+  italic: z.boolean(),
+  underline: z.enum(["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]),
+  size: z.number().describe("Font size in points."),
+  color: z.string().describe("HTML color code for the text, e.g. #FF0000 or a named color like 'red'."),
+  name: z.string().describe("Font name, e.g. 'Calibri'.")
+}).partial().passthrough();
+const format_excel_range_border_Body = z.object({
+  style: z.enum([
+    "None",
+    "Continuous",
+    "Dash",
+    "DashDot",
+    "DashDotDot",
+    "Dot",
+    "Double",
+    "SlantDashDot"
+  ]),
+  weight: z.enum(["Hairline", "Thin", "Medium", "Thick"]),
+  color: z.string().describe("HTML color code for the line, e.g. #000000 or a named color like 'black'.")
+}).partial().passthrough();
 const schemas = {
   microsoft_graph_chatType,
   microsoft_graph_migrationMode,
@@ -5319,7 +5345,9 @@ const schemas = {
   microsoft_graph_subscriptionCollectionResponse,
   microsoft_graph_channelCollectionResponse,
   microsoft_graph_teamsTabCollectionResponse,
-  microsoft_graph_userCollectionResponse
+  microsoft_graph_userCollectionResponse,
+  format_excel_range_font_Body,
+  format_excel_range_border_Body
 };
 const endpoints = makeApi([
   {
@@ -6658,6 +6686,26 @@ 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/range(address=':address')/format`,
+    alias: "get-excel-range-format",
+    description: `Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "patch",
     path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format`,
@@ -6674,6 +6722,123 @@ 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/borders/:sideIndex`,
+    alias: "format-excel-range-border",
+    description: `Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: format_excel_range_border_Body
+      },
+      {
+        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")
+      },
+      {
+        name: "sideIndex",
+        type: "Path",
+        schema: z.string().describe("Path parameter: sideIndex")
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format/fill`,
+    alias: "format-excel-range-fill",
+    description: `Set the background fill color of a range's cells.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: z.object({
+          color: z.string().describe(
+            "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+          )
+        }).partial().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: "patch",
+    path: `/drives/:driveId/items/:driveItemId/workbook/worksheets/:workbookWorksheetId/range(address=':address')/format/font`,
+    alias: "format-excel-range-font",
+    description: `Set font formatting on a range: bold, italic, underline, size, color, and font name.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Operation payload`,
+        type: "Body",
+        schema: format_excel_range_font_Body
+      },
+      {
+        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')/insert`,

package/package.json

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

@@ -702,7 +702,102 @@
     "isExcelOp": true,
     "scopes": ["Files.ReadWrite"],
     "skipEncoding": ["address"],
-    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Note: font, fill, and borders are sub-resources on rangeFormat — set them via /format/font, /format/fill, and /format/borders/{sideIndex} respectively, not on this endpoint."
+    "llmTip": "Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format",
+    "method": "get",
+    "toolName": "get-excel-range-format",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.Read"],
+    "skipEncoding": ["address"],
+    "llmTip": "Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/font",
+    "method": "patch",
+    "toolName": "format-excel-range-font",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set font formatting on a range: bold, italic, underline, size, color, and font name.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Font style applied to every cell in the range. Send only the properties you want to change.",
+      "properties": {
+        "bold": { "type": "boolean" },
+        "italic": { "type": "boolean" },
+        "underline": {
+          "type": "string",
+          "enum": ["None", "Single", "Double", "SingleAccountant", "DoubleAccountant"]
+        },
+        "size": { "type": "number", "description": "Font size in points." },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the text, e.g. #FF0000 or a named color like 'red'."
+        },
+        "name": { "type": "string", "description": "Font name, e.g. 'Calibri'." }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/fill",
+    "method": "patch",
+    "toolName": "format-excel-range-fill",
+    "presets": ["excel", "personal"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Set the background fill color of a range's cells.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Background fill applied to every cell in the range.",
+      "properties": {
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the background, e.g. #FFFF00 or a named color like 'yellow'."
+        }
+      }
+    }
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')/format/borders/{sideIndex}",
+    "method": "patch",
+    "toolName": "format-excel-range-border",
+    "presets": ["excel"],
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"],
+    "skipEncoding": ["address"],
+    "llmTip": "Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.",
+    "requestBodySchema": {
+      "type": "object",
+      "description": "Line style for the chosen border side.",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enum": [
+            "None",
+            "Continuous",
+            "Dash",
+            "DashDot",
+            "DashDotDot",
+            "Dot",
+            "Double",
+            "SlantDashDot"
+          ]
+        },
+        "weight": {
+          "type": "string",
+          "enum": ["Hairline", "Thin", "Medium", "Thick"]
+        },
+        "color": {
+          "type": "string",
+          "description": "HTML color code for the line, e.g. #000000 or a named color like 'black'."
+        }
+      }
+    }
   },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",