@softeria/ms-365-mcp-server 0.94.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",
@@ -1408,6 +1460,48 @@
     "workScopes": ["Sites.ReadWrite.All"],
     "llmTip": "Deletes a list item permanently. This cannot be undone — the item is moved to the site recycle bin."
   },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "post",
+    "toolName": "create-sharepoint-list",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new SharePoint list in a site. Body: { displayName: 'My List', description: 'Optional', list: { template: 'genericList' }, columns: [ { name: 'Status', text: {} }, { name: 'Due', dateTime: {} } ] }. Templates include genericList, documentLibrary, tasks, calendar, contacts, links, announcements, survey. Columns can be defined inline at creation; otherwise add them later via create-sharepoint-list-column. Use search-sharepoint-sites or get-sharepoint-site-by-path to find the site ID first."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "get",
+    "toolName": "list-sharepoint-list-columns",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Lists column definitions for a SharePoint list. Returns each column's id, name, displayName, description, type indicator (text, number, choice, dateTime, person, lookup, boolean, calculated, hyperlinkOrPicture, etc.), required, indexed, hidden, readOnly. Use this to discover the schema before creating or updating list items."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "post",
+    "toolName": "create-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new column on a SharePoint list. Body must include name and exactly one column type property: { name: 'Priority', text: {} } or { name: 'DueDate', dateTime: { format: 'dateOnly' } } or { name: 'Status', choice: { choices: ['Open','In Progress','Done'] } }. Other types: number, boolean, currency, hyperlinkOrPicture, personOrGroup, lookup, calculated. Optional: displayName, description, required, indexed, enforceUniqueValues."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-list-column",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Gets a specific column definition by ID, including its full type configuration (choices for choice columns, format for dateTime, etc.). Use list-sharepoint-list-columns first to find the column ID."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "patch",
+    "toolName": "update-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Updates a column definition. Body: { displayName: 'New name', description: 'New description', required: true, ... }. The column type itself (text, choice, etc.) cannot be changed — only its metadata and per-type options (e.g. choices array for a choice column). Send only the fields you want to change."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "delete",
+    "toolName": "delete-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Deletes a column from a SharePoint list. This is irreversible — all data stored in this column across every list item is lost. Confirm with the user before calling. Cannot delete built-in columns (Title, Created, Modified, etc.)."
+  },
   {
     "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
     "method": "get",

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(
@@ -4289,6 +4289,11 @@ const microsoft_graph_listCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_list)
 }).partial().passthrough();
+const microsoft_graph_columnDefinitionCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_columnDefinition)
+}).partial().passthrough();
 const microsoft_graph_listItemCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -4641,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,
