@softeria/ms-365-mcp-server 0.125.0 → 0.126.0

package/bin/modules/simplified-openapi.mjs

@@ -145,6 +145,10 @@ export function createAndSaveSimplifiedOpenAPI(
     }
   }
 
+  if (apiVersion === 'beta') {
+    normalizeWildcardSuccessResponses(openApiSpec.paths);
+  }
+
   if (openApiSpec.components && openApiSpec.components.schemas) {
     removeODataTypeRecursively(openApiSpec.components.schemas);
     flattenComplexSchemasRecursively(openApiSpec.components.schemas);
@@ -162,6 +166,29 @@ export function createAndSaveSimplifiedOpenAPI(
   fs.writeFileSync(openapiTrimmedFile, yaml.dump(openApiSpec));
 }
 
+function normalizeWildcardSuccessResponses(paths) {
+  Object.values(paths || {}).forEach((pathItem) => {
+    if (!pathItem || typeof pathItem !== 'object') return;
+
+    Object.entries(pathItem).forEach(([method, operation]) => {
+      if (!operation || typeof operation !== 'object') return;
+      if (!operation.responses || !operation.responses['2XX']) return;
+
+      const hasConcreteSuccess = Object.keys(operation.responses).some((statusCode) =>
+        /^2\d\d$/.test(statusCode)
+      );
+      if (hasConcreteSuccess) {
+        delete operation.responses['2XX'];
+        return;
+      }
+
+      const successStatus = method === 'post' ? '201' : method === 'delete' ? '204' : '200';
+      operation.responses[successStatus] = operation.responses['2XX'];
+      delete operation.responses['2XX'];
+    });
+  });
+}
+
 function removeODataTypeRecursively(obj) {
   if (!obj || typeof obj !== 'object') return;
 

package/dist/endpoints.json

@@ -1167,6 +1167,30 @@
     "scopes": ["Tasks.ReadWrite"],
     "llmTip": "CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true)."
   },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages",
+    "method": "get",
+    "toolName": "list-planner-task-messages",
+    "scopes": ["Tasks.Read"],
+    "apiVersion": "beta",
+    "llmTip": "Lists messages in a Planner task's chat — the modern Planner 'task chat', distinct from the legacy conversationThreadId comments (which live in the M365 group conversation thread). Each message has id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages",
+    "method": "post",
+    "toolName": "create-planner-task-message",
+    "scopes": ["Tasks.ReadWrite"],
+    "apiVersion": "beta",
+    "llmTip": "Posts a message to a Planner task's chat (the modern 'task chat', not the legacy conversationThreadId comment). Microsoft is retiring the classic task comments experience and hiding it from the task (Planner 2026 update), so task chat is the current supported way to post per-task updates teammates will see, with @mentions. Body: { content: 'plain text or sanitized HTML', mentions?: [{ mentioned: 'user-id', position: 0, mentionType: 'user' }] } (mentions optional). No ETag/If-Match required. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}",
+    "method": "delete",
+    "toolName": "delete-planner-task-message",
+    "scopes": ["Tasks.ReadWrite"],
+    "apiVersion": "beta",
+    "llmTip": "Deletes a message from a Planner task's chat. No request body; If-Match is optional if you want conditional deletion; returns 204. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
   {
     "pathPattern": "/me/contacts",
     "method": "get",

package/dist/generated/client-beta.js

@@ -690,6 +690,58 @@ const microsoft_graph_ODataErrors_MainError = z.object({
   innerError: microsoft_graph_ODataErrors_InnerError.optional()
 }).passthrough();
 const microsoft_graph_ODataErrors_ODataError = z.object({ error: microsoft_graph_ODataErrors_MainError }).passthrough();
+const microsoft_graph_plannerTaskChatMentionType = z.enum([
+  "user",
+  "application",
+  "unknownFutureValue"
+]);
+const microsoft_graph_plannerTaskChatMention = z.object({
+  mentioned: z.string().describe("The ID of the mentioned user.").nullish(),
+  mentionType: microsoft_graph_plannerTaskChatMentionType.optional(),
+  position: z.number().gte(-2147483648).lte(2147483647).describe("The zero-based position of the mention in the message content.").optional()
+}).passthrough();
+const microsoft_graph_plannerTaskChatMessageType = z.enum([
+  "richTextHtml",
+  "plainText",
+  "unknownFutureValue"
+]);
+const microsoft_graph_plannerTaskChatReactionEvent = z.object({
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe(
+    "The date and time when the reaction was added. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z."
+  ).optional()
+}).passthrough();
+const microsoft_graph_plannerTaskChatReaction = z.object({
+  reactionEvents: z.array(microsoft_graph_plannerTaskChatReactionEvent).optional(),
+  reactionType: z.string().describe("The type of reaction, such as like, heart, or emoji characters.").nullish()
+}).passthrough();
+const microsoft_graph_plannerTaskChatMessage = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  content: z.string().describe("The content of the chat message. Supports plain text and sanitized HTML.").nullish(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe(
+    "The date and time when the message was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z."
+  ).optional(),
+  deletedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).nullish(),
+  editedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).nullish(),
+  mentions: z.array(microsoft_graph_plannerTaskChatMention).describe("The list of mentions in the message.").optional(),
+  messageType: microsoft_graph_plannerTaskChatMessageType.optional(),
+  parentEntityId: z.string().describe("The ID of the parent plannerTask that this message belongs to.").nullish(),
+  reactions: z.array(microsoft_graph_plannerTaskChatReaction).describe("The reactions on the message.").optional()
+}).passthrough();
+const microsoft_graph_plannerTaskChatMessageCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_plannerTaskChatMessage)
+}).partial().passthrough();
 const schemas = {
   microsoft_graph_allowedAudiences,
   microsoft_graph_identity,
@@ -741,7 +793,14 @@ const schemas = {
   microsoft_graph_ODataErrors_ErrorDetails,
   microsoft_graph_ODataErrors_InnerError,
   microsoft_graph_ODataErrors_MainError,
-  microsoft_graph_ODataErrors_ODataError
+  microsoft_graph_ODataErrors_ODataError,
+  microsoft_graph_plannerTaskChatMentionType,
+  microsoft_graph_plannerTaskChatMention,
+  microsoft_graph_plannerTaskChatMessageType,
+  microsoft_graph_plannerTaskChatReactionEvent,
+  microsoft_graph_plannerTaskChatReaction,
+  microsoft_graph_plannerTaskChatMessage,
+  microsoft_graph_plannerTaskChatMessageCollectionResponse
 };
 const endpoints = makeApi([
   {
@@ -762,6 +821,87 @@ const endpoints = makeApi([
         schema: z.array(z.string()).describe("Expand related entities").optional()
       }
     ],
+    response: microsoft_graph_profile
+  },
+  {
+    method: "get",
+    path: "/planner/tasks/:plannerTaskId/messages",
+    alias: "list-planner-task-messages",
+    description: `Retrieve a list of plannerTaskChatMessage objects associated with a plannerTask.`,
+    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: microsoft_graph_plannerTaskChatMessageCollectionResponse
+  },
+  {
+    method: "post",
+    path: "/planner/tasks/:plannerTaskId/messages",
+    alias: "create-planner-task-message",
+    description: `Create a new plannerTaskChatMessage on a plannerTask.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_plannerTaskChatMessage
+      }
+    ],
+    response: microsoft_graph_plannerTaskChatMessage
+  },
+  {
+    method: "delete",
+    path: "/planner/tasks/:plannerTaskId/messages/:plannerTaskChatMessageId",
+    alias: "delete-planner-task-message",
+    description: `Delete a plannerTaskChatMessage object.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
     response: z.void()
   }
 ]);

package/dist/graph-client.js

@@ -178,7 +178,7 @@ class GraphClient {
       const removeODataProps2 = (obj) => {
         if (typeof obj === "object" && obj !== null) {
           Object.keys(obj).forEach((key) => {
-            if (key.startsWith("@odata.") && key !== "@odata.nextLink") {
+            if (key.startsWith("@odata.") && key !== "@odata.nextLink" && key !== "@odata.deltaLink") {
               delete obj[key];
             } else if (typeof obj[key] === "object") {
               removeODataProps2(obj[key]);
@@ -207,7 +207,7 @@ class GraphClient {
     const removeODataProps = (obj) => {
       if (typeof obj === "object" && obj !== null) {
         Object.keys(obj).forEach((key) => {
-          if (key.startsWith("@odata.") && key !== "@odata.nextLink") {
+          if (key.startsWith("@odata.") && key !== "@odata.nextLink" && key !== "@odata.deltaLink") {
             delete obj[key];
           } else if (typeof obj[key] === "object") {
             removeODataProps(obj[key]);

package/dist/graph-tools.js

@@ -23,6 +23,10 @@ const __dirname = path.dirname(__filename);
 const endpointsData = JSON.parse(
   readFileSync(path.join(__dirname, "endpoints.json"), "utf8")
 );
+const TOP_UNSUPPORTED_DELTA_TOOLS = /* @__PURE__ */ new Set([
+  "list-calendar-events-delta",
+  "list-calendar-view-delta"
+]);
 function withApiVersionPrefix(description, config) {
   return config?.apiVersion === "beta" ? `[beta] ${description}` : description;
 }
@@ -304,6 +308,9 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
         logger.info(`OData param fallback: forwarded ${fixedParamName}=${paramValue}`);
       }
     }
+    if (TOP_UNSUPPORTED_DELTA_TOOLS.has(tool.alias)) {
+      delete queryParams["$top"];
+    }
     clampTopQueryParam(queryParams);
     const preferValues = [];
     if (config?.supportsTimezone && params.timezone) {
@@ -401,6 +408,7 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
         let pageCount = 1;
         const maxPages = positiveIntFromEnv("MS365_MCP_MAX_PAGES", DEFAULT_MAX_PAGES);
         const maxItems = positiveIntFromEnv("MS365_MCP_MAX_ITEMS", DEFAULT_MAX_ITEMS);
+        let deltaLink = combinedResponse["@odata.deltaLink"];
         while (nextLink && pageCount < maxPages && allItems.length < maxItems) {
           logger.info(`Fetching page ${pageCount + 1} from: ${nextLink}`);
           const url = new URL(nextLink);
@@ -413,6 +421,9 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
               allItems = allItems.concat(nextJsonResponse.value);
             }
             nextLink = nextJsonResponse["@odata.nextLink"];
+            if (nextJsonResponse["@odata.deltaLink"]) {
+              deltaLink = nextJsonResponse["@odata.deltaLink"];
+            }
             pageCount++;
           } else {
             break;
@@ -431,6 +442,9 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
           combinedResponse["@odata.count"] = allItems.length;
         }
         delete combinedResponse["@odata.nextLink"];
+        if (deltaLink) {
+          combinedResponse["@odata.deltaLink"] = deltaLink;
+        }
         response.content[0].text = JSON.stringify(combinedResponse);
         logger.info(
           `Pagination complete: collected ${allItems.length} items across ${pageCount} pages`
@@ -579,7 +593,10 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
       const key = paramSchema["$orderby"] !== void 0 ? "$orderby" : "orderby";
       paramSchema[key] = z.string().describe("Sort expression, e.g. receivedDateTime desc").optional();
     }
-    if (paramSchema["top"] !== void 0 || paramSchema["$top"] !== void 0) {
+    if (TOP_UNSUPPORTED_DELTA_TOOLS.has(tool.alias)) {
+      delete paramSchema["top"];
+      delete paramSchema["$top"];
+    } else if (paramSchema["top"] !== void 0 || paramSchema["$top"] !== void 0) {
       const key = paramSchema["$top"] !== void 0 ? "$top" : "top";
       paramSchema[key] = z.number().describe(
         "Page size (Graph $top). Start small (e.g. 5\u201315) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top."

package/package.json

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

@@ -1167,6 +1167,30 @@
     "scopes": ["Tasks.ReadWrite"],
     "llmTip": "CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true)."
   },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages",
+    "method": "get",
+    "toolName": "list-planner-task-messages",
+    "scopes": ["Tasks.Read"],
+    "apiVersion": "beta",
+    "llmTip": "Lists messages in a Planner task's chat — the modern Planner 'task chat', distinct from the legacy conversationThreadId comments (which live in the M365 group conversation thread). Each message has id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages",
+    "method": "post",
+    "toolName": "create-planner-task-message",
+    "scopes": ["Tasks.ReadWrite"],
+    "apiVersion": "beta",
+    "llmTip": "Posts a message to a Planner task's chat (the modern 'task chat', not the legacy conversationThreadId comment). Microsoft is retiring the classic task comments experience and hiding it from the task (Planner 2026 update), so task chat is the current supported way to post per-task updates teammates will see, with @mentions. Body: { content: 'plain text or sanitized HTML', mentions?: [{ mentioned: 'user-id', position: 0, mentionType: 'user' }] } (mentions optional). No ETag/If-Match required. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}",
+    "method": "delete",
+    "toolName": "delete-planner-task-message",
+    "scopes": ["Tasks.ReadWrite"],
+    "apiVersion": "beta",
+    "llmTip": "Deletes a message from a Planner task's chat. No request body; If-Match is optional if you want conditional deletion; returns 204. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet)."
+  },
   {
     "pathPattern": "/me/contacts",
     "method": "get",