@softeria/ms-365-mcp-server 0.16.0 → 0.18.0

package/README.md

@@ -71,6 +71,13 @@ get-sharepoint-site-drive-by-id, list-sharepoint-site-items, get-sharepoint-site
 get-sharepoint-site-list, list-sharepoint-site-list-items, get-sharepoint-site-list-item,
 get-sharepoint-sites-delta</sub>
 
+**Shared Mailboxes**  
+<sub>list-shared-mailbox-messages, list-shared-mailbox-folder-messages, get-shared-mailbox-message,
+send-shared-mailbox-mail</sub>
+
+**User Management**  
+<sub>list-users</sub>
+
 ## Organization/Work Mode
 
 To access work/school features (Teams, SharePoint, etc.), enable organization mode using any of these flags:
@@ -89,6 +96,20 @@ To access work/school features (Teams, SharePoint, etc.), enable organization mo
 Organization mode must be enabled from the start to access work account features. Without this flag, only personal
 account features (email, calendar, OneDrive, etc.) are available.
 
+## Shared Mailbox Access
+
+To access shared mailboxes, you need:
+
+1. **Organization mode**: Shared mailbox tools require `--org-mode` flag (work/school accounts only)
+2. **Delegated permissions**: `Mail.Read.Shared` or `Mail.Send.Shared` scopes
+3. **Exchange permissions**: The signed-in user must have been granted access to the shared mailbox
+4. **Usage**: Use the shared mailbox's email address as the `user-id` parameter in the shared mailbox tools
+
+**Finding shared mailboxes**: Use the `list-users` tool to discover available users and shared mailboxes in your
+organization.
+
+Example: `list-shared-mailbox-messages` with `user-id` set to `shared-mailbox@company.com`
+
 ## Quick Start Example
 
 Test login in Claude Desktop:

package/bin/modules/simplified-openapi.mjs

@@ -389,6 +389,13 @@ function findUsedSchemas(openApiSpec) {
             const schemaName = content.schema.$ref.replace('#/components/schemas/', '');
             schemasToProcess.push(schemaName);
           }
+          if (content.schema?.properties?.requests?.items?.$ref) {
+            const schemaName = content.schema.properties.requests.items.$ref.replace(
+              '#/components/schemas/',
+              ''
+            );
+            schemasToProcess.push(schemaName);
+          }
         });
       }
 
@@ -413,6 +420,21 @@ function findUsedSchemas(openApiSpec) {
                 const schemaName = content.schema.$ref.replace('#/components/schemas/', '');
                 schemasToProcess.push(schemaName);
               }
+              if (content.schema?.allOf) {
+                content.schema.allOf.forEach((allOfItem) => {
+                  if (allOfItem.$ref) {
+                    const schemaName = allOfItem.$ref.replace('#/components/schemas/', '');
+                    schemasToProcess.push(schemaName);
+                  }
+                  if (allOfItem.properties?.value?.items?.$ref) {
+                    const schemaName = allOfItem.properties.value.items.$ref.replace(
+                      '#/components/schemas/',
+                      ''
+                    );
+                    schemasToProcess.push(schemaName);
+                  }
+                });
+              }
             });
           }
         });

package/dist/endpoints.json

@@ -29,6 +29,36 @@
     "toolName": "send-mail",
     "scopes": ["Mail.Send"]
   },
