@softeria/ms-365-mcp-server 0.105.0 → 0.106.1

package/dist/endpoints.json

@@ -1625,10 +1625,11 @@
     "llmTip": "Gets presence status for a specific user by their user ID or UPN (email). Returns availability and activity. Use list-users to find the user ID first."
   },
   {
-    "pathPattern": "/communications/presences",
+    "pathPattern": "/communications/getPresencesByUserId",
     "method": "post",
     "toolName": "get-presences-by-user-id",
     "workScopes": ["Presence.Read.All"],
+    "contentType": "application/json",
     "llmTip": "Gets presence for multiple users in a single call. Body: { ids: ['user-id-1', 'user-id-2', ...] }. Returns array of presence objects. More efficient than calling get-user-presence for each user. Maximum 650 user IDs per request."
   },
   {
@@ -1882,21 +1883,21 @@
     "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."
+    "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', ...], 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."
+    "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'). Note the PascalCase — the values are case-sensitive enums, not lowercase strings. 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."
+    "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') and displayName ('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",
@@ -1938,35 +1939,35 @@
     "method": "post",
     "toolName": "create-contact-child-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Names must be unique among siblings under the same parent. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth."
+    "llmTip": "Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth."
   },
   {
     "pathPattern": "/me/contactFolders",
     "method": "get",
     "toolName": "list-contact-folders",
     "scopes": ["Contacts.Read"],
-    "llmTip": "Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, parentFolderId, and wellKnownName ('contacts' for the default). Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports $filter, $top, $orderby."
+    "llmTip": "Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, and parentFolderId. To identify the default folder, match displayName === 'Contacts'. Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports OData query parameters."
   },
   {
     "pathPattern": "/me/contactFolders",
     "method": "post",
     "toolName": "create-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. Folder names must be unique among siblings. To create a sub-folder, POST to /me/contactFolders/{parent-id}/childFolders instead — not currently exposed."
+    "llmTip": "Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. To create a sub-folder under an existing folder, use create-contact-child-folder."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}",
     "method": "patch",
     "toolName": "update-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Renames a contact folder. Body: { displayName: 'New name' }. Only displayName is writable. The default 'Contacts' folder cannot be renamed — Graph returns an error. Get the folder id via list-contact-folders."
+    "llmTip": "Updates a contact folder. Body: { displayName?: 'New name', parentFolderId?: '<id>' } — both displayName (rename) and parentFolderId (move) are writable. The default 'Contacts' folder may not be renameable. Get the folder id via list-contact-folders."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}",
     "method": "delete",
     "toolName": "delete-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Deletes a contact folder and ALL contacts in it (cascades). The default 'Contacts' folder cannot be deleted — Graph returns an error. Get the folder id via list-contact-folders. Operation is irreversible."
+    "llmTip": "Deletes a contact folder. The default 'Contacts' folder cannot be deleted — Graph returns an error. The folder (and its contents) typically lands in Deleted Items rather than being permanently removed. Get the folder id via list-contact-folders."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}/contacts",
@@ -2009,14 +2010,14 @@
     "method": "delete",
     "toolName": "delete-todo-task-list",
     "scopes": ["Tasks.ReadWrite"],
