@softeria/ms-365-mcp-server 0.48.1 → 0.49.0

package/dist/endpoints.json

@@ -565,6 +565,20 @@
     "toolName": "get-current-user",
     "scopes": ["User.Read"]
   },
+  {
+    "pathPattern": "/me/mailboxSettings",
+    "method": "get",
+    "toolName": "get-mailbox-settings",
+    "scopes": ["MailboxSettings.Read"],
+    "llmTip": "Gets the current user's mailbox settings including automaticRepliesSetting (out-of-office status, message, scheduledStartDateTime/EndDateTime, externalAudience), language, timeZone, dateFormat, timeFormat, delegateMeetingMessageDeliveryOptions, and userPurpose."
+  },
+  {
+    "pathPattern": "/me/mailboxSettings",
+    "method": "patch",
+    "toolName": "update-mailbox-settings",
+    "scopes": ["MailboxSettings.ReadWrite"],
+    "llmTip": "Updates mailbox settings. Common use: configure Out-of-Office (automatic replies). Body example: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Status values: disabled, alwaysEnabled, scheduled."
+  },
   {
     "pathPattern": "/me/chats",
     "method": "get",

package/dist/generated/client.js

@@ -2378,6 +2378,64 @@ const microsoft_graph_teamCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_team)
 }).partial().passthrough();
