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

package/dist/endpoints.json

@@ -1925,5 +1925,19 @@
     "toolName": "delete-my-calendar-permission",
     "scopes": ["Calendars.ReadWrite"],
     "llmTip": "Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error."
+  },
+  {
+    "pathPattern": "/me/contactFolders/{contactFolder-id}/childFolders",
+    "method": "get",
+    "toolName": "list-contact-folder-child-folders",
+    "scopes": ["Contacts.Read"],
+    "llmTip": "Lists immediate sub-folders under a given contact folder. Returns id, displayName, parentFolderId. Use list-contact-folders to discover top-level folders, then this tool to traverse one level deeper. Supports $filter, $top, $orderby. Note: contact folders are typically a flat list in Outlook clients, but Graph allows nesting via this endpoint."
+  },
+  {
+    "pathPattern": "/me/contactFolders/{contactFolder-id}/childFolders",
+    "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."
   }
 ]

package/dist/generated/client.js

@@ -2040,6 +2040,28 @@ const microsoft_graph_contact = z.object({
   imAddresses: z.array(z.string().nullable()).describe("The contact's instant messaging (IM) addresses.").optional(),
   initials: z.string().describe("The contact's initials.").nullish()
 }).passthrough().passthrough();
+const microsoft_graph_contactFolder = z.lazy(
+  () => z.object({
+    id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+    displayName: z.string().describe("The folder's display name.").nullish(),
+    parentFolderId: z.string().describe("The ID of the folder's parent folder.").nullish(),
+    childFolders: z.array(microsoft_graph_contactFolder).describe(
+      "The collection of child folders in the folder. Navigation property. Read-only. Nullable."
+    ).optional(),
+    contacts: z.array(microsoft_graph_contact).describe("The contacts in the folder. Navigation property. Read-only. Nullable.").optional(),
+    multiValueExtendedProperties: z.array(microsoft_graph_multiValueLegacyExtendedProperty).describe(
+      "The collection of multi-value extended properties defined for the contactFolder. Read-only. Nullable."
+    ).optional(),
+    singleValueExtendedProperties: z.array(microsoft_graph_singleValueLegacyExtendedProperty).describe(
+      "The collection of single-value extended properties defined for the contactFolder. Read-only. Nullable."
+    ).optional()
+  }).passthrough()
+);
+const microsoft_graph_contactFolderCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_contactFolder)
+}).partial().passthrough();
 const microsoft_graph_contactCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -4736,6 +4758,8 @@ const schemas = {
   microsoft_graph_calendarCollectionResponse,
   microsoft_graph_chatCollectionResponse,
   microsoft_graph_contact,
+  microsoft_graph_contactFolder,
+  microsoft_graph_contactFolderCollectionResponse,
   microsoft_graph_contactCollectionResponse,
   microsoft_graph_labelActionSource,
   microsoft_graph_usageRights,
@@ -7899,6 +7923,72 @@ or from some other calendar of the user.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/contactFolders/:contactFolderId/childFolders",
+    alias: "list-contact-folder-child-folders",
+    description: `Get a collection of child folders under the specified contact folder.`,
+    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/contactFolders/:contactFolderId/childFolders",
+    alias: "create-contact-child-folder",
+    description: `Create a new contactFolder as a child of a specified folder.  You can also create a new contactFolder under the user's default contact folder.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_contactFolder
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/me/contacts",

package/package.json

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

@@ -1925,5 +1925,19 @@
     "toolName": "delete-my-calendar-permission",
     "scopes": ["Calendars.ReadWrite"],
     "llmTip": "Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error."
+  },
+  {
+    "pathPattern": "/me/contactFolders/{contactFolder-id}/childFolders",
+    "method": "get",
+    "toolName": "list-contact-folder-child-folders",
+    "scopes": ["Contacts.Read"],
+    "llmTip": "Lists immediate sub-folders under a given contact folder. Returns id, displayName, parentFolderId. Use list-contact-folders to discover top-level folders, then this tool to traverse one level deeper. Supports $filter, $top, $orderby. Note: contact folders are typically a flat list in Outlook clients, but Graph allows nesting via this endpoint."
+  },
+  {
+    "pathPattern": "/me/contactFolders/{contactFolder-id}/childFolders",
+    "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."
   }
 ]