@softeria/ms-365-mcp-server 0.46.2 → 0.47.0

package/dist/endpoints.json

@@ -792,6 +792,27 @@
     "returnDownloadUrl": true,
     "llmTip": "Returns a temporary download URL for the meeting recording in MP4 format. Use the download URL to access the video file. The recording may be large — do not attempt to stream it inline."
   },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports",
+    "method": "get",
+    "toolName": "list-meeting-attendance-reports",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Lists attendance reports for a meeting. Each report has meetingStartDateTime, meetingEndDateTime, totalParticipantCount. For recurring meetings, there is one report per occurrence. Get the meeting ID first via list-online-meetings."
+  },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports/{meetingAttendanceReport-id}",
+    "method": "get",
+    "toolName": "get-meeting-attendance-report",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Gets a specific attendance report with totalParticipantCount, meetingStartDateTime, meetingEndDateTime."
+  },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports/{meetingAttendanceReport-id}/attendanceRecords",
+    "method": "get",
+    "toolName": "list-meeting-attendance-records",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Lists individual attendance records for a meeting report. Each record has: identity (displayName), emailAddress, role (Organizer/Presenter/Attendee), totalAttendanceInSeconds, and attendanceIntervals with joinDateTime/leaveDateTime. Use to determine who attended, how long, and when they joined/left."
+  },
   {
     "pathPattern": "/groups/{group-id}/conversations",
     "method": "get",

package/dist/generated/client.js

@@ -2873,6 +2873,69 @@ const microsoft_graph_onlineMeetingCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_onlineMeeting)
 }).partial().passthrough();