+const microsoft_graph_externalAudienceScope = z.enum(["none", "contactsOnly", "all"]);
+const microsoft_graph_automaticRepliesStatus = z.enum(["disabled", "alwaysEnabled", "scheduled"]);
+const microsoft_graph_automaticRepliesSetting = z.object({
+  externalAudience: microsoft_graph_externalAudienceScope.optional(),
+  externalReplyMessage: z.string().describe(
+    "The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled."
+  ).nullish(),
+  internalReplyMessage: z.string().describe(
+    "The automatic reply to send to the audience internal to the signed-in user's organization, if Status is AlwaysEnabled or Scheduled."
+  ).nullish(),
+  scheduledEndDateTime: microsoft_graph_dateTimeTimeZone.optional(),
+  scheduledStartDateTime: microsoft_graph_dateTimeTimeZone.optional(),
+  status: microsoft_graph_automaticRepliesStatus.optional()
+}).passthrough();
+const microsoft_graph_delegateMeetingMessageDeliveryOptions = z.enum([
+  "sendToDelegateAndInformationToPrincipal",
+  "sendToDelegateAndPrincipal",
+  "sendToDelegateOnly"
+]);
+const microsoft_graph_localeInfo = z.object({
+  displayName: z.string().describe(
+    "A name representing the user's locale in natural language, for example, 'English (United States)'."
+  ).nullish(),
+  locale: z.string().describe(
+    "A locale representation for the user, which includes the user's preferred language and country/region. For example, 'en-us'. The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_userPurpose = z.enum([
+  "user",
+  "linked",
+  "shared",
+  "room",
+  "equipment",
+  "others",
+  "unknownFutureValue"
+]);
+const microsoft_graph_timeZoneBase = z.object({
+  name: z.string().describe(
+    "The name of a time zone. It can be a standard time zone name such as 'Hawaii-Aleutian Standard Time', or 'Customized Time Zone' for a custom time zone."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_workingHours = z.object({
+  daysOfWeek: z.array(z.union([microsoft_graph_dayOfWeek, z.object({}).partial().passthrough()])).describe("The days of the week on which the user works.").optional(),
+  endTime: z.string().regex(/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$/).describe("The time of the day that the user stops working.").nullish(),
+  startTime: z.string().regex(/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?$/).describe("The time of the day that the user starts working.").nullish(),
+  timeZone: microsoft_graph_timeZoneBase.optional()
+}).passthrough();
+const microsoft_graph_mailboxSettings = z.object({
+  archiveFolder: z.string().describe("Folder ID of an archive folder for the user.").nullish(),
+  automaticRepliesSetting: microsoft_graph_automaticRepliesSetting.optional(),
+  dateFormat: z.string().describe("The date format for the user's mailbox.").nullish(),
+  delegateMeetingMessageDeliveryOptions: microsoft_graph_delegateMeetingMessageDeliveryOptions.optional(),
+  language: microsoft_graph_localeInfo.optional(),
+  timeFormat: z.string().describe("The time format for the user's mailbox.").nullish(),
+  timeZone: z.string().describe("The default time zone for the user's mailbox.").nullish(),
+  userPurpose: microsoft_graph_userPurpose.optional(),
+  workingHours: microsoft_graph_workingHours.optional()
+}).passthrough();
 const microsoft_graph_messageRuleActions = z.object({
   assignCategories: z.array(z.string().nullable()).describe("A list of categories to be assigned to a message.").optional(),
   copyToFolder: z.string().describe("The ID of a folder that a message is to be copied to.").nullish(),
@@ -3797,6 +3855,15 @@ const schemas = {
   microsoft_graph_teamsAsyncOperation,
   microsoft_graph_team,
   microsoft_graph_teamCollectionResponse,
+  microsoft_graph_externalAudienceScope,
+  microsoft_graph_automaticRepliesStatus,
+  microsoft_graph_automaticRepliesSetting,
+  microsoft_graph_delegateMeetingMessageDeliveryOptions,
+  microsoft_graph_localeInfo,
+  microsoft_graph_userPurpose,
+  microsoft_graph_timeZoneBase,
+  microsoft_graph_workingHours,
+  microsoft_graph_mailboxSettings,
   microsoft_graph_messageRuleActions,
   microsoft_graph_messageActionFlag,
   microsoft_graph_messageRulePredicates,
@@ -5575,6 +5642,42 @@ Based on this value, you can better adjust the parameters and call findMeetingTi
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/mailboxSettings",
+    alias: "get-mailbox-settings",
+    description: `Get the user's mailboxSettings. You can view all mailbox settings, or get specific settings. Users can set the following settings for their mailboxes through an Outlook client: Users can set their preferred date and time formats using Outlook on the web. Users can choose one of the supported short date or short time formats. This GET operation returns the format the user has chosen. Users can set the time zone they prefer on any Outlook client, by choosing from the supported time zones that their administrator has set up for their mailbox server. The administrator can set up time zones in the Windows time zone format or  Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default. This GET operation returns the user's preferred time zone in the format that the administrator has set up. If you want that time zone to be in a specific format (Windows or IANA), you can first update the preferred time zone in that format as a mailbox setting. Subsequently you will be able to get the time zone in that format. Alternatively, you can manage the format conversion separately in your app.`,
+    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: "/me/mailboxSettings",
+    alias: "update-mailbox-settings",
+    description: `Enable, configure, or disable one or more of the following settings as part of a user's mailboxSettings: When updating the preferred date or time format for a user, specify it in respectively, the short date or short time format. When updating the preferred time zone for a user, specify it in the Windows or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. You can also further customize the time zone as shown in example 2 below.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New property values`,
+        type: "Body",
+        schema: microsoft_graph_mailboxSettings
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/mailFolders",

package/logs/mcp-server.log

@@ -1,10 +1,10 @@
-2026-03-31 07:55:43 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-31 07:55:43 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-31 07:55:43 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-31 07:55:43 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
-2026-03-31 07:55:43 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
-2026-03-31 07:55:44 INFO: Using environment variables for secrets
-2026-03-31 07:55:44 INFO: Using environment variables for secrets
-2026-03-31 07:55:44 INFO: Using environment variables for secrets
-2026-03-31 07:55:44 INFO: Using environment variables for secrets
-2026-03-31 07:55:44 INFO: Using environment variables for secrets
+2026-03-31 08:27:22 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-31 08:27:22 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-31 08:27:22 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-31 08:27:22 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
+2026-03-31 08:27:22 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
+2026-03-31 08:27:23 INFO: Using environment variables for secrets
+2026-03-31 08:27:23 INFO: Using environment variables for secrets
+2026-03-31 08:27:23 INFO: Using environment variables for secrets
+2026-03-31 08:27:23 INFO: Using environment variables for secrets
+2026-03-31 08:27:23 INFO: Using environment variables for secrets

package/package.json

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

@@ -565,6 +565,20 @@
     "toolName": "get-current-user",
     "scopes": ["User.Read"]
   },
+  {
+    "pathPattern": "/me/mailboxSettings",
+    "method": "get",
+    "toolName": "get-mailbox-settings",
+    "scopes": ["MailboxSettings.Read"],
+    "llmTip": "Gets the current user's mailbox settings including automaticRepliesSetting (out-of-office status, message, scheduledStartDateTime/EndDateTime, externalAudience), language, timeZone, dateFormat, timeFormat, delegateMeetingMessageDeliveryOptions, and userPurpose."
+  },
+  {
+    "pathPattern": "/me/mailboxSettings",
+    "method": "patch",
+    "toolName": "update-mailbox-settings",
+    "scopes": ["MailboxSettings.ReadWrite"],
+    "llmTip": "Updates mailbox settings. Common use: configure Out-of-Office (automatic replies). Body example: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Status values: disabled, alwaysEnabled, scheduled."
+  },
   {
     "pathPattern": "/me/chats",
     "method": "get",