@softeria/ms-365-mcp-server 0.89.0 → 0.91.0

package/dist/endpoints.json

@@ -500,6 +500,27 @@
     "scopes": ["Files.ReadWrite"],
     "llmTip": "Shares a file or folder with specific users. Body: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Roles: 'read', 'write', 'owner'. Set requireSignIn to true to require authentication."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/createLink",
+    "method": "post",
+    "toolName": "create-drive-item-share-link",
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Create a shareable link for a file or folder WITHOUT sending an email invitation. Body: { type: 'view' | 'edit' | 'embed', scope: 'anonymous' | 'organization' | 'users', password?: string, expirationDateTime?: ISO-8601, retainInheritedPermissions?: boolean }. Returns a permission with link.webUrl. Pair with share-drive-item when you want to grant explicit access; use this when you only need a URL to paste into a doc/email/chat without triggering OneDrive notifications."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/copy",
+    "method": "post",
+    "toolName": "copy-drive-item",
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Asynchronously copy a file or folder to a new location and/or name. Body: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Returns 202 Accepted with a Location header pointing at a monitor URL for the async job. Ideal for duplicating templates (e.g. clone an Armhr Census Template per prospect), bulk file provisioning, or preserving an immutable snapshot of a working file."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/preview",
+    "method": "post",
+    "toolName": "create-drive-item-preview",
+    "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}/permissions",
     "method": "get",
@@ -1736,5 +1757,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

@@ -763,46 +763,24 @@ const microsoft_graph_driveItemCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_driveItem)
 }).partial().passthrough();
-const create_upload_session_Body = z.object({ item: z.object({}).partial().passthrough() }).partial().passthrough();
-const microsoft_graph_uploadSession = z.object({
+const copy_drive_item_Body = z.object({
+  name: z.string().nullable(),
+  parentReference: z.union([microsoft_graph_itemReference, z.object({}).partial().passthrough()]),
+  childrenOnly: z.boolean().nullable().default(false),
+  includeAllVersionHistory: z.boolean().nullable().default(false)
+}).partial().passthrough();
+const create_drive_item_share_link_Body = z.object({
+  type: z.string().nullable(),
+  scope: z.string().nullable(),
   expirationDateTime: 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 in UTC that the upload session expires. The complete file must be uploaded before this expiration time is reached. Each fragment uploaded during the session extends the expiration time."
-  ).nullish(),
-  nextExpectedRanges: z.array(z.string().nullable()).describe(
-    "A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format 'start-end' (for example '0-26' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value '{start}', the location in the file where the next upload should begin."
-  ).optional(),
-  uploadUrl: z.string().describe("The URL endpoint that accepts PUT requests for byte ranges of the file.").nullish()
-}).passthrough();
-const BaseDeltaFunctionResponse = z.object({ "@odata.nextLink": z.string().nullable(), "@odata.deltaLink": z.string().nullable() }).partial().passthrough();
-const microsoft_graph_sensitivityLabelAssignmentMethod = z.enum([
-  "standard",
-  "privileged",
-  "auto",
-  "unknownFutureValue"
-]);
-const microsoft_graph_sensitivityLabelAssignment = z.object({
-  assignmentMethod: microsoft_graph_sensitivityLabelAssignmentMethod.optional(),
-  sensitivityLabelId: z.string().describe("The unique identifier for the sensitivity label assigned to the file.").optional(),
-  tenantId: z.string().describe(
-    "The unique identifier for the tenant that hosts the file when this label is applied."
-  ).optional()
-}).passthrough();
-const microsoft_graph_extractSensitivityLabelsResult = z.object({
-  labels: z.array(microsoft_graph_sensitivityLabelAssignment).describe("List of sensitivity labels assigned to a file.").optional()
-}).passthrough();
-const share_drive_item_Body = z.object({
-  requireSignIn: z.boolean().nullable().default(false),
-  roles: z.array(z.string().nullable()),
-  sendInvitation: z.boolean().nullable().default(false),
+  ).datetime({ offset: true }).nullable(),
+  password: z.string().nullable(),
   message: z.string().nullable(),
   recipients: z.array(z.object({}).partial().passthrough()),
   retainInheritedPermissions: z.boolean().nullable().default(false),
-  expirationDateTime: z.string().nullable(),
-  password: z.string().nullable()
+  sendNotification: z.boolean().nullable().default(false)
 }).partial().passthrough();
