@softeria/ms-365-mcp-server 0.21.1 → 0.22.0

package/bin/modules/simplified-openapi.mjs

@@ -396,12 +396,35 @@ function findUsedSchemas(openApiSpec) {
   const schemasToProcess = [];
   const schemas = openApiSpec.components?.schemas || {};
   const responses = openApiSpec.components?.responses || {};
+  const requestBodies = openApiSpec.components?.requestBodies || {};
   const paths = openApiSpec.paths || {};
 
   Object.entries(paths).forEach(([, pathItem]) => {
     Object.entries(pathItem).forEach(([, operation]) => {
       if (typeof operation !== 'object') return;
 
+      if (operation.requestBody?.$ref) {
+        const requestBodyName = operation.requestBody.$ref.replace(
+          '#/components/requestBodies/',
+          ''
+        );
+        const requestBodyDefinition = requestBodies[requestBodyName];
+        if (requestBodyDefinition?.content) {
+          Object.values(requestBodyDefinition.content).forEach((content) => {
+            if (content.schema?.$ref) {
+              const schemaName = content.schema.$ref.replace('#/components/schemas/', '');
+              schemasToProcess.push(schemaName);
+            }
+            if (content.schema?.properties) {
+              findRefsInObject(content.schema.properties, (ref) => {
+                const schemaName = ref.replace('#/components/schemas/', '');
+                schemasToProcess.push(schemaName);
+              });
+            }
+          });
+        }
+      }
+
       if (operation.requestBody?.content) {
         Object.values(operation.requestBody.content).forEach((content) => {
           if (content.schema?.$ref) {

package/dist/endpoints.json

@@ -173,6 +173,12 @@
     "toolName": "list-calendars",
     "scopes": ["Calendars.Read"]
   },
+  {
+    "pathPattern": "/me/findMeetingTimes",
+    "method": "post",
+    "toolName": "find-meeting-times",
+    "workScopes": ["Calendars.Read.Shared"]
+  },
   {
     "pathPattern": "/me/drives",
     "method": "get",

package/dist/generated/client.js

@@ -2416,6 +2416,51 @@ const microsoft_graph_attachmentCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_attachment)
 }).partial().strict();
+const microsoft_graph_attendeeBase = z.object({
+  emailAddress: microsoft_graph_emailAddress.optional(),
+  type: microsoft_graph_attendeeType.optional()
+}).strict();
+const microsoft_graph_locationConstraintItem = z.object({
+  address: microsoft_graph_physicalAddress.optional(),
+  coordinates: microsoft_graph_outlookGeoCoordinates.optional(),
+  displayName: z.string().describe("The name associated with the location.").nullish(),
+  locationEmailAddress: z.string().describe("Optional email address of the location.").nullish(),
+  locationType: microsoft_graph_locationType.optional(),
+  locationUri: z.string().describe("Optional URI representing the location.").nullish(),
+  uniqueId: z.string().describe("For internal use only.").nullish(),
+  uniqueIdType: microsoft_graph_locationUniqueIdType.optional(),
+  resolveAvailability: z.boolean().describe(
+    "If set to true and the specified resource is busy, findMeetingTimes looks for another resource that is free. If set to false and the specified resource is busy, findMeetingTimes returns the resource best ranked in the user's cache without checking if it's free. Default is true."
+  ).nullish()
+}).strict();
+const microsoft_graph_locationConstraint = z.object({
+  isRequired: z.boolean().describe(
+    "The client requests the service to include in the response a meeting location for the meeting. If this is true and all the resources are busy, findMeetingTimes won't return any meeting time suggestions. If this is false and all the resources are busy, findMeetingTimes would still look for meeting times without locations."
+  ).nullish(),
+  locations: z.array(microsoft_graph_locationConstraintItem).describe(
+    "Constraint information for one or more locations that the client requests for the meeting."
+  ).optional(),
+  suggestLocation: z.boolean().describe("The client requests the service to suggest one or more meeting locations.").nullish()
+}).strict();
+const microsoft_graph_activityDomain = z.enum(["unknown", "work", "personal", "unrestricted"]);
+const microsoft_graph_timeConstraint = z.object({
+  activityDomain: microsoft_graph_activityDomain.optional(),
+  timeSlots: z.array(microsoft_graph_timeSlot).optional()
+}).strict();
+const ReferenceNumeric = z.enum(["-INF", "INF", "NaN"]);
+const find_meeting_times_Body = z.object({
+  attendees: z.array(microsoft_graph_attendeeBase),
+  locationConstraint: z.union([
+    microsoft_graph_locationConstraint,
+    z.object({}).partial().strict()
+  ]),
+  timeConstraint: z.union([microsoft_graph_timeConstraint, z.object({}).partial().strict()]),
+  meetingDuration: z.string().regex(/^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$/).nullable(),
+  maxCandidates: z.number().gte(-2147483648).lte(2147483647).nullable(),
+  isOrganizerOptional: z.boolean().nullable().default(false),
+  returnSuggestionReasons: z.boolean().nullable().default(false),
+  minimumAttendeePercentage: z.union([z.number(), z.string(), ReferenceNumeric])
+}).partial().strict();
 const send_mail_Body = z.object({
   Message: microsoft_graph_message.describe(
     "[Note: Simplified from 35 properties to 25 most common ones]"
@@ -3423,6 +3468,13 @@ const schemas = {
   microsoft_graph_mailFolderCollectionResponse,
   microsoft_graph_messageCollectionResponse,
   microsoft_graph_attachmentCollectionResponse,
+  microsoft_graph_attendeeBase,
+  microsoft_graph_locationConstraintItem,
+  microsoft_graph_locationConstraint,
+  microsoft_graph_activityDomain,
+  microsoft_graph_timeConstraint,
+  ReferenceNumeric,
+  find_meeting_times_Body,
   send_mail_Body,
   microsoft_graph_externalLink,
   microsoft_graph_notebookLinks,
@@ -6018,6 +6070,40 @@ open extensions or extended properties, and how to specify extended properties.`
       }
     ]
   },
+  {
+    method: "post",
+    path: "/me/findMeetingTimes",
+    alias: "find-meeting-times",
+    description: `Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints specified as parameters. If findMeetingTimes cannot return any meeting suggestions, the response would indicate a reason in the emptySuggestionsReason property.
+Based on this value, you can better adjust the parameters and call findMeetingTimes again. The algorithm used to suggest meeting times and locations undergoes fine-tuning from time to time. In scenarios like test environments where the input parameters and calendar data remain static, expect that the suggested results may differ over time.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: find_meeting_times_Body
+      }
+    ],
+    response: z.void(),
+    errors: [
+      {
+        status: NaN,
+        description: `Success`,
+        schema: z.object({}).partial().strict()
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
+  },
   {
     method: "get",
     path: "/me/joinedTeams",

package/package.json

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

@@ -173,6 +173,12 @@
     "toolName": "list-calendars",
     "scopes": ["Calendars.Read"]
   },
+  {
+    "pathPattern": "/me/findMeetingTimes",
+    "method": "post",
+    "toolName": "find-meeting-times",
+    "workScopes": ["Calendars.Read.Shared"]
+  },
   {
     "pathPattern": "/me/drives",
     "method": "get",