-    "llmTip": "Deletes a Microsoft To Do task list and ALL of its tasks (cascades). Built-in lists cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists. Operation is irreversible."
+    "llmTip": "Deletes a Microsoft To Do task list. Built-in lists (Flagged emails, the default Tasks list) cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists."
   },
   {
     "pathPattern": "/me/onenote/pages",
     "method": "get",
     "toolName": "list-onenote-pages",
     "scopes": ["Notes.Read"],
-    "llmTip": "Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $search='query' for full-text search across page titles and bodies, $filter (e.g. lastModifiedTime gt 2026-01-01), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use $search before bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you only have a topic in mind."
+    "llmTip": "Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $filter (e.g. lastModifiedTime gt 2026-01-01, or contains(tolower(title), 'topic') for title search), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use this instead of bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you have a topic in mind."
   },
   {
     "pathPattern": "/me/onenote/sectionGroups",
@@ -2031,6 +2032,68 @@
     "toolName": "get-onenote-notebook-from-web-url",
     "workScopes": ["Notes.Read"],
     "contentType": "application/json",
-    "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a CopyNotebookModel with the notebook's id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+    "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a notebook object with id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+  },
+  {
+    "pathPattern": "/me/presence/setPresence",
+    "method": "post",
+    "toolName": "set-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's presence session as an application. Body: { sessionId (your app's client/session id, required), availability + activity (must be one of these documented combos: Available/Available, Busy/InACall, Busy/InAConferenceCall, Away/Away, DoNotDisturb/Presenting), expirationDuration (ISO 8601 duration like 'PT1H' — defaults to PT5M, valid range PT5M–PT4H) }. Note: if the user also wants to override their *visible* status regardless of activity, prefer set-my-user-preferred-presence. clear-my-presence ends the session."
+  },
+  {
+    "pathPattern": "/me/presence/clearPresence",
+    "method": "post",
+    "toolName": "clear-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Ends the application's presence session for the current user. Body: { sessionId } — must match the sessionId used in set-my-presence. If this was the user's only presence session, their status returns to Offline."
+  },
+  {
+    "pathPattern": "/me/presence/setUserPreferredPresence",
+    "method": "post",
+    "toolName": "set-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's preferred (sticky) availability and activity — the value Teams clients display regardless of underlying activity. Body: { availability + activity (must be one of these documented combos: Available/Available, Busy/Busy, DoNotDisturb/DoNotDisturb, BeRightBack/BeRightBack, Away/Away, Offline/OffWork), expirationDuration (ISO 8601 duration like 'PT2H' — if omitted, defaults to 1 day for DoNotDisturb/Busy and 7 days for other availability values; not 'indefinite'). Requires at least one active presence session (Teams client signed in or set-my-presence call) — otherwise the user appears Offline. Use this for 'put me in Do Not Disturb for 2 hours' workflows. clear-my-user-preferred-presence reverts to actual presence."
+  },
+  {
+    "pathPattern": "/me/presence/clearUserPreferredPresence",
+    "method": "post",
+    "toolName": "clear-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Clears any preferred (sticky) presence override set via set-my-user-preferred-presence. The user's visible status returns to their actual activity. Body: {} (an empty JSON object — required, not 'no body')."
+  },
+  {
+    "pathPattern": "/me/presence/setStatusMessage",
+    "method": "post",
+    "toolName": "set-my-status-message",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's Teams status message (the free-text note shown next to their name, e.g. 'Heads-down on Q3 plan'). Body: { statusMessage: { message: { content: 'text or HTML', contentType: 'text' | 'html' }, expiryDateTime: { dateTime: '2026-05-06T17:00:00', timeZone: 'UTC' } (optional) } }. Pass an empty object {} or message.content='' to clear. expiryDateTime is optional — omit for no expiration."
+  },
+  {
+    "pathPattern": "/me/teamwork/associatedTeams",
+    "method": "get",
+    "toolName": "list-my-associated-teams",
+    "workScopes": ["Team.ReadBasic.All"],
+    "llmTip": "Lists Teams the current user is associated with — both joined teams and host teams of shared channels the user is a direct member of. Returns associatedTeamInfo objects with id, displayName, and tenantId. Broader than list-joined-teams because it includes shared-channel host teams."
+  },
+  {
+    "pathPattern": "/me/teamwork/installedApps",
+    "method": "get",
+    "toolName": "list-my-installed-teams-apps",
+    "workScopes": ["TeamsAppInstallation.ReadForUser"],
+    "llmTip": "Lists Teams apps installed in the current user's personal scope (the apps pinned to the user's Teams sidebar / accessible without joining a team or chat). Use $expand=teamsApp,teamsAppDefinition for full app metadata (displayName, version, distributionMethod). Useful before send-my-activity-notification to discover the user's own teamsAppId."
+  },
+  {
+    "pathPattern": "/me/teamwork/sendActivityNotification",
+    "method": "post",
+    "toolName": "send-my-activity-notification",
+    "workScopes": ["TeamsActivity.Send"],
+    "contentType": "application/json",
+    "llmTip": "Sends a Teams activity feed notification to the current user (the badge + entry in their Activity tab). Body: { topic: { source: 'entityUrl' | 'text', value: <Graph URL or plain text>, webUrl: <required when source='text', click-through URL> }, activityType: <must be declared in the calling Teams app's manifest, OR the reserved 'systemDefault' which provides free-form Actor+Reason text>, previewText: { content: 'short preview' }, templateParameters?: [{ name, value }] (substituted into the manifest's localized notification template), teamsAppId?: <optional disambiguator when multiple installed apps share a Microsoft Entra app ID — fetch via list-my-installed-teams-apps>, chainId?, iconId? }. Use to ping the user with 'action required' notifications from agentic workflows. See https://learn.microsoft.com/graph/teams-send-activityfeednotifications."
   }
 ]

