@softeria/ms-365-mcp-server 0.99.1 → 0.101.0

package/dist/endpoints.json

@@ -1875,5 +1875,55 @@
     "toolName": "create-outlook-category",
     "scopes": ["MailboxSettings.ReadWrite"],
     "llmTip": "Creates a new Outlook category. Body: { displayName (unique), color (one of: none, preset0 … preset24 — maps to red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Category names are case-sensitive when applied to messages/events."
+  },
+  {
+    "pathPattern": "/me/getMailTips",
+    "method": "post",
+    "toolName": "get-mail-tips",
+    "scopes": ["Mail.Read"],
+    "contentType": "application/json",
+    "llmTip": "Looks up MailTips for one or more recipients before sending an email — answers 'is this person on auto-reply / OOF?', 'will my email exceed their mailbox quota?', 'are they an external recipient?', 'is this a mailbox or distribution list?'. Body: { EmailAddresses: ['user@contoso.com', ...] (max 100), MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (comma-separated subset) }. Returns mailTips per recipient with the requested fields populated. Use this to short-circuit urgent emails when a recipient is OOF, or to warn before fanning out to a large DL."
+  },
+  {
+    "pathPattern": "/me/outlook/supportedTimeZones(TimeZoneStandard='{TimeZoneStandard}')",
+    "method": "get",
+    "toolName": "list-supported-time-zones",
+    "scopes": ["User.Read"],
+    "llmTip": "Lists time zones the user's mailbox server supports. TimeZoneStandard path parameter must be one of: 'windows' (default — Windows time zone names like 'Pacific Standard Time'), or 'iana' (IANA / Olson names like 'America/Los_Angeles'). Returns timeZoneInformation objects with alias and displayName. Use the result to validate or look up the value before calling update-mailbox-settings to change the user's preferred timeZone — the format must match what the server expects."
+  },
+  {
+    "pathPattern": "/me/outlook/supportedLanguages()",
+    "method": "get",
+    "toolName": "list-supported-languages",
+    "scopes": ["User.Read"],
+    "llmTip": "Lists locales and languages the user's mailbox server supports for the Outlook UI and message rendering. Returns localeInfo objects with locale (e.g. 'en-US'), displayName ('English (United States)'), and nativeName ('English (United States)'). Use this to validate the locale value before calling update-mailbox-settings to change the user's preferred language."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions",
+    "method": "get",
+    "toolName": "list-my-calendar-permissions",
+    "scopes": ["Calendars.Read"],
+    "llmTip": "Lists share recipients and delegates on the user's primary calendar. Returns calendarPermission objects with id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Returns an empty collection when called by a delegate or share recipient (only the calendar owner sees the full list). For a non-primary calendar, use /me/calendars/{calendar-id}/calendarPermissions — not currently exposed."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions",
+    "method": "post",
+    "toolName": "create-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Shares the user's primary calendar with another user (or sets up a delegate). Body: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Use list-users to resolve the recipient SMTP. Returns the created calendarPermission with its id (used by update-my-calendar-permission and delete-my-calendar-permission)."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions/{calendarPermission-id}",
+    "method": "patch",
+    "toolName": "update-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Changes the role (permission level) granted to an existing share recipient or delegate. Body: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Only the role property is writable — to change the recipient's email or other properties, delete and recreate via delete-my-calendar-permission + create-my-calendar-permission. Get the permission id via list-my-calendar-permissions."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions/{calendarPermission-id}",
+    "method": "delete",
+    "toolName": "delete-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error."
   }
 ]

package/dist/generated/client.js

@@ -1850,6 +1850,35 @@ const microsoft_graph_conversationThreadCollectionResponse = z.object({
   value: z.array(microsoft_graph_conversationThread)
 }).partial().passthrough();
 const reply_to_group_thread_Body = z.object({ Post: microsoft_graph_post }).partial().passthrough();