+  {
+    "pathPattern": "/users/{user-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-messages",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/mailFolders/{mailFolder-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-folder-messages",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/messages/{message-id}",
+    "method": "get",
+    "toolName": "get-shared-mailbox-message",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/sendMail",
+    "method": "post",
+    "toolName": "send-shared-mailbox-mail",
+    "workScopes": ["Mail.Send.Shared"]
+  },
+  {
+    "pathPattern": "/users",
+    "method": "get",
+    "toolName": "list-users",
+    "workScopes": ["User.Read.All"]
+  },
   {
     "pathPattern": "/me/messages",
     "method": "post",

package/dist/generated/client.js

@@ -355,7 +355,7 @@ const microsoft_graph_teamsTab = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
   configuration: microsoft_graph_teamsTabConfiguration.optional(),
   displayName: z.string().describe("Name of the tab.").nullish(),
-  webUrl: z.string().describe("Deep link URL of the tab instance. Read only.").nullish(),
+  webUrl: z.string().describe("Deep link URL of the tab instance. Read-only.").nullish(),
   teamsApp: microsoft_graph_teamsApp.optional()
 }).strict();
 const microsoft_graph_chat = z.object({
@@ -2805,7 +2805,203 @@ const microsoft_graph_plannerPlan = z.object({
   details: microsoft_graph_plannerPlanDetails.optional(),
   tasks: z.array(microsoft_graph_plannerTask).describe("Read-only. Nullable. Collection of tasks in the plan.").optional()
 }).strict();
-const search_query_Body = z.object({ requests: z.array(z.object({}).partial().strict()) }).partial().strict();
+const microsoft_graph_bucketAggregationRange = z.object({
+  from: z.string().describe(
+    "Defines the lower bound from which to compute the aggregation. This can be a numeric value or a string representation of a date using the YYYY-MM-DDTHH:mm:ss.sssZ format. Required."
+  ).optional(),
+  to: z.string().describe(
+    "Defines the upper bound up to which to compute the aggregation. This can be a numeric value or a string representation of a date using the YYYY-MM-DDTHH:mm:ss.sssZ format. Required."
+  ).optional()
+}).strict();
+const microsoft_graph_bucketAggregationSortProperty = z.enum([
+  "count",
+  "keyAsString",
+  "keyAsNumber",
+  "unknownFutureValue"
+]);
+const microsoft_graph_bucketAggregationDefinition = z.object({
+  isDescending: z.boolean().describe(
+    "True to specify the sort order as descending. The default is false, with the sort order as ascending. Optional."
+  ).nullish(),
+  minimumCount: z.number().gte(-2147483648).lte(2147483647).describe(
+    "The minimum number of items that should be present in the aggregation to be returned in a bucket. Optional."
+  ).nullish(),
+  prefixFilter: z.string().describe(
+    "A filter to define a matching criteria. The key should start with the specified prefix to be returned in the response. Optional."
+  ).nullish(),
+  ranges: z.array(microsoft_graph_bucketAggregationRange).describe(
+    "Specifies the manual ranges to compute the aggregations. This is only valid for nonstring refiners of date or numeric type. Optional."
+  ).optional(),
+  sortBy: microsoft_graph_bucketAggregationSortProperty.optional()
+}).strict();
+const microsoft_graph_aggregationOption = z.object({
+  bucketDefinition: microsoft_graph_bucketAggregationDefinition.optional(),
+  field: z.string().describe(
+    "Computes aggregation on the field while the field exists in the current entity type. Required."
+  ).optional(),
+  size: z.number().gte(-2147483648).lte(2147483647).describe(
+    "The number of searchBucket resources to be returned. This isn't required when the range is provided manually in the search request. The minimum accepted size is 1, and the maximum is 65535. Optional."
+  ).nullish()
+}).strict();
+const microsoft_graph_collapseProperty = z.object({
+  fields: z.array(z.string()).describe(
+    "Defines the collapse group to trim results. The properties in this collection must be sortable/refinable properties. Required."
+  ).optional(),
+  limit: z.number().gte(-32768).lte(32767).describe(
+    "Defines a maximum limit count for this field. This numeric value must be a positive integer. Required."
+  ).optional()
+}).strict();
+const microsoft_graph_entityType = z.enum([
+  "event",
+  "message",
+  "driveItem",
+  "externalItem",
+  "site",
+  "list",
+  "listItem",
+  "drive",
+  "unknownFutureValue",
+  "chatMessage",
+  "person",
+  "acronym",
+  "bookmark"
+]);
+const microsoft_graph_searchQuery = z.object({
+  queryString: z.string().describe("The search query containing the search terms. Required.").optional(),
+  queryTemplate: z.string().describe(
+    "Provides a way to decorate the query string. Supports both KQL and query variables. Optional."
+  ).nullish()
+}).strict();
+const microsoft_graph_searchAlterationOptions = z.object({
+  enableModification: z.boolean().describe(
+    "Indicates whether spelling modifications are enabled. If enabled, the user gets the search results for the corrected query if there were no results for the original query with typos. The response will also include the spelling modification information in the queryAlterationResponse property. Optional."
+  ).nullish(),
+  enableSuggestion: z.boolean().describe(
+    "Indicates whether spelling suggestions are enabled. If enabled, the user gets the search results for the original search query and suggestions for spelling correction in the queryAlterationResponse property of the response for the typos in the query. Optional."
+  ).nullish()
+}).strict();
+const microsoft_graph_resultTemplateOption = z.object({
+  enableResultTemplate: z.boolean().describe(
+    "Indicates whether search display layouts are enabled. If enabled, the user will get the result template to render the search results content in the resultTemplates property of the response. The result template is based on Adaptive Cards. Optional."
+  ).nullish()
+}).strict();
+const microsoft_graph_searchContent = z.enum([
+  "sharedContent",
+  "privateContent",
+  "unknownFutureValue"
+]);
+const microsoft_graph_sharePointOneDriveOptions = z.object({ includeContent: microsoft_graph_searchContent.optional() }).strict();
+const microsoft_graph_sortProperty = z.object({
+  isDescending: z.boolean().describe(
+    "True if the sort order is descending. Default is false, with the sort order as ascending. Optional."
+  ).nullish(),
+  name: z.string().describe("The name of the property to sort on. Required.").optional()
+}).strict();
+const microsoft_graph_searchRequest = z.object({
+  aggregationFilters: z.array(z.string().nullable()).describe(
+    "Contains one or more filters to obtain search results aggregated and filtered to a specific value of a field. Optional.Build this filter based on a prior search that aggregates by the same field. From the response of the prior search, identify the searchBucket that filters results to the specific value of the field, use the string in its aggregationFilterToken property, and build an aggregation filter string in the format '{field}:/'{aggregationFilterToken}/''. If multiple values for the same field need to be provided, use the strings in its aggregationFilterToken property and build an aggregation filter string in the format '{field}:or(/'{aggregationFilterToken1}/',/'{aggregationFilterToken2}/')'. For example, searching and aggregating drive items by file type returns a searchBucket for the file type docx in the response. You can conveniently use the aggregationFilterToken returned for this searchBucket in a subsequent search query and filter matches down to drive items of the docx file type. Example 1 and example 2 show the actual requests and responses."
+  ).optional(),
+  aggregations: z.array(microsoft_graph_aggregationOption).describe(
+    "Specifies aggregations (also known as refiners) to be returned alongside search results. Optional."
+  ).optional(),
+  collapseProperties: z.array(microsoft_graph_collapseProperty).describe(
+    "Contains the ordered collection of fields and limit to collapse results. Optional."
+  ).optional(),
+  contentSources: z.array(z.string().nullable()).describe("Contains the connection to be targeted.").optional(),
+  enableTopResults: z.boolean().describe(
+    "This triggers hybrid sort for messages : the first 3 messages are the most relevant. This property is only applicable to entityType=message. Optional."
+  ).nullish(),
+  entityTypes: z.array(z.union([microsoft_graph_entityType, z.object({}).partial().strict()])).describe(
+    "One or more types of resources expected in the response. Possible values are: event, message, driveItem, externalItem, site, list, listItem, drive, chatMessage, person, acronym, bookmark.  Use the Prefer: include-unknown-enum-members request header to get the following value(s) in this evolvable enum: chatMessage, person, acronym, bookmark. See known limitations for those combinations of two or more entity types that are supported in the same search request. Required."
+  ).optional(),
+  fields: z.array(z.string().nullable()).describe(
+    "Contains the fields to be returned for each resource object specified in entityTypes, allowing customization of the fields returned by default; otherwise, including additional fields such as custom managed properties from SharePoint and OneDrive, or custom fields in externalItem from the content that Microsoft 365 Copilot connectors bring in. The fields property can use the semantic labels applied to properties. For example, if a property is labeled as title, you can retrieve it using the following syntax: label_title. Optional."
+  ).optional(),
+  from: z.number().gte(-2147483648).lte(2147483647).describe(
+    "Specifies the offset for the search results. Offset 0 returns the very first result. Optional."
+  ).optional(),
+  query: microsoft_graph_searchQuery.optional(),
+  queryAlterationOptions: microsoft_graph_searchAlterationOptions.optional(),
+  region: z.string().describe(
+    "The geographic location for the search. Required for searches that use application permissions. For details, see Get the region value."
+  ).nullish(),
+  resultTemplateOptions: microsoft_graph_resultTemplateOption.optional(),
+  sharePointOneDriveOptions: microsoft_graph_sharePointOneDriveOptions.optional(),
+  size: z.number().gte(-2147483648).lte(2147483647).describe("The size of the page to be retrieved. The maximum value is 500. Optional.").optional(),
+  sortProperties: z.array(microsoft_graph_sortProperty).describe(
+    "Contains the ordered collection of fields and direction to sort results. There can be at most 5 sort properties in the collection. Optional."
+  ).optional()
+}).strict();
+const search_query_Body = z.object({ requests: z.array(microsoft_graph_searchRequest) }).partial().strict();
+const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().strict();
+const microsoft_graph_searchBucket = z.object({
+  aggregationFilterToken: z.string().describe(
+    "A token containing the encoded filter to aggregate search matches by the specific key value. To use the filter, pass the token as part of the aggregationFilter property in a searchRequest object, in the format '{field}:/'{aggregationFilterToken}/''. See an example."
+  ).nullish(),
+  count: z.number().gte(-2147483648).lte(2147483647).describe(
+    "The approximate number of search matches that share the same value specified in the key property. Note that this number is not the exact number of matches."
+  ).nullish(),
+  key: z.string().describe("The discrete value of the field that an aggregation was computed on.").nullish()
+}).strict();
+const microsoft_graph_searchAggregation = z.object({
+  buckets: z.array(microsoft_graph_searchBucket).optional(),
+  field: z.string().nullish()
+}).strict();
+const microsoft_graph_entity = z.object({ id: z.string().describe("The unique identifier for an entity. Read-only.").optional() }).strict();
+const microsoft_graph_searchHit = z.object({
+  contentSource: z.string().describe("The name of the content source that the externalItem is part of.").nullish(),
+  hitId: z.string().describe(
+    "The internal identifier for the item. The format of the identifier varies based on the entity type. For details, see hitId format."
+  ).nullish(),
+  isCollapsed: z.boolean().describe(
+    "Indicates whether the current result is collapsed when the collapseProperties property in the searchRequest is used."
+  ).nullish(),
+  rank: z.number().gte(-2147483648).lte(2147483647).describe("The rank or the order of the result.").nullish(),
+  resultTemplateId: z.string().describe(
+    "ID of the result template used to render the search result. This ID must map to a display layout in the resultTemplates dictionary that is also included in the searchResponse."
+  ).nullish(),
+  summary: z.string().describe("A summary of the result, if a summary is available.").nullish(),
+  resource: microsoft_graph_entity.optional()
+}).strict();
+const microsoft_graph_searchHitsContainer = z.object({
+  aggregations: z.array(microsoft_graph_searchAggregation).optional(),
+  hits: z.array(microsoft_graph_searchHit).describe("A collection of the search results.").optional(),
+  moreResultsAvailable: z.boolean().describe(
+    "Provides information if more results are available. Based on this information, you can adjust the from and size properties of the searchRequest accordingly."
+  ).nullish(),
+  total: z.number().gte(-2147483648).lte(2147483647).describe(
+    "The total number of results. Note this isn't the number of results on the page, but the total number of results satisfying the query."
+  ).nullish()
+}).strict();
+const microsoft_graph_alteredQueryToken = z.object({
+  length: z.number().gte(-2147483648).lte(2147483647).describe("Defines the length of a changed segment.").nullish(),
+  offset: z.number().gte(-2147483648).lte(2147483647).describe("Defines the offset of a changed segment.").nullish(),
+  suggestion: z.string().describe("Represents the corrected segment string.").nullish()
+}).strict();
+const microsoft_graph_searchAlteration = z.object({
+  alteredHighlightedQueryString: z.string().describe(
+    "Defines the altered highlighted query string with spelling correction. The annotation around the corrected segment is: /ue000, /ue001."
+  ).nullish(),
+  alteredQueryString: z.string().describe("Defines the altered query string with spelling correction.").nullish(),
+  alteredQueryTokens: z.array(microsoft_graph_alteredQueryToken).describe("Represents changed segments related to an original user query.").optional()
+}).strict();
+const microsoft_graph_searchAlterationType = z.enum([
+  "suggestion",
+  "modification",
+  "unknownFutureValue"
+]);
+const microsoft_graph_alterationResponse = z.object({
+  originalQueryString: z.string().describe("Defines the original user query string.").nullish(),
+  queryAlteration: microsoft_graph_searchAlteration.optional(),
+  queryAlterationType: microsoft_graph_searchAlterationType.optional()
+}).strict();
+const microsoft_graph_resultTemplateDictionary = z.object({}).strict();
+const microsoft_graph_searchResponse = z.object({
+  hitsContainers: z.array(microsoft_graph_searchHitsContainer).describe("A collection of search results.").optional(),
+  queryAlterationResponse: microsoft_graph_alterationResponse.optional(),
+  resultTemplates: microsoft_graph_resultTemplateDictionary.optional(),
+  searchTerms: z.array(z.string().nullable()).describe("Contains the search terms sent in the initial search query.").optional()
+}).strict();
 const microsoft_graph_root = z.object({}).strict();
 const microsoft_graph_siteArchiveStatus = z.enum([
   "recentlyArchived",
@@ -2897,6 +3093,7 @@ const microsoft_graph_listItemCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_listItem)
 }).partial().strict();
+const BaseDeltaFunctionResponse = z.object({ "@odata.nextLink": z.string().nullable(), "@odata.deltaLink": z.string().nullable() }).partial().strict();
 const microsoft_graph_channelCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -2907,6 +3104,11 @@ const microsoft_graph_conversationMemberCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_conversationMember)
 }).partial().strict();