@@ -4933,6 +4938,7 @@ const schemas = {
   microsoft_graph_siteCollectionResponse,
   microsoft_graph_baseItemCollectionResponse,
   microsoft_graph_listCollectionResponse,
+  microsoft_graph_columnDefinitionCollectionResponse,
   microsoft_graph_listItemCollectionResponse,
   microsoft_graph_endpointType,
   microsoft_graph_communicationsIdentitySet,
@@ -4956,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",
@@ -6053,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()
@@ -6063,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()
   },
   {
@@ -6131,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",
@@ -6185,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()
@@ -6205,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`,
@@ -6221,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",
@@ -6237,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",
@@ -9379,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",
@@ -11696,6 +11843,22 @@ To list them, include system in your $select statement.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/sites/:siteId/lists",
+    alias: "create-sharepoint-list",
+    description: `Create a new list in a site.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_list
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/sites/:siteId/lists/:listId",
@@ -11716,6 +11879,191 @@ To list them, include system in your $select statement.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/sites/:siteId/lists/:listId/columns",
+    alias: "list-sharepoint-list-columns",
+    description: `Get the collection of columns represented as columnDefinition resources in a list.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only the first n items").optional()
+      },
+      {
+        name: "$skip",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Skip the first n items").optional()
+      },
+      {
+        name: "$search",
+        type: "Query",
+        schema: z.string().describe("Search items by search phrases").optional()
+      },
+      {
+        name: "$filter",
+        type: "Query",
+        schema: z.string().describe("Filter items by property values").optional()
+      },
+      {
+        name: "$count",
+        type: "Query",
+        schema: z.boolean().describe("Include count of items").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        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: "post",
+    path: "/sites/:siteId/lists/:listId/columns",
+    alias: "create-sharepoint-list-column",
+    description: `Create a column for a list with a request that specifies a columnDefinition.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: z.object({
+          id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+          name: z.string().describe(
+            "The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName."
+          ).nullish(),
+          displayName: z.string().describe("The user-facing name of the column.").nullish(),
+          description: z.string().describe("The user-facing description of the column.").nullish(),
+          type: microsoft_graph_columnTypes.optional(),
+          boolean: microsoft_graph_booleanColumn.optional(),
+          calculated: microsoft_graph_calculatedColumn.optional(),
+          choice: microsoft_graph_choiceColumn.optional(),
+          columnGroup: z.string().describe(
+            "For site columns, the name of the group this column belongs to. Helps organize related columns."
+          ).nullish(),
+          contentApprovalStatus: microsoft_graph_contentApprovalStatusColumn.optional(),
+          currency: microsoft_graph_currencyColumn.optional(),
+          dateTime: microsoft_graph_dateTimeColumn.optional(),
+          defaultValue: microsoft_graph_defaultColumnValue.optional(),
+          enforceUniqueValues: z.boolean().describe("If true, no two list items may have the same value for this column.").nullish(),
+          geolocation: microsoft_graph_geolocationColumn.optional(),
+          hidden: z.boolean().describe("Specifies whether the column is displayed in the user interface.").nullish(),
+          hyperlinkOrPicture: microsoft_graph_hyperlinkOrPictureColumn.optional(),
+          indexed: z.boolean().describe(
+            "Specifies whether the column values can be used for sorting and searching."
+          ).nullish(),
+          isDeletable: z.boolean().describe("Indicates whether this column can be deleted.").nullish(),
+          isReorderable: z.boolean().describe("Indicates whether values in the column can be reordered. Read-only.").nullish(),
+          isSealed: z.boolean().describe("Specifies whether the column can be changed.").nullish(),
+          lookup: microsoft_graph_lookupColumn.optional(),
+          number: microsoft_graph_numberColumn.optional(),
+          personOrGroup: microsoft_graph_personOrGroupColumn.optional(),
+          propagateChanges: z.boolean().describe(
+            "If 'true', changes to this column will be propagated to lists that implement the column."
+          ).nullish()
+        }).passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "get-sharepoint-list-column",
+    description: `The collection of field definitions for this list.`,
+    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: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "update-sharepoint-list-column",
+    description: `Update the navigation property columns in sites`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property values`,
+        type: "Body",
+        schema: z.object({
+          id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+          name: z.string().describe(
+            "The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName."
+          ).nullish(),
+          displayName: z.string().describe("The user-facing name of the column.").nullish(),
+          description: z.string().describe("The user-facing description of the column.").nullish(),
+          type: microsoft_graph_columnTypes.optional(),
+          boolean: microsoft_graph_booleanColumn.optional(),
+          calculated: microsoft_graph_calculatedColumn.optional(),
+          choice: microsoft_graph_choiceColumn.optional(),
+          columnGroup: z.string().describe(
+            "For site columns, the name of the group this column belongs to. Helps organize related columns."
+          ).nullish(),
+          contentApprovalStatus: microsoft_graph_contentApprovalStatusColumn.optional(),
+          currency: microsoft_graph_currencyColumn.optional(),
+          dateTime: microsoft_graph_dateTimeColumn.optional(),
+          defaultValue: microsoft_graph_defaultColumnValue.optional(),
+          enforceUniqueValues: z.boolean().describe("If true, no two list items may have the same value for this column.").nullish(),
+          geolocation: microsoft_graph_geolocationColumn.optional(),
+          hidden: z.boolean().describe("Specifies whether the column is displayed in the user interface.").nullish(),
+          hyperlinkOrPicture: microsoft_graph_hyperlinkOrPictureColumn.optional(),
+          indexed: z.boolean().describe(
+            "Specifies whether the column values can be used for sorting and searching."
+          ).nullish(),
+          isDeletable: z.boolean().describe("Indicates whether this column can be deleted.").nullish(),
+          isReorderable: z.boolean().describe("Indicates whether values in the column can be reordered. Read-only.").nullish(),
+          isSealed: z.boolean().describe("Specifies whether the column can be changed.").nullish(),
+          lookup: microsoft_graph_lookupColumn.optional(),
+          number: microsoft_graph_numberColumn.optional(),
+          personOrGroup: microsoft_graph_personOrGroupColumn.optional(),
+          propagateChanges: z.boolean().describe(
+            "If 'true', changes to this column will be propagated to lists that implement the column."
+          ).nullish()
+        }).passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "delete-sharepoint-list-column",
+    description: `Delete navigation property columns for sites`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/sites/:siteId/lists/:listId/items",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.94.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",
@@ -1408,6 +1460,48 @@
     "workScopes": ["Sites.ReadWrite.All"],
     "llmTip": "Deletes a list item permanently. This cannot be undone — the item is moved to the site recycle bin."
   },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "post",
+    "toolName": "create-sharepoint-list",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new SharePoint list in a site. Body: { displayName: 'My List', description: 'Optional', list: { template: 'genericList' }, columns: [ { name: 'Status', text: {} }, { name: 'Due', dateTime: {} } ] }. Templates include genericList, documentLibrary, tasks, calendar, contacts, links, announcements, survey. Columns can be defined inline at creation; otherwise add them later via create-sharepoint-list-column. Use search-sharepoint-sites or get-sharepoint-site-by-path to find the site ID first."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "get",
+    "toolName": "list-sharepoint-list-columns",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Lists column definitions for a SharePoint list. Returns each column's id, name, displayName, description, type indicator (text, number, choice, dateTime, person, lookup, boolean, calculated, hyperlinkOrPicture, etc.), required, indexed, hidden, readOnly. Use this to discover the schema before creating or updating list items."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "post",
+    "toolName": "create-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new column on a SharePoint list. Body must include name and exactly one column type property: { name: 'Priority', text: {} } or { name: 'DueDate', dateTime: { format: 'dateOnly' } } or { name: 'Status', choice: { choices: ['Open','In Progress','Done'] } }. Other types: number, boolean, currency, hyperlinkOrPicture, personOrGroup, lookup, calculated. Optional: displayName, description, required, indexed, enforceUniqueValues."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-list-column",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Gets a specific column definition by ID, including its full type configuration (choices for choice columns, format for dateTime, etc.). Use list-sharepoint-list-columns first to find the column ID."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "patch",
+    "toolName": "update-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Updates a column definition. Body: { displayName: 'New name', description: 'New description', required: true, ... }. The column type itself (text, choice, etc.) cannot be changed — only its metadata and per-type options (e.g. choices array for a choice column). Send only the fields you want to change."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "delete",
+    "toolName": "delete-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Deletes a column from a SharePoint list. This is irreversible — all data stored in this column across every list item is lost. Confirm with the user before calling. Cannot delete built-in columns (Title, Created, Modified, etc.)."
+  },
   {
     "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
     "method": "get",