@softeria/ms-365-mcp-server 0.90.0 → 0.92.0

package/dist/endpoints.json

@@ -521,6 +521,13 @@
     "scopes": ["Files.Read"],
     "llmTip": "Generate a short-lived embeddable preview URL for a file (Office docs, PDFs, images). Body: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Returns getUrl (interactive) and postUrl (form-post). Useful for surfacing inline previews in summary emails or chat messages without needing the recipient to open the file."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/thumbnails",
+    "method": "get",
+    "toolName": "list-drive-item-thumbnails",
+    "scopes": ["Files.Read"],
+    "llmTip": "Lists thumbnail sets for a file. Each set contains small (96px), medium (176px), large (800px) thumbnails with url and dimensions. Returns empty for unsupported types (text docs). Use $select=small,medium,large or $expand=small($select=url) to fetch specific sizes. The returned URLs are short-lived — fetch the bytes immediately."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/permissions",
     "method": "get",
@@ -1757,5 +1764,33 @@
     "toolName": "get-sensitivity-label",
     "workScopes": ["SensitivityLabel.Read"],
     "llmTip": "Gets a single MIP sensitivity label by id. Use list-sensitivity-labels to find ids. Not supported for personal Microsoft accounts."
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/copy",
+    "method": "post",
+    "toolName": "copy-mail-message",
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "Copies a message to another mail folder. Body: { DestinationId: '<mailFolder-id or well-known name like inbox, archive, junkemail>' }. Returns the newly created message (with a new id) in the destination folder. For moving instead of copying, use move-mail-message."
+  },
+  {
+    "pathPattern": "/me/mailFolders/{mailFolder-id}/messages/delta()",
+    "method": "get",
+    "toolName": "list-mail-folder-messages-delta",
+    "scopes": ["Mail.Read"],
+    "llmTip": "Incremental sync of messages within a mail folder. Graph only supports delta scoped to a folder — use mailFolder-id = 'inbox' for the well-known inbox, or another folder id from list-mail-folders. First call returns all messages plus @odata.deltaLink; subsequent calls with that link return only changes (created/updated/deleted). @odata.nextLink paginates within a single delta window. Deltas expire after ~30 days of inactivity — start over if the server returns 410. Prefer this over full re-list for polling."
+  },
+  {
+    "pathPattern": "/me/outlook/masterCategories",
+    "method": "get",
+    "toolName": "list-outlook-categories",
+    "scopes": ["MailboxSettings.Read"],
+    "llmTip": "Lists the user's Outlook categories (colored labels) used to tag messages, events, contacts, and tasks. Each category has displayName and color (preset0 through preset24, or 'none'). Use this to show available tags before applying via update-mail-message or update-calendar-event with body { categories: ['Category Name'] }."
+  },
+  {
+    "pathPattern": "/me/outlook/masterCategories",
+    "method": "post",
+    "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."
   }
 ]

package/dist/generated/client.js

@@ -916,6 +916,27 @@ const microsoft_graph_permissionCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_permission)
 }).partial().passthrough();
+const microsoft_graph_thumbnail = z.object({
+  content: z.string().describe("The content stream for the thumbnail.").nullish(),
+  height: z.number().gte(-2147483648).lte(2147483647).describe("The height of the thumbnail, in pixels.").nullish(),
+  sourceItemId: z.string().describe(
+    "The unique identifier of the item that provided the thumbnail. This is only available when a folder thumbnail is requested."
+  ).nullish(),
+  url: z.string().describe("The URL used to fetch the thumbnail content.").nullish(),
+  width: z.number().gte(-2147483648).lte(2147483647).describe("The width of the thumbnail, in pixels.").nullish()
+}).passthrough();
+const microsoft_graph_thumbnailSet = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  large: microsoft_graph_thumbnail.optional(),
+  medium: microsoft_graph_thumbnail.optional(),
+  small: microsoft_graph_thumbnail.optional(),
+  source: microsoft_graph_thumbnail.optional()
+}).passthrough();
+const microsoft_graph_thumbnailSetCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_thumbnailSet)
+}).partial().passthrough();
 const microsoft_graph_publicationFacet = z.object({
   checkedOutBy: microsoft_graph_identitySet.optional(),
   level: z.string().describe(
@@ -3476,6 +3497,46 @@ const microsoft_graph_callTranscriptCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_callTranscript)
 }).partial().passthrough();