+const microsoft_graph_userCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_user)
+}).partial().strict();
 const schemas = {
   microsoft_graph_chatType,
   microsoft_graph_teamworkUserIdentityType,
@@ -3186,7 +3388,32 @@ const schemas = {
   microsoft_graph_plannerUserIds,
   microsoft_graph_plannerPlanDetails,
   microsoft_graph_plannerPlan,
+  microsoft_graph_bucketAggregationRange,
+  microsoft_graph_bucketAggregationSortProperty,
+  microsoft_graph_bucketAggregationDefinition,
+  microsoft_graph_aggregationOption,
+  microsoft_graph_collapseProperty,
+  microsoft_graph_entityType,
+  microsoft_graph_searchQuery,
+  microsoft_graph_searchAlterationOptions,
+  microsoft_graph_resultTemplateOption,
+  microsoft_graph_searchContent,
+  microsoft_graph_sharePointOneDriveOptions,
+  microsoft_graph_sortProperty,
+  microsoft_graph_searchRequest,
   search_query_Body,
+  BaseCollectionPaginationCountResponse,
+  microsoft_graph_searchBucket,
+  microsoft_graph_searchAggregation,
+  microsoft_graph_entity,
+  microsoft_graph_searchHit,
+  microsoft_graph_searchHitsContainer,
+  microsoft_graph_alteredQueryToken,
+  microsoft_graph_searchAlteration,
+  microsoft_graph_searchAlterationType,
+  microsoft_graph_alterationResponse,
+  microsoft_graph_resultTemplateDictionary,
+  microsoft_graph_searchResponse,
   microsoft_graph_root,
   microsoft_graph_siteArchiveStatus,
   microsoft_graph_siteArchivalDetails,
@@ -3197,8 +3424,10 @@ const schemas = {
   microsoft_graph_baseItemCollectionResponse,
   microsoft_graph_listCollectionResponse,
   microsoft_graph_listItemCollectionResponse,
+  BaseDeltaFunctionResponse,
   microsoft_graph_channelCollectionResponse,
-  microsoft_graph_conversationMemberCollectionResponse
+  microsoft_graph_conversationMemberCollectionResponse,
+  microsoft_graph_userCollectionResponse
 };
 const endpoints = makeApi([
   {
@@ -3938,7 +4167,7 @@ const endpoints = makeApi([
     method: "get",
     path: "/me",
     alias: "get-current-user",
-    description: `Retrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance. Customers through Microsoft Entra ID for customers can also use this API operation to retrieve their details.`,
+    description: `Returns the user or organizational contact assigned as the user's manager. Optionally, you can expand the manager's chain up to the root node.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5435,7 +5664,11 @@ or their delegates can book a private meeting room. If you're organizing an
     method: "post",
     path: "/me/messages",
     alias: "create-draft-email",
-    description: `Create an open extension (openTypeExtension object) and add custom properties in a new or existing instance of a resource. You can create an open extension in a resource instance and store custom data to it all in the same operation, except for specific resources. The table in the Permissions section lists the resources that support open extensions.`,
+    description: `Create a draft of a new message in either JSON or MIME format. When using JSON format, you can:
+- Include an attachment to the message.
+- Update the draft later to add content to the body or change other message properties. When using MIME format:
+- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.
+- /* Add any attachments and S/MIME properties to the MIME content. By default, this operation saves the draft in the Drafts folder. Send the draft message in a subsequent operation. Alternatively, send a new message in a single operation, or create a draft to forward, reply and reply-all to an existing message.`,
     requestFormat: "json",
     parameters: [
       {
@@ -5548,13 +5781,7 @@ or their delegates can book a private meeting room. If you're organizing an
     method: "get",
     path: "/me/messages/:messageId",
     alias: "get-mail-message",
-    description: `You can get a single resource instance expanded with a specific extended property, or a collection of resource instances
-that include extended properties matching a filter. Using the query parameter $expand allows you to get the specified resource instance expanded with a specific extended
-property. Use a $filter and eq operator on the id property to specify the extended property. This is currently the only way to get the singleValueLegacyExtendedProperty object that represents an extended property. To get resource instances that have certain extended properties, use the $filter query parameter and apply an eq operator
-on the id property. In addition, for numeric extended properties, apply one of the following operators on the value property:
-eq, ne,ge, gt, le, or lt. For string-typed extended properties, apply a contains, startswith, eq, or ne operator on value. The filter is applied to all instances of the resource in the signed-in user's mailbox. Filtering the string name (Name) in the id of an extended property is case-sensitive. Filtering the value property of an extended
-property is case-insensitive. The following user resources are supported: As well as the following group resources: See Extended properties overview for more information about when to use
-open extensions or extended properties, and how to specify extended properties.`,
+    description: `Get the properties and relationships of the eventMessage object. Apply the $expand parameter on the event navigation property to get the associated event in an attendee's calendar. Currently, this operation returns event message bodies in only HTML format.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6322,7 +6549,7 @@ open extensions or extended properties, and how to specify extended properties.`
     method: "delete",
     path: "/me/todo/lists/:todoTaskListId/tasks/:todoTaskId",
     alias: "delete-todo-task",
-    description: `Deletes a todoTask object.`,
+    description: `Delete a todoTask object.`,
     requestFormat: "json",
     parameters: [
       {
@@ -6904,7 +7131,9 @@ open extensions or extended properties, and how to specify extended properties.`
       {
         status: NaN,
         description: `Success`,
-        schema: z.object({ value: z.array(z.object({}).partial().strict()) }).partial().strict()
+        schema: BaseCollectionPaginationCountResponse.and(
+          z.object({ value: z.array(microsoft_graph_searchResponse) }).partial().strict()
+        )
       },
       {
         status: NaN,
@@ -7596,7 +7825,9 @@ To monitor future changes, call the delta API by using the @odata.deltaLink in t
       {
         status: NaN,
         description: `Success`,
-        schema: z.object({ value: z.array(microsoft_graph_site) }).partial().strict()
+        schema: BaseDeltaFunctionResponse.and(
+          z.object({ value: z.array(microsoft_graph_site) }).partial().strict()
+        )
       },
       {
         status: NaN,
@@ -7992,6 +8223,324 @@ To monitor future changes, call the delta API by using the @odata.deltaLink in t
         schema: microsoft_graph_ODataErrors_ODataError
       }
     ]
+  },
+  {
+    method: "get",
+    path: "/users",
+    alias: "list-users",
+    description: `List properties and relationships of the user objects.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "ConsistencyLevel",
+        type: "Header",
+        schema: z.string().describe(
+          "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries"
+        ).optional()
+      },
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only 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(),
+    errors: [
+      {
+        status: NaN,
+        description: `Retrieved collection`,
+        schema: microsoft_graph_userCollectionResponse
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
+  },
+  {
+    method: "get",
+    path: "/users/:userId/mailFolders/:mailFolderId/messages",
+    alias: "list-shared-mailbox-folder-messages",
+    description: `The collection of messages in the mailFolder.`,
+    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(),
+    errors: [
+      {
+        status: NaN,
+        description: `Retrieved collection`,
+        schema: microsoft_graph_messageCollectionResponse
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
+  },
+  {
+    method: "get",
+    path: "/users/:userId/messages",
+    alias: "list-shared-mailbox-messages",
+    description: `The messages in a mailbox or folder. Read-only. Nullable.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "includeHiddenMessages",
+        type: "Query",
+        schema: z.string().describe("Include Hidden Messages").optional()
+      },
+      {
+        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(),
+    errors: [
+      {
+        status: NaN,
+        description: `Retrieved collection`,
+        schema: microsoft_graph_messageCollectionResponse
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
+  },
+  {
+    method: "get",
+    path: "/users/:userId/messages/:messageId",
+    alias: "get-shared-mailbox-message",
+    description: `The messages in a mailbox or folder. Read-only. Nullable.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "includeHiddenMessages",
+        type: "Query",
+        schema: z.string().describe("Include Hidden Messages").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(),
+    errors: [
+      {
+        status: NaN,
+        description: `Retrieved navigation property`,
+        schema: z.object({
+          body: microsoft_graph_itemBody.optional(),
+          subject: z.string().describe("The subject of the message.").nullish(),
+          bccRecipients: z.array(microsoft_graph_recipient).describe("The Bcc: recipients for the message.").optional(),
+          bodyPreview: z.string().describe("The first 255 characters of the message body. It is in text format.").nullish(),
+          ccRecipients: z.array(microsoft_graph_recipient).describe("The Cc: recipients for the message.").optional(),
+          conversationId: z.string().describe("The ID of the conversation the email belongs to.").nullish(),
+          conversationIndex: z.string().describe("Indicates the position of the message within the conversation.").nullish(),
+          flag: microsoft_graph_followupFlag.optional(),
+          from: microsoft_graph_recipient.optional(),
+          hasAttachments: z.boolean().describe(
+            "Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as <IMG src='cid:image001.jpg@01D26CD8.6C05F070'>."
+          ).nullish(),
+          importance: microsoft_graph_importance.optional(),
+          inferenceClassification: microsoft_graph_inferenceClassificationType.optional(),
+          internetMessageHeaders: z.array(microsoft_graph_internetMessageHeader).describe(
+            "A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message.  Returned only on applying a $select query option. Read-only."
+          ).optional(),
+          internetMessageId: z.string().describe("The message ID in the format specified by RFC2822.").nullish(),
+          isDeliveryReceiptRequested: z.boolean().describe("Indicates whether a read receipt is requested for the message.").nullish(),
+          isDraft: z.boolean().describe(
+            "Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet."
+          ).nullish(),
+          isRead: z.boolean().describe("Indicates whether the message has been read.").nullish(),
+          isReadReceiptRequested: z.boolean().describe("Indicates whether a read receipt is requested for the message.").nullish(),
+          parentFolderId: z.string().describe("The unique identifier for the message's parent mailFolder.").nullish(),
+          receivedDateTime: 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 the message was received.  The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z."
+          ).nullish(),
+          replyTo: z.array(microsoft_graph_recipient).describe("The email addresses to use when replying.").optional(),
+          sender: microsoft_graph_recipient.optional(),
+          sentDateTime: 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 the message was sent.  The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z."
+          ).nullish(),
+          toRecipients: z.array(microsoft_graph_recipient).describe("The To: recipients for the message.").optional(),
+          uniqueBody: microsoft_graph_itemBody.optional()
+        }).strict().passthrough()
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
+  },
+  {
+    method: "post",
+    path: "/users/:userId/sendMail",
+    alias: "send-shared-mailbox-mail",
+    description: `Send the message specified in the request body using either JSON or MIME format. When using JSON format, you can include a file attachment in the same sendMail action call. When using MIME format: This method saves the message in the Sent Items folder. Alternatively, create a draft message to send later. To learn more about the steps involved in the backend before a mail is delivered to recipients, see here.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: send_mail_Body
+      }
+    ],
+    response: z.void(),
+    errors: [
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      },
+      {
+        status: NaN,
+        description: `error`,
+        schema: microsoft_graph_ODataErrors_ODataError
+      }
+    ]
   }
 ]);
 const api = new Zodios(endpoints);

package/dist/graph-tools.js

@@ -36,11 +36,7 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
     const paramSchema = {};
     if (tool.parameters && tool.parameters.length > 0) {
       for (const param of tool.parameters) {
-        if (param.type === "Body" && param.schema) {
-          paramSchema[param.name] = z.union([z.string(), param.schema]);
-        } else {
-          paramSchema[param.name] = param.schema || z.any();
-        }
+        paramSchema[param.name] = param.schema || z.any();
       }
     }
     if (tool.method.toUpperCase() === "GET" && tool.path.includes("/")) {
@@ -89,31 +85,15 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
                   queryParams[fixedParamName] = `${paramValue}`;
                   break;
                 case "Body":
-                  if (typeof paramValue === "string") {
-                    try {
-                      body = JSON.parse(paramValue);
-                    } catch {
-                      body = paramValue;
-                    }
-                  } else {
-                    body = paramValue;
-                  }
+                  body = paramValue;
                   break;
                 case "Header":
                   headers[fixedParamName] = `${paramValue}`;
                   break;
               }
             } else if (paramName === "body") {
-              if (typeof paramValue === "string") {
-                try {
-                  body = JSON.parse(paramValue);
-                } catch {
-                  body = paramValue;
-                }
-              } else {
-                body = paramValue;
-              }
-              logger.info(`Set legacy body param: ${JSON.stringify(body)}`);
+              body = paramValue;
+              logger.info(`Set body param: ${JSON.stringify(body)}`);
             }
           }
           if (Object.keys(queryParams).length > 0) {

package/package.json

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

@@ -29,6 +29,36 @@
     "toolName": "send-mail",
     "scopes": ["Mail.Send"]
   },
+  {
+    "pathPattern": "/users/{user-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-messages",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/mailFolders/{mailFolder-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-folder-messages",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/messages/{message-id}",
+    "method": "get",
+    "toolName": "get-shared-mailbox-message",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/sendMail",
+    "method": "post",
+    "toolName": "send-shared-mailbox-mail",
+    "workScopes": ["Mail.Send.Shared"]
+  },
+  {
+    "pathPattern": "/users",
+    "method": "get",
+    "toolName": "list-users",
+    "workScopes": ["User.Read.All"]
+  },
   {
     "pathPattern": "/me/messages",
     "method": "post",