-const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().passthrough();
 const microsoft_graph_sharePointGroupIdentity = z.object({
   displayName: z.string().describe(
     "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta."
@@ -883,6 +861,56 @@ const microsoft_graph_permission = z.object({
     "A unique token that can be used to access this shared item via the shares API. Read-only."
   ).nullish()
 }).passthrough();
+const create_upload_session_Body = z.object({ item: z.object({}).partial().passthrough() }).partial().passthrough();
+const microsoft_graph_uploadSession = z.object({
+  expirationDateTime: 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 in UTC that the upload session expires. The complete file must be uploaded before this expiration time is reached. Each fragment uploaded during the session extends the expiration time."
+  ).nullish(),
+  nextExpectedRanges: z.array(z.string().nullable()).describe(
+    "A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format 'start-end' (for example '0-26' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value '{start}', the location in the file where the next upload should begin."
+  ).optional(),
+  uploadUrl: z.string().describe("The URL endpoint that accepts PUT requests for byte ranges of the file.").nullish()
+}).passthrough();
+const BaseDeltaFunctionResponse = z.object({ "@odata.nextLink": z.string().nullable(), "@odata.deltaLink": z.string().nullable() }).partial().passthrough();
+const microsoft_graph_sensitivityLabelAssignmentMethod = z.enum([
+  "standard",
+  "privileged",
+  "auto",
+  "unknownFutureValue"
+]);
+const microsoft_graph_sensitivityLabelAssignment = z.object({
+  assignmentMethod: microsoft_graph_sensitivityLabelAssignmentMethod.optional(),
+  sensitivityLabelId: z.string().describe("The unique identifier for the sensitivity label assigned to the file.").optional(),
+  tenantId: z.string().describe(
+    "The unique identifier for the tenant that hosts the file when this label is applied."
+  ).optional()
+}).passthrough();
+const microsoft_graph_extractSensitivityLabelsResult = z.object({
+  labels: z.array(microsoft_graph_sensitivityLabelAssignment).describe("List of sensitivity labels assigned to a file.").optional()
+}).passthrough();
+const share_drive_item_Body = z.object({
+  requireSignIn: z.boolean().nullable().default(false),
+  roles: z.array(z.string().nullable()),
+  sendInvitation: z.boolean().nullable().default(false),
+  message: z.string().nullable(),
+  recipients: z.array(z.object({}).partial().passthrough()),
+  retainInheritedPermissions: z.boolean().nullable().default(false),
+  expirationDateTime: z.string().nullable(),
+  password: z.string().nullable()
+}).partial().passthrough();
+const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().passthrough();
+const ReferenceNumeric = z.enum(["-INF", "INF", "NaN"]);
+const create_drive_item_preview_Body = z.object({
+  page: z.string().nullable(),
+  zoom: z.union([z.number(), z.string(), ReferenceNumeric])
+}).partial().passthrough();
+const microsoft_graph_itemPreviewInfo = z.object({
+  getUrl: z.string().nullish(),
+  postParameters: z.string().nullish(),
+  postUrl: z.string().nullish()
+}).passthrough();
 const microsoft_graph_permissionCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -3081,7 +3109,6 @@ const microsoft_graph_timeConstraint = z.object({
   activityDomain: microsoft_graph_activityDomain.optional(),
   timeSlots: z.array(microsoft_graph_timeSlot).optional()
 }).passthrough();
-const ReferenceNumeric = z.enum(["-INF", "INF", "NaN"]);
 const find_meeting_times_Body = z.object({
   attendees: z.array(microsoft_graph_attendeeBase),
   locationConstraint: z.union([
@@ -3449,6 +3476,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()
@@ -4478,6 +4545,14 @@ const schemas = {
   microsoft_graph_pendingOperations,
   microsoft_graph_driveItem,
   microsoft_graph_driveItemCollectionResponse,
+  copy_drive_item_Body,
+  create_drive_item_share_link_Body,
+  microsoft_graph_sharePointGroupIdentity,
+  microsoft_graph_sharePointIdentity,
+  microsoft_graph_sharePointIdentitySet,
+  microsoft_graph_sharingInvitation,
+  microsoft_graph_sharingLink,
+  microsoft_graph_permission,
   create_upload_session_Body,
   microsoft_graph_uploadSession,
   BaseDeltaFunctionResponse,
@@ -4486,12 +4561,9 @@ const schemas = {
   microsoft_graph_extractSensitivityLabelsResult,
   share_drive_item_Body,
   BaseCollectionPaginationCountResponse,
-  microsoft_graph_sharePointGroupIdentity,
-  microsoft_graph_sharePointIdentity,
-  microsoft_graph_sharePointIdentitySet,
-  microsoft_graph_sharingInvitation,
-  microsoft_graph_sharingLink,
-  microsoft_graph_permission,
+  ReferenceNumeric,
+  create_drive_item_preview_Body,
+  microsoft_graph_itemPreviewInfo,
   microsoft_graph_permissionCollectionResponse,
   microsoft_graph_publicationFacet,
   microsoft_graph_driveItemVersion,
@@ -4705,7 +4777,6 @@ const schemas = {
   microsoft_graph_locationConstraint,
   microsoft_graph_activityDomain,
   microsoft_graph_timeConstraint,
-  ReferenceNumeric,
   find_meeting_times_Body,
   send_mail_Body,
   microsoft_graph_externalLink,
@@ -4741,6 +4812,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,
@@ -5487,6 +5561,39 @@ const endpoints = makeApi([
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/drives/:driveId/items/:driveItemId/copy",
+    alias: "copy-drive-item",
+    description: `Invoke action copy`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: copy_drive_item_Body
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/drives/:driveId/items/:driveItemId/createLink",
+    alias: "create-drive-item-share-link",
+    description: `Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application.
+If a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: create_drive_item_share_link_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/drives/:driveId/items/:driveItemId/createUploadSession",
@@ -5646,6 +5753,22 @@ Items with this property set should be removed from your local state.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/drives/:driveId/items/:driveItemId/preview",
+    alias: "create-drive-item-preview",
+    description: `Invoke action preview`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: create_drive_item_preview_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/drives/:driveId/items/:driveItemId/versions",
@@ -8713,6 +8836,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",
@@ -9129,6 +9312,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",
@@ -10023,6 +10222,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.89.0",
+  "version": "0.91.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

@@ -500,6 +500,27 @@
     "scopes": ["Files.ReadWrite"],
     "llmTip": "Shares a file or folder with specific users. Body: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Roles: 'read', 'write', 'owner'. Set requireSignIn to true to require authentication."
   },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/createLink",
+    "method": "post",
+    "toolName": "create-drive-item-share-link",
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Create a shareable link for a file or folder WITHOUT sending an email invitation. Body: { type: 'view' | 'edit' | 'embed', scope: 'anonymous' | 'organization' | 'users', password?: string, expirationDateTime?: ISO-8601, retainInheritedPermissions?: boolean }. Returns a permission with link.webUrl. Pair with share-drive-item when you want to grant explicit access; use this when you only need a URL to paste into a doc/email/chat without triggering OneDrive notifications."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/copy",
+    "method": "post",
+    "toolName": "copy-drive-item",
+    "scopes": ["Files.ReadWrite"],
+    "llmTip": "Asynchronously copy a file or folder to a new location and/or name. Body: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Returns 202 Accepted with a Location header pointing at a monitor URL for the async job. Ideal for duplicating templates (e.g. clone an Armhr Census Template per prospect), bulk file provisioning, or preserving an immutable snapshot of a working file."
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/preview",
+    "method": "post",
+    "toolName": "create-drive-item-preview",
+    "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}/permissions",
     "method": "get",
@@ -1736,5 +1757,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."
   }
 ]