+const microsoft_graph_categoryColor = z.enum([
+  "none",
+  "preset0",
+  "preset1",
+  "preset2",
+  "preset3",
+  "preset4",
+  "preset5",
+  "preset6",
+  "preset7",
+  "preset8",
+  "preset9",
+  "preset10",
+  "preset11",
+  "preset12",
+  "preset13",
+  "preset14",
+  "preset15",
+  "preset16",
+  "preset17",
+  "preset18",
+  "preset19",
+  "preset20",
+  "preset21",
+  "preset22",
+  "preset23",
+  "preset24"
+]);
+const microsoft_graph_outlookCategory = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  color: microsoft_graph_categoryColor.optional(),
+  displayName: z.string().describe(
+    "A unique name that identifies a category in the user's mailbox. After a category is created, the name cannot be changed. Read-only."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_outlookCategoryCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_outlookCategory)
+}).partial().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()
@@ -4525,6 +4586,9 @@ const schemas = {
   create_drive_item_preview_Body,
   microsoft_graph_itemPreviewInfo,
   microsoft_graph_permissionCollectionResponse,
+  microsoft_graph_thumbnail,
+  microsoft_graph_thumbnailSet,
+  microsoft_graph_thumbnailSetCollectionResponse,
   microsoft_graph_publicationFacet,
   microsoft_graph_driveItemVersion,
   microsoft_graph_driveItemVersionCollectionResponse,
@@ -4772,6 +4836,9 @@ const schemas = {
   microsoft_graph_callRecordingCollectionResponse,
   microsoft_graph_callTranscript,
   microsoft_graph_callTranscriptCollectionResponse,
+  microsoft_graph_categoryColor,
+  microsoft_graph_outlookCategory,
+  microsoft_graph_outlookCategoryCollectionResponse,
   microsoft_graph_personType,
   microsoft_graph_phoneType,
   microsoft_graph_phone,
@@ -5726,6 +5793,56 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/drives/:driveId/items/:driveItemId/thumbnails",
+    alias: "list-drive-item-thumbnails",
+    description: `Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.`,
+    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: "get",
     path: "/drives/:driveId/items/:driveItemId/versions",
@@ -8793,6 +8910,66 @@ folder collection and navigate to another folder. By default, this operation doe
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/mailFolders/:mailFolderId/messages/delta()",
+    alias: "list-mail-folder-messages-delta",
+    description: `Get a set of messages added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately
+applying state tokens in one or more of these calls, you can [query for incremental changes in the messages in
+that folder](/graph/delta-query-messages). It allows you to maintain and synchronize a local store of a user's messages without
+having to fetch the entire set of messages from the server every time.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "changeType",
+        type: "Query",
+        schema: z.string().describe(
+          "A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted."
+        ).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: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/manager",
@@ -9209,6 +9386,22 @@ resource.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/me/messages/:messageId/copy",
+    alias: "copy-mail-message",
+    description: `Copy a message to a folder within the user's mailbox.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ DestinationId: z.string() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/me/messages/:messageId/createForward",
@@ -10103,6 +10296,72 @@ resource.`,
     requestFormat: "json",
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/outlook/masterCategories",
+    alias: "list-outlook-categories",
+    description: `Get all the categories that have been defined for a user.`,
+    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/outlook/masterCategories",
+    alias: "create-outlook-category",
+    description: `Create an outlookCategory object in the user's master list of categories.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_outlookCategory
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/people",

package/package.json

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

@@ -521,6 +521,13 @@
     "scopes": ["Files.Read"],
     "llmTip": "Generate a short-lived embeddable preview URL for a file (Office docs, PDFs, images). Body: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Returns getUrl (interactive) and postUrl (form-post). Useful for surfacing inline previews in summary emails or chat messages without needing the recipient to open the file."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/thumbnails",
+    "method": "get",
+    "toolName": "list-drive-item-thumbnails",
+    "scopes": ["Files.Read"],
+    "llmTip": "Lists thumbnail sets for a file. Each set contains small (96px), medium (176px), large (800px) thumbnails with url and dimensions. Returns empty for unsupported types (text docs). Use $select=small,medium,large or $expand=small($select=url) to fetch specific sizes. The returned URLs are short-lived — fetch the bytes immediately."
+  },
   {
     "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/permissions",
     "method": "get",
@@ -1757,5 +1764,33 @@
     "toolName": "get-sensitivity-label",
     "workScopes": ["SensitivityLabel.Read"],
     "llmTip": "Gets a single MIP sensitivity label by id. Use list-sensitivity-labels to find ids. Not supported for personal Microsoft accounts."
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/copy",
+    "method": "post",
+    "toolName": "copy-mail-message",
+    "scopes": ["Mail.ReadWrite"],
+    "llmTip": "Copies a message to another mail folder. Body: { DestinationId: '<mailFolder-id or well-known name like inbox, archive, junkemail>' }. Returns the newly created message (with a new id) in the destination folder. For moving instead of copying, use move-mail-message."
+  },
+  {
+    "pathPattern": "/me/mailFolders/{mailFolder-id}/messages/delta()",
+    "method": "get",
+    "toolName": "list-mail-folder-messages-delta",
+    "scopes": ["Mail.Read"],
+    "llmTip": "Incremental sync of messages within a mail folder. Graph only supports delta scoped to a folder — use mailFolder-id = 'inbox' for the well-known inbox, or another folder id from list-mail-folders. First call returns all messages plus @odata.deltaLink; subsequent calls with that link return only changes (created/updated/deleted). @odata.nextLink paginates within a single delta window. Deltas expire after ~30 days of inactivity — start over if the server returns 410. Prefer this over full re-list for polling."
+  },
+  {
+    "pathPattern": "/me/outlook/masterCategories",
+    "method": "get",
+    "toolName": "list-outlook-categories",
+    "scopes": ["MailboxSettings.Read"],
+    "llmTip": "Lists the user's Outlook categories (colored labels) used to tag messages, events, contacts, and tasks. Each category has displayName and color (preset0 through preset24, or 'none'). Use this to show available tags before applying via update-mail-message or update-calendar-event with body { categories: ['Category Name'] }."
+  },
+  {
+    "pathPattern": "/me/outlook/masterCategories",
+    "method": "post",
+    "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."
   }
 ]