+const microsoft_graph_calendarRoleType = z.enum([
+  "none",
+  "freeBusyRead",
+  "limitedRead",
+  "read",
+  "write",
+  "delegateWithoutPrivateEventAccess",
+  "delegateWithPrivateEventAccess",
+  "custom"
+]);
+const microsoft_graph_calendarPermission = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedRoles: z.array(z.union([microsoft_graph_calendarRoleType, z.object({}).partial().passthrough()])).describe(
+    "List of allowed sharing or delegating permission levels for the calendar. The possible values are: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom."
+  ).optional(),
+  emailAddress: microsoft_graph_emailAddress.optional(),
+  isInsideOrganization: z.boolean().describe(
+    "True if the user in context (recipient or delegate) is inside the same organization as the calendar owner."
+  ).nullish(),
+  isRemovable: z.boolean().describe(
+    "True if the user can be removed from the list of recipients or delegates for the specified calendar, false otherwise. The 'My organization' user determines the permissions other people within your organization have to the given calendar. You can't remove 'My organization' as a share recipient to a calendar."
+  ).nullish(),
+  role: microsoft_graph_calendarRoleType.optional()
+}).passthrough();
+const microsoft_graph_calendarPermissionCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_calendarPermission)
+}).partial().passthrough();
 const get_schedule_Body = z.object({
   Schedules: z.array(z.string().nullable()),
   EndTime: z.union([microsoft_graph_dateTimeTimeZone, z.object({}).partial().passthrough()]),
@@ -1913,30 +1942,6 @@ const microsoft_graph_calendarColor = z.enum([
   "lightRed",
   "maxColor"
 ]);
-const microsoft_graph_calendarRoleType = z.enum([
-  "none",
-  "freeBusyRead",
-  "limitedRead",
-  "read",
-  "write",
-  "delegateWithoutPrivateEventAccess",
-  "delegateWithPrivateEventAccess",
-  "custom"
-]);
-const microsoft_graph_calendarPermission = z.object({
-  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
-  allowedRoles: z.array(z.union([microsoft_graph_calendarRoleType, z.object({}).partial().passthrough()])).describe(
-    "List of allowed sharing or delegating permission levels for the calendar. The possible values are: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom."
-  ).optional(),
-  emailAddress: microsoft_graph_emailAddress.optional(),
-  isInsideOrganization: z.boolean().describe(
-    "True if the user in context (recipient or delegate) is inside the same organization as the calendar owner."
-  ).nullish(),
-  isRemovable: z.boolean().describe(
-    "True if the user can be removed from the list of recipients or delegates for the specified calendar, false otherwise. The 'My organization' user determines the permissions other people within your organization have to the given calendar. You can't remove 'My organization' as a share recipient to a calendar."
-  ).nullish(),
-  role: microsoft_graph_calendarRoleType.optional()
-}).passthrough();
 const microsoft_graph_calendar = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
   allowedOnlineMeetingProviders: z.array(z.union([microsoft_graph_onlineMeetingProviderType, z.object({}).partial().passthrough()])).describe(
@@ -3153,6 +3158,22 @@ const find_meeting_times_Body = z.object({
   returnSuggestionReasons: z.boolean().nullable().default(false),
   minimumAttendeePercentage: z.union([z.number(), z.string(), ReferenceNumeric])
 }).partial().passthrough();
+const microsoft_graph_mailTipsType = z.enum([
+  "automaticReplies",
+  "mailboxFullStatus",
+  "customMailTip",
+  "externalMemberCount",
+  "totalMemberCount",
+  "maxMessageSize",
+  "deliveryRestriction",
+  "moderationStatus",
+  "recipientScope",
+  "recipientSuggestions"
+]);
+const get_mail_tips_Body = z.object({
+  EmailAddresses: z.array(z.string()),
+  MailTipsOptions: z.union([microsoft_graph_mailTipsType, z.object({}).partial().passthrough()])
+}).partial().passthrough();
 const send_mail_Body = z.object({
   Message: microsoft_graph_message.describe(
     "[Note: Simplified from 35 properties to 25 most common ones]"
@@ -3547,6 +3568,10 @@ const microsoft_graph_outlookCategoryCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_outlookCategory)
 }).partial().passthrough();
+const microsoft_graph_timeZoneInformation = z.object({
+  alias: z.string().describe("An identifier for the time zone.").nullish(),
+  displayName: z.string().describe("A display string that represents the time zone.").nullish()
+}).passthrough();
 const microsoft_graph_personType = z.object({
   class: z.string().describe("The type of data source, such as Person.").nullish(),
   subclass: z.string().describe("The secondary type of data source, such as OrganizationUser.").nullish()
@@ -4696,6 +4721,9 @@ const schemas = {
   ReferenceCreate,
   microsoft_graph_conversationThreadCollectionResponse,
   reply_to_group_thread_Body,
+  microsoft_graph_calendarRoleType,
+  microsoft_graph_calendarPermission,
+  microsoft_graph_calendarPermissionCollectionResponse,
   get_schedule_Body,
   microsoft_graph_freeBusyError,
   microsoft_graph_scheduleItem,
@@ -4704,8 +4732,6 @@ const schemas = {
   microsoft_graph_scheduleInformation,
   microsoft_graph_onlineMeetingProviderType,
   microsoft_graph_calendarColor,
-  microsoft_graph_calendarRoleType,
-  microsoft_graph_calendarPermission,
   microsoft_graph_calendar,
   microsoft_graph_calendarCollectionResponse,
   microsoft_graph_chatCollectionResponse,
@@ -4819,6 +4845,8 @@ const schemas = {
   microsoft_graph_activityDomain,
   microsoft_graph_timeConstraint,
   find_meeting_times_Body,
+  microsoft_graph_mailTipsType,
+  get_mail_tips_Body,
   send_mail_Body,
   microsoft_graph_externalLink,
   microsoft_graph_notebookLinks,
@@ -4856,6 +4884,7 @@ const schemas = {
   microsoft_graph_categoryColor,
   microsoft_graph_outlookCategory,
   microsoft_graph_outlookCategoryCollectionResponse,
+  microsoft_graph_timeZoneInformation,
   microsoft_graph_personType,
   microsoft_graph_phoneType,
   microsoft_graph_phone,
@@ -7132,6 +7161,103 @@ from the default calendar of a group.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/calendar/calendarPermissions",
+    alias: "list-my-calendar-permissions",
+    description: `The permissions of the users with whom the calendar is shared.`,
+    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: "/me/calendar/calendarPermissions",
+    alias: "create-my-calendar-permission",
+    description: `Create a calendarPermission resource to specify the identity and role of the user with whom the specified calendar is being shared or delegated.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_calendarPermission
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "patch",
+    path: "/me/calendar/calendarPermissions/:calendarPermissionId",
+    alias: "update-my-calendar-permission",
+    description: `Update the navigation property calendarPermissions in me`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property values`,
+        type: "Body",
+        schema: microsoft_graph_calendarPermission
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/me/calendar/calendarPermissions/:calendarPermissionId",
+    alias: "delete-my-calendar-permission",
+    description: `Delete navigation property calendarPermissions for me`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/me/calendar/getSchedule",
@@ -8574,6 +8700,23 @@ Based on this value, you can better adjust the parameters and call findMeetingTi
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/me/getMailTips",
+    alias: "get-mail-tips",
+    description: `Get the MailTips of one or more recipients as available to the signed-in user. Note that by making a POST call to the getMailTips action, you can request specific types of MailTips to
+be returned for more than one recipient at one time. The requested MailTips are returned in a mailTips collection.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: get_mail_tips_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/inferenceClassification/overrides",
@@ -10577,6 +10720,78 @@ resource.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/outlook/supportedLanguages()",
+    alias: "list-supported-languages",
+    description: `Get the list of locales and languages that are supported for the user, as configured on the user's mailbox server. When setting up an Outlook client, the user selects the preferred language from this supported list. You can subsequently get the preferred language by
+getting the user's mailbox settings.`,
+    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()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: `/me/outlook/supportedTimeZones(TimeZoneStandard=':TimeZoneStandard')`,
+    alias: "list-supported-time-zones",
+    description: `Get the list of time zones that are supported for the user, as configured on the user's mailbox server. You can explicitly specify to have time zones returned 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. When setting up an Outlook client, the user selects the preferred time zone from this supported list. You can subsequently get the preferred time zone by
+getting the user's mailbox settings.`,
+    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()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/people",

package/package.json

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

@@ -1875,5 +1875,55 @@
     "toolName": "create-outlook-category",
     "scopes": ["MailboxSettings.ReadWrite"],
     "llmTip": "Creates a new Outlook category. Body: { displayName (unique), color (one of: none, preset0 … preset24 — maps to red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Category names are case-sensitive when applied to messages/events."
+  },
+  {
+    "pathPattern": "/me/getMailTips",
+    "method": "post",
+    "toolName": "get-mail-tips",
+    "scopes": ["Mail.Read"],
+    "contentType": "application/json",
+    "llmTip": "Looks up MailTips for one or more recipients before sending an email — answers 'is this person on auto-reply / OOF?', 'will my email exceed their mailbox quota?', 'are they an external recipient?', 'is this a mailbox or distribution list?'. Body: { EmailAddresses: ['user@contoso.com', ...] (max 100), MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (comma-separated subset) }. Returns mailTips per recipient with the requested fields populated. Use this to short-circuit urgent emails when a recipient is OOF, or to warn before fanning out to a large DL."
+  },
+  {
+    "pathPattern": "/me/outlook/supportedTimeZones(TimeZoneStandard='{TimeZoneStandard}')",
+    "method": "get",
+    "toolName": "list-supported-time-zones",
+    "scopes": ["User.Read"],
+    "llmTip": "Lists time zones the user's mailbox server supports. TimeZoneStandard path parameter must be one of: 'windows' (default — Windows time zone names like 'Pacific Standard Time'), or 'iana' (IANA / Olson names like 'America/Los_Angeles'). Returns timeZoneInformation objects with alias and displayName. Use the result to validate or look up the value before calling update-mailbox-settings to change the user's preferred timeZone — the format must match what the server expects."
+  },
+  {
+    "pathPattern": "/me/outlook/supportedLanguages()",
+    "method": "get",
+    "toolName": "list-supported-languages",
+    "scopes": ["User.Read"],
+    "llmTip": "Lists locales and languages the user's mailbox server supports for the Outlook UI and message rendering. Returns localeInfo objects with locale (e.g. 'en-US'), displayName ('English (United States)'), and nativeName ('English (United States)'). Use this to validate the locale value before calling update-mailbox-settings to change the user's preferred language."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions",
+    "method": "get",
+    "toolName": "list-my-calendar-permissions",
+    "scopes": ["Calendars.Read"],
+    "llmTip": "Lists share recipients and delegates on the user's primary calendar. Returns calendarPermission objects with id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Returns an empty collection when called by a delegate or share recipient (only the calendar owner sees the full list). For a non-primary calendar, use /me/calendars/{calendar-id}/calendarPermissions — not currently exposed."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions",
+    "method": "post",
+    "toolName": "create-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Shares the user's primary calendar with another user (or sets up a delegate). Body: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Use list-users to resolve the recipient SMTP. Returns the created calendarPermission with its id (used by update-my-calendar-permission and delete-my-calendar-permission)."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions/{calendarPermission-id}",
+    "method": "patch",
+    "toolName": "update-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Changes the role (permission level) granted to an existing share recipient or delegate. Body: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Only the role property is writable — to change the recipient's email or other properties, delete and recreate via delete-my-calendar-permission + create-my-calendar-permission. Get the permission id via list-my-calendar-permissions."
+  },
+  {
+    "pathPattern": "/me/calendar/calendarPermissions/{calendarPermission-id}",
+    "method": "delete",
+    "toolName": "delete-my-calendar-permission",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error."
   }
 ]