@softeria/ms-365-mcp-server 0.94.0 → 0.95.0

package/dist/endpoints.json

@@ -1408,6 +1408,48 @@
     "workScopes": ["Sites.ReadWrite.All"],
     "llmTip": "Deletes a list item permanently. This cannot be undone — the item is moved to the site recycle bin."
   },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "post",
+    "toolName": "create-sharepoint-list",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new SharePoint list in a site. Body: { displayName: 'My List', description: 'Optional', list: { template: 'genericList' }, columns: [ { name: 'Status', text: {} }, { name: 'Due', dateTime: {} } ] }. Templates include genericList, documentLibrary, tasks, calendar, contacts, links, announcements, survey. Columns can be defined inline at creation; otherwise add them later via create-sharepoint-list-column. Use search-sharepoint-sites or get-sharepoint-site-by-path to find the site ID first."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "get",
+    "toolName": "list-sharepoint-list-columns",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Lists column definitions for a SharePoint list. Returns each column's id, name, displayName, description, type indicator (text, number, choice, dateTime, person, lookup, boolean, calculated, hyperlinkOrPicture, etc.), required, indexed, hidden, readOnly. Use this to discover the schema before creating or updating list items."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "post",
+    "toolName": "create-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new column on a SharePoint list. Body must include name and exactly one column type property: { name: 'Priority', text: {} } or { name: 'DueDate', dateTime: { format: 'dateOnly' } } or { name: 'Status', choice: { choices: ['Open','In Progress','Done'] } }. Other types: number, boolean, currency, hyperlinkOrPicture, personOrGroup, lookup, calculated. Optional: displayName, description, required, indexed, enforceUniqueValues."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-list-column",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Gets a specific column definition by ID, including its full type configuration (choices for choice columns, format for dateTime, etc.). Use list-sharepoint-list-columns first to find the column ID."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "patch",
+    "toolName": "update-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Updates a column definition. Body: { displayName: 'New name', description: 'New description', required: true, ... }. The column type itself (text, choice, etc.) cannot be changed — only its metadata and per-type options (e.g. choices array for a choice column). Send only the fields you want to change."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "delete",
+    "toolName": "delete-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Deletes a column from a SharePoint list. This is irreversible — all data stored in this column across every list item is lost. Confirm with the user before calling. Cannot delete built-in columns (Title, Created, Modified, etc.)."
+  },
   {
     "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
     "method": "get",

package/dist/generated/client.js

@@ -4289,6 +4289,11 @@ const microsoft_graph_listCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_list)
 }).partial().passthrough();