+const microsoft_graph_virtualEventExternalInformation = z.object({
+  applicationId: z.string().describe("Identifier of the application that hosts the externalEventId. Read-only.").nullish(),
+  externalEventId: z.string().describe(
+    "The identifier for a virtualEventExternalInformation object that associates the virtual event with an event ID in an external application. This association bundles all the information (both supported and not supported in virtualEvent) into one virtual event object. Optional. If set, the maximum supported length is 256 characters."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_attendanceInterval = z.object({
+  durationInSeconds: z.number().gte(-2147483648).lte(2147483647).describe(
+    "Duration of the meeting interval in seconds; that is, the difference between joinDateTime and leaveDateTime."
+  ).nullish(),
+  joinDateTime: 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 time the attendee joined in UTC.").nullish(),
+  leaveDateTime: 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 time the attendee left in UTC.").nullish()
+}).passthrough();
+const microsoft_graph_virtualEventExternalRegistrationInformation = z.object({
+  referrer: z.string().describe(
+    "A URL or string that represents the location from which the registrant registered. Optional."
+  ).nullish(),
+  registrationId: z.string().describe(
+    "The identifier for a virtualEventExternalRegistrationInformation object. Optional. If set, the maximum supported length is 256 characters."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_attendanceRecord = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  attendanceIntervals: z.array(microsoft_graph_attendanceInterval).describe("List of time periods between joining and leaving a meeting.").optional(),
+  emailAddress: z.string().describe("Email address of the user associated with this attendance record.").nullish(),
+  externalRegistrationInformation: microsoft_graph_virtualEventExternalRegistrationInformation.optional(),
+  identity: microsoft_graph_identity.optional(),
+  registrationId: z.string().describe(
+    "Unique identifier of a virtualEventRegistration that is available to all participants registered for the virtualEventWebinar."
+  ).nullish(),
+  role: z.string().describe(
+    "Role of the attendee. The possible values are: None, Attendee, Presenter, and Organizer."
+  ).nullish(),
+  totalAttendanceInSeconds: z.number().gte(-2147483648).lte(2147483647).describe("Total duration of the attendances in seconds.").nullish()
+}).passthrough();
+const microsoft_graph_meetingAttendanceReport = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  externalEventInformation: z.array(microsoft_graph_virtualEventExternalInformation).describe(
+    "The external information of a virtual event. Returned only for event organizers or coorganizers. Read-only."
+  ).optional(),
+  meetingEndDateTime: 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("UTC time when the meeting ended. Read-only.").nullish(),
+  meetingStartDateTime: 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("UTC time when the meeting started. Read-only.").nullish(),
+  totalParticipantCount: z.number().gte(-2147483648).lte(2147483647).describe("Total number of participants. Read-only.").nullish(),
+  attendanceRecords: z.array(microsoft_graph_attendanceRecord).describe("List of attendance records of an attendance report. Read-only.").optional()
+}).passthrough();
+const microsoft_graph_meetingAttendanceReportCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_meetingAttendanceReport)
+}).partial().passthrough();
+const microsoft_graph_attendanceRecordCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_attendanceRecord)
+}).partial().passthrough();
 const microsoft_graph_callRecording = z.object({
   id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
   callId: z.string().describe("The unique identifier for the call that is related to this recording. Read-only.").nullish(),
@@ -3778,6 +3841,13 @@ const schemas = {
   microsoft_graph_joinMeetingIdSettings,
   microsoft_graph_onlineMeeting,
   microsoft_graph_onlineMeetingCollectionResponse,
+  microsoft_graph_virtualEventExternalInformation,
+  microsoft_graph_attendanceInterval,
+  microsoft_graph_virtualEventExternalRegistrationInformation,
+  microsoft_graph_attendanceRecord,
+  microsoft_graph_meetingAttendanceReport,
+  microsoft_graph_meetingAttendanceReportCollectionResponse,
+  microsoft_graph_attendanceRecordCollectionResponse,
   microsoft_graph_callRecording,
   microsoft_graph_callRecordingCollectionResponse,
   microsoft_graph_callTranscript,
@@ -6377,6 +6447,126 @@ resource.`,
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/me/onlineMeetings/:onlineMeetingId/attendanceReports",
+    alias: "list-meeting-attendance-reports",
+    description: `Get a list of meetingAttendanceReport objects for an onlineMeeting or a virtualEvent. Each time an online meeting or a virtual event ends, an attendance report is generated for that session.`,
+    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/onlineMeetings/:onlineMeetingId/attendanceReports/:meetingAttendanceReportId",
+    alias: "get-meeting-attendance-report",
+    description: `Get the meetingAttendanceReport for an onlineMeeting or a virtualEvent. When an online meeting ends, an attendance report is generated for that session.`,
+    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: "get",
+    path: "/me/onlineMeetings/:onlineMeetingId/attendanceReports/:meetingAttendanceReportId/attendanceRecords",
+    alias: "list-meeting-attendance-records",
+    description: `Get a list of attendanceRecord objects and their properties.`,
+    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/onlineMeetings/:onlineMeetingId/recordings",

package/logs/mcp-server.log

@@ -1,10 +1,10 @@
-2026-03-25 11:58:50 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 11:58:50 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 11:58:50 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 11:58:50 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
-2026-03-25 11:58:50 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
-2026-03-25 11:58:51 INFO: Using environment variables for secrets
-2026-03-25 11:58:51 INFO: Using environment variables for secrets
-2026-03-25 11:58:51 INFO: Using environment variables for secrets
-2026-03-25 11:58:51 INFO: Using environment variables for secrets
-2026-03-25 11:58:51 INFO: Using environment variables for secrets
+2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
+2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
+2026-03-25 12:50:26 INFO: Using environment variables for secrets
+2026-03-25 12:50:26 INFO: Using environment variables for secrets
+2026-03-25 12:50:26 INFO: Using environment variables for secrets
+2026-03-25 12:50:26 INFO: Using environment variables for secrets
+2026-03-25 12:50:26 INFO: Using environment variables for secrets

package/package.json

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

@@ -792,6 +792,27 @@
     "returnDownloadUrl": true,
     "llmTip": "Returns a temporary download URL for the meeting recording in MP4 format. Use the download URL to access the video file. The recording may be large — do not attempt to stream it inline."
   },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports",
+    "method": "get",
+    "toolName": "list-meeting-attendance-reports",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Lists attendance reports for a meeting. Each report has meetingStartDateTime, meetingEndDateTime, totalParticipantCount. For recurring meetings, there is one report per occurrence. Get the meeting ID first via list-online-meetings."
+  },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports/{meetingAttendanceReport-id}",
+    "method": "get",
+    "toolName": "get-meeting-attendance-report",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Gets a specific attendance report with totalParticipantCount, meetingStartDateTime, meetingEndDateTime."
+  },
+  {
+    "pathPattern": "/me/onlineMeetings/{onlineMeeting-id}/attendanceReports/{meetingAttendanceReport-id}/attendanceRecords",
+    "method": "get",
+    "toolName": "list-meeting-attendance-records",
+    "workScopes": ["OnlineMeetingArtifact.Read.All"],
+    "llmTip": "Lists individual attendance records for a meeting report. Each record has: identity (displayName), emailAddress, role (Organizer/Presenter/Attendee), totalAttendanceInSeconds, and attendanceIntervals with joinDateTime/leaveDateTime. Use to determine who attended, how long, and when they joined/left."
+  },
   {
     "pathPattern": "/groups/{group-id}/conversations",
     "method": "get",