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

package/dist/endpoints.json

@@ -2010,5 +2010,27 @@
     "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."
+  },
+  {
+    "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."
+  },
+  {
+    "pathPattern": "/me/onenote/sectionGroups",
+    "method": "get",
+    "toolName": "list-onenote-section-groups",
+    "scopes": ["Notes.Read"],
+    "llmTip": "Lists all OneNote section groups (subfolders inside notebooks that contain their own sections and nested section groups) for the user. A section group is a folder-like container — many notebooks use them to organize sections by theme. Default sort is name asc. Supports $expand=sections,sectionGroups,parentNotebook,parentSectionGroup to traverse the full hierarchy. Pair with list-onenote-notebooks for a complete picture of the user's notebook structure."
+  },
+  {
+    "pathPattern": "/me/onenote/notebooks/getNotebookFromWebUrl",
+    "method": "post",
+    "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."
   }
 ]

package/dist/generated/client.js

@@ -3341,11 +3341,37 @@ const microsoft_graph_onenoteSectionCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_onenoteSection)
 }).partial().passthrough();
+const microsoft_graph_CopyNotebookModel = z.object({
+  createdBy: z.string().nullish(),
+  createdByIdentity: microsoft_graph_identitySet.optional(),
+  createdTime: 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 }).nullish(),
+  id: z.string().nullish(),
+  isDefault: z.boolean().nullish(),
+  isShared: z.boolean().nullish(),
+  lastModifiedBy: z.string().nullish(),
+  lastModifiedByIdentity: microsoft_graph_identitySet.optional(),
+  lastModifiedTime: 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 }).nullish(),
+  links: microsoft_graph_notebookLinks.optional(),
+  name: z.string().nullish(),
+  sectionGroupsUrl: z.string().nullish(),
+  sectionsUrl: z.string().nullish(),
+  self: z.string().nullish(),
+  userRole: microsoft_graph_onenoteUserRole.optional()
+}).passthrough();
 const microsoft_graph_onenotePageCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_onenotePage)
 }).partial().passthrough();
+const microsoft_graph_sectionGroupCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_sectionGroup)
+}).partial().passthrough();
 const microsoft_graph_allowedLobbyAdmitterRoles = z.enum([
   "organizerAndCoOrganizersAndPresenters",
   "organizerAndCoOrganizers",
@@ -4883,7 +4909,9 @@ const schemas = {
   microsoft_graph_notebook,
   microsoft_graph_notebookCollectionResponse,
   microsoft_graph_onenoteSectionCollectionResponse,
+  microsoft_graph_CopyNotebookModel,
   microsoft_graph_onenotePageCollectionResponse,
+  microsoft_graph_sectionGroupCollectionResponse,
   microsoft_graph_allowedLobbyAdmitterRoles,
   microsoft_graph_onlineMeetingPresenters,
   microsoft_graph_meetingLiveShareOptions,
@@ -10333,6 +10361,72 @@ resource.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/me/onenote/notebooks/getNotebookFromWebUrl",
+    alias: "get-onenote-notebook-from-web-url",
+    description: `Retrieve the properties and relationships of a notebook object by using its URL path. The location can be user notebooks on Microsoft 365, group notebooks, or SharePoint site-hosted team notebooks on Microsoft 365.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `Action parameters`,
+        type: "Body",
+        schema: z.object({ webUrl: z.string().nullable() }).partial().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: "/me/onenote/pages",
+    alias: "list-onenote-pages",
+    description: `Retrieve a list of page objects.`,
+    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/onenote/pages",
@@ -10372,6 +10466,56 @@ resource.`,
     requestFormat: "json",
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/onenote/sectionGroups",
+    alias: "list-onenote-section-groups",
+    description: `Retrieve a list of sectionGroup objects.`,
+    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/onenote/sections",

package/package.json

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

@@ -2010,5 +2010,27 @@
     "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."
+  },
+  {
+    "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."
+  },
+  {
+    "pathPattern": "/me/onenote/sectionGroups",
+    "method": "get",
+    "toolName": "list-onenote-section-groups",
+    "scopes": ["Notes.Read"],
+    "llmTip": "Lists all OneNote section groups (subfolders inside notebooks that contain their own sections and nested section groups) for the user. A section group is a folder-like container — many notebooks use them to organize sections by theme. Default sort is name asc. Supports $expand=sections,sectionGroups,parentNotebook,parentSectionGroup to traverse the full hierarchy. Pair with list-onenote-notebooks for a complete picture of the user's notebook structure."
+  },
+  {
+    "pathPattern": "/me/onenote/notebooks/getNotebookFromWebUrl",
+    "method": "post",
+    "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."
   }
 ]