package/dist/generated/client.js

@@ -432,6 +432,8 @@ const microsoft_graph_pinnedChatMessageInfoCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_pinnedChatMessageInfo)
 }).partial().passthrough();
+const get_presences_by_user_id_Body = z.object({ ids: z.array(z.string()) }).partial().passthrough();
+const BaseCollectionPaginationCountResponse = z.object({ "@odata.count": z.number().int().nullable(), "@odata.nextLink": z.string().nullable() }).partial().passthrough();
 const microsoft_graph_outOfOfficeSettings = z.object({
   isOutOfOffice: z.boolean().describe(
     "If true, either of the following is met:The current time falls within the out-of-office window configured in Outlook or Teams.An event marked as 'Show as Out of Office' appears on the user's calendar.Otherwise, false."
@@ -900,7 +902,6 @@ const share_drive_item_Body = z.object({
   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(),
@@ -3780,6 +3781,55 @@ const microsoft_graph_plannerTaskCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_plannerTask)
 }).partial().passthrough();
+const set_my_presence_Body = z.object({
+  sessionId: z.string().nullable(),
+  availability: z.string(),
+  activity: z.string(),
+  expirationDuration: z.string().regex(/^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$/).nullable()
+}).partial().passthrough();
+const set_my_status_message_Body = z.object({
+  statusMessage: z.union([
+    microsoft_graph_presenceStatusMessage,
+    z.object({}).partial().passthrough()
+  ])
+}).partial().passthrough();
+const set_my_user_preferred_presence_Body = z.object({
+  availability: z.string(),
+  activity: z.string(),
+  expirationDuration: z.string().regex(/^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$/).nullable()
+}).partial().passthrough();
+const microsoft_graph_associatedTeamInfo = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  displayName: z.string().describe("The name of the team.").nullish(),
+  tenantId: z.string().describe("The ID of the Microsoft Entra tenant.").nullish(),
+  team: microsoft_graph_team.describe("[Note: Simplified from 30 properties to 25 most common ones]").optional()
+}).passthrough();
+const microsoft_graph_associatedTeamInfoCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_associatedTeamInfo)
+}).partial().passthrough();
+const microsoft_graph_userScopeTeamsAppInstallation = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  consentedPermissionSet: microsoft_graph_teamsAppPermissionSet.optional(),
+  teamsApp: microsoft_graph_teamsApp.optional(),
+  teamsAppDefinition: microsoft_graph_teamsAppDefinition.optional(),
+  chat: microsoft_graph_chat.optional()
+}).passthrough();
+const microsoft_graph_userScopeTeamsAppInstallationCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_userScopeTeamsAppInstallation)
+}).partial().passthrough();
+const send_my_activity_notification_Body = z.object({
+  topic: z.object({}).partial().passthrough(),
+  activityType: z.string().nullable(),
+  chainId: z.number().nullable(),
+  previewText: z.union([microsoft_graph_itemBody, z.object({}).partial().passthrough()]),
+  teamsAppId: z.string().nullable(),
+  templateParameters: z.array(z.object({}).partial().passthrough()),
+  iconId: z.string().nullable()
+}).partial().passthrough();
 const microsoft_graph_wellknownListName = z.enum([
   "none",
   "defaultList",
@@ -4623,6 +4673,8 @@ const schemas = {
   microsoft_graph_chatMessageCollectionResponse,
   microsoft_graph_chatMessageHostedContentCollectionResponse,
   microsoft_graph_pinnedChatMessageInfoCollectionResponse,
+  get_presences_by_user_id_Body,
+  BaseCollectionPaginationCountResponse,
   microsoft_graph_outOfOfficeSettings,
   microsoft_graph_dateTimeTimeZone,
   microsoft_graph_presenceStatusMessage,
@@ -4669,7 +4721,6 @@ const schemas = {
   microsoft_graph_sensitivityLabelAssignment,
   microsoft_graph_extractSensitivityLabelsResult,
   share_drive_item_Body,
-  BaseCollectionPaginationCountResponse,
   ReferenceNumeric,
   create_drive_item_preview_Body,
   microsoft_graph_itemPreviewInfo,
@@ -4957,6 +5008,14 @@ const schemas = {
   microsoft_graph_plannerBucketTaskBoardTaskFormat,
   microsoft_graph_plannerTask,
   microsoft_graph_plannerTaskCollectionResponse,
+  set_my_presence_Body,
+  set_my_status_message_Body,
+  set_my_user_preferred_presence_Body,
+  microsoft_graph_associatedTeamInfo,
+  microsoft_graph_associatedTeamInfoCollectionResponse,
+  microsoft_graph_userScopeTeamsAppInstallation,
+  microsoft_graph_userScopeTeamsAppInstallationCollectionResponse,
+  send_my_activity_notification_Body,
   microsoft_graph_wellknownListName,
   microsoft_graph_taskStatus,
   microsoft_graph_attachmentBase,
@@ -5462,16 +5521,16 @@ const endpoints = makeApi([
   },
   {
     method: "post",
-    path: "/communications/presences",
+    path: "/communications/getPresencesByUserId",
     alias: "get-presences-by-user-id",
-    description: `Create new navigation property to presences for communications`,
+    description: `Get the presence information for multiple users.`,
     requestFormat: "json",
     parameters: [
       {
         name: "body",
-        description: `New navigation property`,
+        description: `Action parameters`,
         type: "Body",
-        schema: microsoft_graph_presence
+        schema: get_presences_by_user_id_Body
       }
     ],
     response: z.void()
@@ -11371,6 +11430,78 @@ getting the user's mailbox settings.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/me/presence/clearPresence",
+    alias: "clear-my-presence",
+    description: `Clear the application's presence session for a user. If it is the user's only presence session, the user's presence will change to Offline/Offline. For details about presences sessions, see presence: setPresence.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ sessionId: z.string().nullable() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/clearUserPreferredPresence",
+    alias: "clear-my-user-preferred-presence",
+    description: `Clear the preferred availability and activity status for a user.`,
+    requestFormat: "json",
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setPresence",
+    alias: "set-my-presence",
+    description: `Set the state of a user's presence session as an application. For more information about presence sessions, states permutations, and timeouts, see Manage presence state using the Microsoft Graph API.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_presence_Body
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setStatusMessage",
+    alias: "set-my-status-message",
+    description: `Set a presence status message for a user. An optional expiration date and time can be supplied.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_status_message_Body
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/me/presence/setUserPreferredPresence",
+    alias: "set-my-user-preferred-presence",
+    description: `Set the preferred availability and activity status for a user. If the preferred presence of a user is set, the user's presence shows as the preferred status. Preferred presence takes effect only when at least one presence session exists for the user. Otherwise, the user's presence shows as Offline. A presence session is created as a result of a successful setPresence operation, or if the user is signed in on a Microsoft Teams client. For more details, see presence sessions and time-out and expiration.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: set_my_user_preferred_presence_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "post",
     path: "/me/sendMail",
@@ -11387,6 +11518,123 @@ getting the user's mailbox settings.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/teamwork/associatedTeams",
+    alias: "list-my-associated-teams",
+    description: `Get the list of teams in Microsoft Teams that a user is associated with.
+Currently, a user can be associated with a team in two different ways:`,
+    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: "/me/teamwork/installedApps",
+    alias: "list-my-installed-teams-apps",
+    description: `The apps installed in the personal scope of this 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/teamwork/sendActivityNotification",
+    alias: "send-my-activity-notification",
+    description: `Send an activity feed notification to a user. For more information, see sending Teams activity notifications.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: send_my_activity_notification_Body
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/todo/lists",

package/package.json

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

@@ -1625,10 +1625,11 @@
     "llmTip": "Gets presence status for a specific user by their user ID or UPN (email). Returns availability and activity. Use list-users to find the user ID first."
   },
   {
-    "pathPattern": "/communications/presences",
+    "pathPattern": "/communications/getPresencesByUserId",
     "method": "post",
     "toolName": "get-presences-by-user-id",
     "workScopes": ["Presence.Read.All"],
+    "contentType": "application/json",
     "llmTip": "Gets presence for multiple users in a single call. Body: { ids: ['user-id-1', 'user-id-2', ...] }. Returns array of presence objects. More efficient than calling get-user-presence for each user. Maximum 650 user IDs per request."
   },
   {
@@ -1882,21 +1883,21 @@
     "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."
+    "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', ...], 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."
+    "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'). Note the PascalCase — the values are case-sensitive enums, not lowercase strings. 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."
+    "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') and displayName ('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",
@@ -1938,35 +1939,35 @@
     "method": "post",
     "toolName": "create-contact-child-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Names must be unique among siblings under the same parent. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth."
+    "llmTip": "Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth."
   },
   {
     "pathPattern": "/me/contactFolders",
     "method": "get",
     "toolName": "list-contact-folders",
     "scopes": ["Contacts.Read"],
-    "llmTip": "Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, parentFolderId, and wellKnownName ('contacts' for the default). Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports $filter, $top, $orderby."
+    "llmTip": "Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, and parentFolderId. To identify the default folder, match displayName === 'Contacts'. Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports OData query parameters."
   },
   {
     "pathPattern": "/me/contactFolders",
     "method": "post",
     "toolName": "create-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. Folder names must be unique among siblings. To create a sub-folder, POST to /me/contactFolders/{parent-id}/childFolders instead — not currently exposed."
+    "llmTip": "Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. To create a sub-folder under an existing folder, use create-contact-child-folder."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}",
     "method": "patch",
     "toolName": "update-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Renames a contact folder. Body: { displayName: 'New name' }. Only displayName is writable. The default 'Contacts' folder cannot be renamed — Graph returns an error. Get the folder id via list-contact-folders."
+    "llmTip": "Updates a contact folder. Body: { displayName?: 'New name', parentFolderId?: '<id>' } — both displayName (rename) and parentFolderId (move) are writable. The default 'Contacts' folder may not be renameable. Get the folder id via list-contact-folders."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}",
     "method": "delete",
     "toolName": "delete-contact-folder",
     "scopes": ["Contacts.ReadWrite"],
-    "llmTip": "Deletes a contact folder and ALL contacts in it (cascades). The default 'Contacts' folder cannot be deleted — Graph returns an error. Get the folder id via list-contact-folders. Operation is irreversible."
+    "llmTip": "Deletes a contact folder. The default 'Contacts' folder cannot be deleted — Graph returns an error. The folder (and its contents) typically lands in Deleted Items rather than being permanently removed. Get the folder id via list-contact-folders."
   },
   {
     "pathPattern": "/me/contactFolders/{contactFolder-id}/contacts",
@@ -2009,14 +2010,14 @@
     "method": "delete",
     "toolName": "delete-todo-task-list",
     "scopes": ["Tasks.ReadWrite"],
-    "llmTip": "Deletes a Microsoft To Do task list and ALL of its tasks (cascades). Built-in lists cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists. Operation is irreversible."
+    "llmTip": "Deletes a Microsoft To Do task list. Built-in lists (Flagged emails, the default Tasks list) cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists."
   },
   {
     "pathPattern": "/me/onenote/pages",
     "method": "get",
     "toolName": "list-onenote-pages",
     "scopes": ["Notes.Read"],
-    "llmTip": "Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $search='query' for full-text search across page titles and bodies, $filter (e.g. lastModifiedTime gt 2026-01-01), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use $search before bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you only have a topic in mind."
+    "llmTip": "Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $filter (e.g. lastModifiedTime gt 2026-01-01, or contains(tolower(title), 'topic') for title search), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use this instead of bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you have a topic in mind."
   },
   {
     "pathPattern": "/me/onenote/sectionGroups",
@@ -2031,6 +2032,68 @@
     "toolName": "get-onenote-notebook-from-web-url",
     "workScopes": ["Notes.Read"],
     "contentType": "application/json",
-    "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a CopyNotebookModel with the notebook's id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+    "llmTip": "Resolves a OneNote notebook from its web URL (the link a user copies from OneNote / SharePoint / Teams). Body: { webUrl: 'https://...' }. Returns a notebook object with id, displayName, sectionsUrl, sectionGroupsUrl, and isShared — you can then list its sections via list-onenote-notebook-sections. Accepts user notebooks, group notebooks, and SharePoint-hosted team notebooks. Personal Microsoft accounts are not supported."
+  },
+  {
+    "pathPattern": "/me/presence/setPresence",
+    "method": "post",
+    "toolName": "set-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's presence session as an application. Body: { sessionId (your app's client/session id, required), availability + activity (must be one of these documented combos: Available/Available, Busy/InACall, Busy/InAConferenceCall, Away/Away, DoNotDisturb/Presenting), expirationDuration (ISO 8601 duration like 'PT1H' — defaults to PT5M, valid range PT5M–PT4H) }. Note: if the user also wants to override their *visible* status regardless of activity, prefer set-my-user-preferred-presence. clear-my-presence ends the session."
+  },
+  {
+    "pathPattern": "/me/presence/clearPresence",
+    "method": "post",
+    "toolName": "clear-my-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Ends the application's presence session for the current user. Body: { sessionId } — must match the sessionId used in set-my-presence. If this was the user's only presence session, their status returns to Offline."
+  },
+  {
+    "pathPattern": "/me/presence/setUserPreferredPresence",
+    "method": "post",
+    "toolName": "set-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's preferred (sticky) availability and activity — the value Teams clients display regardless of underlying activity. Body: { availability + activity (must be one of these documented combos: Available/Available, Busy/Busy, DoNotDisturb/DoNotDisturb, BeRightBack/BeRightBack, Away/Away, Offline/OffWork), expirationDuration (ISO 8601 duration like 'PT2H' — if omitted, defaults to 1 day for DoNotDisturb/Busy and 7 days for other availability values; not 'indefinite'). Requires at least one active presence session (Teams client signed in or set-my-presence call) — otherwise the user appears Offline. Use this for 'put me in Do Not Disturb for 2 hours' workflows. clear-my-user-preferred-presence reverts to actual presence."
+  },
+  {
+    "pathPattern": "/me/presence/clearUserPreferredPresence",
+    "method": "post",
+    "toolName": "clear-my-user-preferred-presence",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Clears any preferred (sticky) presence override set via set-my-user-preferred-presence. The user's visible status returns to their actual activity. Body: {} (an empty JSON object — required, not 'no body')."
+  },
+  {
+    "pathPattern": "/me/presence/setStatusMessage",
+    "method": "post",
+    "toolName": "set-my-status-message",
+    "workScopes": ["Presence.ReadWrite"],
+    "contentType": "application/json",
+    "llmTip": "Sets the user's Teams status message (the free-text note shown next to their name, e.g. 'Heads-down on Q3 plan'). Body: { statusMessage: { message: { content: 'text or HTML', contentType: 'text' | 'html' }, expiryDateTime: { dateTime: '2026-05-06T17:00:00', timeZone: 'UTC' } (optional) } }. Pass an empty object {} or message.content='' to clear. expiryDateTime is optional — omit for no expiration."
+  },
+  {
+    "pathPattern": "/me/teamwork/associatedTeams",
+    "method": "get",
+    "toolName": "list-my-associated-teams",
+    "workScopes": ["Team.ReadBasic.All"],
+    "llmTip": "Lists Teams the current user is associated with — both joined teams and host teams of shared channels the user is a direct member of. Returns associatedTeamInfo objects with id, displayName, and tenantId. Broader than list-joined-teams because it includes shared-channel host teams."
+  },
+  {
+    "pathPattern": "/me/teamwork/installedApps",
+    "method": "get",
+    "toolName": "list-my-installed-teams-apps",
+    "workScopes": ["TeamsAppInstallation.ReadForUser"],
+    "llmTip": "Lists Teams apps installed in the current user's personal scope (the apps pinned to the user's Teams sidebar / accessible without joining a team or chat). Use $expand=teamsApp,teamsAppDefinition for full app metadata (displayName, version, distributionMethod). Useful before send-my-activity-notification to discover the user's own teamsAppId."
+  },
+  {
+    "pathPattern": "/me/teamwork/sendActivityNotification",
+    "method": "post",
+    "toolName": "send-my-activity-notification",
+    "workScopes": ["TeamsActivity.Send"],
+    "contentType": "application/json",
+    "llmTip": "Sends a Teams activity feed notification to the current user (the badge + entry in their Activity tab). Body: { topic: { source: 'entityUrl' | 'text', value: <Graph URL or plain text>, webUrl: <required when source='text', click-through URL> }, activityType: <must be declared in the calling Teams app's manifest, OR the reserved 'systemDefault' which provides free-form Actor+Reason text>, previewText: { content: 'short preview' }, templateParameters?: [{ name, value }] (substituted into the manifest's localized notification template), teamsAppId?: <optional disambiguator when multiple installed apps share a Microsoft Entra app ID — fetch via list-my-installed-teams-apps>, chainId?, iconId? }. Use to ping the user with 'action required' notifications from agentic workflows. See https://learn.microsoft.com/graph/teams-send-activityfeednotifications."
   }
 ]