+const microsoft_graph_columnDefinitionCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_columnDefinition)
+}).partial().passthrough();
 const microsoft_graph_listItemCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -4933,6 +4938,7 @@ const schemas = {
   microsoft_graph_siteCollectionResponse,
   microsoft_graph_baseItemCollectionResponse,
   microsoft_graph_listCollectionResponse,
+  microsoft_graph_columnDefinitionCollectionResponse,
   microsoft_graph_listItemCollectionResponse,
   microsoft_graph_endpointType,
   microsoft_graph_communicationsIdentitySet,
@@ -11696,6 +11702,22 @@ To list them, include system in your $select statement.`,
     ],
     response: z.void()
   },
+  {
+    method: "post",
+    path: "/sites/:siteId/lists",
+    alias: "create-sharepoint-list",
+    description: `Create a new list in a site.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_list
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/sites/:siteId/lists/:listId",
@@ -11716,6 +11738,191 @@ To list them, include system in your $select statement.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/sites/:siteId/lists/:listId/columns",
+    alias: "list-sharepoint-list-columns",
+    description: `Get the collection of columns represented as columnDefinition resources in a list.`,
+    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: "/sites/:siteId/lists/:listId/columns",
+    alias: "create-sharepoint-list-column",
+    description: `Create a column for a list with a request that specifies a columnDefinition.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: z.object({
+          id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+          name: z.string().describe(
+            "The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName."
+          ).nullish(),
+          displayName: z.string().describe("The user-facing name of the column.").nullish(),
+          description: z.string().describe("The user-facing description of the column.").nullish(),
+          type: microsoft_graph_columnTypes.optional(),
+          boolean: microsoft_graph_booleanColumn.optional(),
+          calculated: microsoft_graph_calculatedColumn.optional(),
+          choice: microsoft_graph_choiceColumn.optional(),
+          columnGroup: z.string().describe(
+            "For site columns, the name of the group this column belongs to. Helps organize related columns."
+          ).nullish(),
+          contentApprovalStatus: microsoft_graph_contentApprovalStatusColumn.optional(),
+          currency: microsoft_graph_currencyColumn.optional(),
+          dateTime: microsoft_graph_dateTimeColumn.optional(),
+          defaultValue: microsoft_graph_defaultColumnValue.optional(),
+          enforceUniqueValues: z.boolean().describe("If true, no two list items may have the same value for this column.").nullish(),
+          geolocation: microsoft_graph_geolocationColumn.optional(),
+          hidden: z.boolean().describe("Specifies whether the column is displayed in the user interface.").nullish(),
+          hyperlinkOrPicture: microsoft_graph_hyperlinkOrPictureColumn.optional(),
+          indexed: z.boolean().describe(
+            "Specifies whether the column values can be used for sorting and searching."
+          ).nullish(),
+          isDeletable: z.boolean().describe("Indicates whether this column can be deleted.").nullish(),
+          isReorderable: z.boolean().describe("Indicates whether values in the column can be reordered. Read-only.").nullish(),
+          isSealed: z.boolean().describe("Specifies whether the column can be changed.").nullish(),
+          lookup: microsoft_graph_lookupColumn.optional(),
+          number: microsoft_graph_numberColumn.optional(),
+          personOrGroup: microsoft_graph_personOrGroupColumn.optional(),
+          propagateChanges: z.boolean().describe(
+            "If 'true', changes to this column will be propagated to lists that implement the column."
+          ).nullish()
+        }).passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "get-sharepoint-list-column",
+    description: `The collection of field definitions for this list.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        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: "patch",
+    path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "update-sharepoint-list-column",
+    description: `Update the navigation property columns in sites`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property values`,
+        type: "Body",
+        schema: z.object({
+          id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+          name: z.string().describe(
+            "The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName."
+          ).nullish(),
+          displayName: z.string().describe("The user-facing name of the column.").nullish(),
+          description: z.string().describe("The user-facing description of the column.").nullish(),
+          type: microsoft_graph_columnTypes.optional(),
+          boolean: microsoft_graph_booleanColumn.optional(),
+          calculated: microsoft_graph_calculatedColumn.optional(),
+          choice: microsoft_graph_choiceColumn.optional(),
+          columnGroup: z.string().describe(
+            "For site columns, the name of the group this column belongs to. Helps organize related columns."
+          ).nullish(),
+          contentApprovalStatus: microsoft_graph_contentApprovalStatusColumn.optional(),
+          currency: microsoft_graph_currencyColumn.optional(),
+          dateTime: microsoft_graph_dateTimeColumn.optional(),
+          defaultValue: microsoft_graph_defaultColumnValue.optional(),
+          enforceUniqueValues: z.boolean().describe("If true, no two list items may have the same value for this column.").nullish(),
+          geolocation: microsoft_graph_geolocationColumn.optional(),
+          hidden: z.boolean().describe("Specifies whether the column is displayed in the user interface.").nullish(),
+          hyperlinkOrPicture: microsoft_graph_hyperlinkOrPictureColumn.optional(),
+          indexed: z.boolean().describe(
+            "Specifies whether the column values can be used for sorting and searching."
+          ).nullish(),
+          isDeletable: z.boolean().describe("Indicates whether this column can be deleted.").nullish(),
+          isReorderable: z.boolean().describe("Indicates whether values in the column can be reordered. Read-only.").nullish(),
+          isSealed: z.boolean().describe("Specifies whether the column can be changed.").nullish(),
+          lookup: microsoft_graph_lookupColumn.optional(),
+          number: microsoft_graph_numberColumn.optional(),
+          personOrGroup: microsoft_graph_personOrGroupColumn.optional(),
+          propagateChanges: z.boolean().describe(
+            "If 'true', changes to this column will be propagated to lists that implement the column."
+          ).nullish()
+        }).passthrough().passthrough()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/sites/:siteId/lists/:listId/columns/:columnDefinitionId",
+    alias: "delete-sharepoint-list-column",
+    description: `Delete navigation property columns for sites`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/sites/:siteId/lists/:listId/items",

package/package.json

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

@@ -1408,6 +1408,48 @@
     "workScopes": ["Sites.ReadWrite.All"],
     "llmTip": "Deletes a list item permanently. This cannot be undone — the item is moved to the site recycle bin."
   },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "post",
+    "toolName": "create-sharepoint-list",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new SharePoint list in a site. Body: { displayName: 'My List', description: 'Optional', list: { template: 'genericList' }, columns: [ { name: 'Status', text: {} }, { name: 'Due', dateTime: {} } ] }. Templates include genericList, documentLibrary, tasks, calendar, contacts, links, announcements, survey. Columns can be defined inline at creation; otherwise add them later via create-sharepoint-list-column. Use search-sharepoint-sites or get-sharepoint-site-by-path to find the site ID first."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "get",
+    "toolName": "list-sharepoint-list-columns",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Lists column definitions for a SharePoint list. Returns each column's id, name, displayName, description, type indicator (text, number, choice, dateTime, person, lookup, boolean, calculated, hyperlinkOrPicture, etc.), required, indexed, hidden, readOnly. Use this to discover the schema before creating or updating list items."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns",
+    "method": "post",
+    "toolName": "create-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Creates a new column on a SharePoint list. Body must include name and exactly one column type property: { name: 'Priority', text: {} } or { name: 'DueDate', dateTime: { format: 'dateOnly' } } or { name: 'Status', choice: { choices: ['Open','In Progress','Done'] } }. Other types: number, boolean, currency, hyperlinkOrPicture, personOrGroup, lookup, calculated. Optional: displayName, description, required, indexed, enforceUniqueValues."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-list-column",
+    "workScopes": ["Sites.Read.All"],
+    "llmTip": "Gets a specific column definition by ID, including its full type configuration (choices for choice columns, format for dateTime, etc.). Use list-sharepoint-list-columns first to find the column ID."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "patch",
+    "toolName": "update-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Updates a column definition. Body: { displayName: 'New name', description: 'New description', required: true, ... }. The column type itself (text, choice, etc.) cannot be changed — only its metadata and per-type options (e.g. choices array for a choice column). Send only the fields you want to change."
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/columns/{columnDefinition-id}",
+    "method": "delete",
+    "toolName": "delete-sharepoint-list-column",
+    "workScopes": ["Sites.Manage.All"],
+    "llmTip": "Deletes a column from a SharePoint list. This is irreversible — all data stored in this column across every list item is lost. Confirm with the user before calling. Cannot delete built-in columns (Title, Created, Modified, etc.)."
+  },
   {
     "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
     "method": "get",