@sam2kb/m365-mcp 1.1.1 → 1.2.1

package/README.md

@@ -33,7 +33,7 @@ as reviewed on July 18, 2026.
 | Tasks | ✅ | ❌ | ✅ |
 | Users | ✅ | ❌ | ✅ |
 | Implementation | TypeScript | JavaScript CLI | TypeScript |
-| Interface coverage | 19 MCP tools | CLI scripts | **46 MCP tools** |
+| Interface coverage | 19 MCP tools | CLI scripts | **47 MCP tools** |
 
 `m365-mcp` does not store a client secret or password. Tenant and client IDs are
 non-secret identifiers; sensitive OAuth access and refresh tokens are stored
@@ -209,7 +209,7 @@ Changing an account's tenant or client ID clears that account's cached tokens.
 Sign in again after changing permissions or the read-only/directory settings.
 Login checks cached permissions before reusing a token.
 
-## Available Tools (46)
+## Available Tools (47)
 
 ### 📧 Mail (9 tools)
 | Tool | Description |
@@ -224,10 +224,11 @@ Login checks cached permissions before reusing a token.
 | `m365_mail_mark_read` | Mark as read/unread |
 | `m365_mail_folders` | List all mail folders with counts |
 
-### 📅 Calendar (9 tools)
+### 📅 Calendar (10 tools)
 | Tool | Description |
 |---|---|
 | `m365_calendar_list` | Events in a date range (paginated) |
+| `m365_calendar_get` | Read an event and its notes, with bounded output and truncation status |
 | `m365_calendar_today` | Today's events, nicely formatted |
 | `m365_calendar_week` | Week view grouped by day |
 | `m365_calendar_create` | Create event (optional Teams meeting) |
@@ -237,6 +238,29 @@ Login checks cached permissions before reusing a token.
 | `m365_calendar_decline` | Decline an invitation as an attendee |
 | `m365_calendar_availability` | Free/busy lookup |
 
+#### Event notes and specific calendars
+
+`m365_calendar_list`, `m365_calendar_get`, `m365_calendar_create`, and
+`m365_calendar_update` accept an optional `calendarId` for a calendar under the
+signed-in user's `/me/calendars` collection. Omitting it preserves the existing
+`/me/events` or `/me/calendarView` behavior. IDs are opaque values, not URLs.
+
+Use `m365_calendar_get` with `eventId` to read notes. It returns
+`body: { contentType, content }`, `bodyLength`, and `bodyTruncated`. The default
+limit is 10,000 UTF-16 code units; `maxBodyChars` accepts integers from 0 to 50,000.
+Zero returns only body metadata. The tool preserves the format returned by
+Graph, which defaults to HTML; truncated HTML may be incomplete. List results remain
+compact and do not include full notes. Do not mistake truncated notes for the
+complete event body or write the truncated result back as a replacement.
+
+Create and update accept `bodyContentType: "text" | "html"` when supplying
+`body`; the default remains `"html"`. On update, omitting `body` leaves notes
+unchanged, while `body: ""` explicitly clears them. A body update replaces the
+existing notes; for online meetings, preserve the meeting details in that body.
+These operations use the existing delegated `Calendars.Read` /
+`Calendars.ReadWrite` permissions, with no additional OAuth scopes. The new get
+tool is available in read-only mode; create and update remain blocked there.
+
 Calendar listings include `isOrganizer` and `responseStatus` so clients can
 choose the correct action. Cancellation is organizer-only and notifies attendees;
 decline is attendee-only. There is no ambiguous silent-remove tool.

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: m365-mcp
-description: Production-grade Microsoft 365 MCP server with delegated OAuth, multi-account support, pagination, rate limiting, and 46 tools covering email, calendar, contacts, OneDrive, Teams, tasks, and users.
+description: Production-grade Microsoft 365 MCP server with delegated OAuth, multi-account support, pagination, rate limiting, and 47 tools covering email, calendar, contacts, OneDrive, Teams, tasks, and users.
 metadata:
   openclaw:
     homepage: https://github.com/sam2kb/m365-mcp#readme
@@ -48,9 +48,14 @@ Production-grade Microsoft 365 MCP server combining the best of office365-connec
 
 - List, read, send, reply, search, move, delete, mark read/unread, list folders
 
-### Calendar (9 tools)
+### Calendar (10 tools)
 
-- List events with organizer/response status, today view, week view, create (with Teams meeting), update, explicit organizer cancellation, attendee decline, free/busy
+- List events with organizer/response status, read event notes, today view, week view, create (with Teams meeting), update, explicit organizer cancellation, attendee decline, free/busy
+
+List, get, create, and update accept an optional calendar ID. Note reads include
+body format, full length, and truncation status. Do not write truncated notes
+back as a complete body. When replacing online-meeting notes, preserve the
+meeting details in the body.
 
 ### Contacts (12 tools)
 

package/dist/index.js

@@ -70,6 +70,8 @@ async function handleToolCall(name, args) {
     // Calendar
     if (name === "m365_calendar_list")
         return calendarTools.calendar_list(args);
+    if (name === "m365_calendar_get")
+        return calendarTools.calendar_get(args);
     if (name === "m365_calendar_today")
         return calendarTools.calendar_today();
     if (name === "m365_calendar_week")

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/security.js

@@ -7,6 +7,7 @@ const READ_ONLY_TOOLS = new Set([
     "m365_mail_search",
     "m365_mail_folders",
     "m365_calendar_list",
+    "m365_calendar_get",
     "m365_calendar_today",
     "m365_calendar_week",
     "m365_calendar_availability",

package/dist/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"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"}

package/dist/tools/calendar.d.ts

@@ -1,5 +1,5 @@
 /**
- * Calendar tools — list, today, week, create, update, cancel, decline, availability
+ * Calendar tools — list, get, today, week, create, update, cancel, decline, availability
  */
 import type { GraphClient } from "../graph.js";
 /** Build ISO 8601 start/end strings for a day in the given timezone. */
@@ -9,27 +9,37 @@ export declare function tzDayBounds(timezone: string, offsetDays?: number): {
 };
 export declare function registerCalendarTools(client: GraphClient): {
     calendar_list(args: {
+        calendarId?: string;
         startDateTime?: string;
         endDateTime?: string;
         top?: number;
     }): Promise<string>;
+    calendar_get(args: {
+        eventId: string;
+        calendarId?: string;
+        maxBodyChars?: number;
+    }): Promise<string>;
     calendar_today(): Promise<string>;
     calendar_week(): Promise<string>;
     calendar_create(args: {
+        calendarId?: string;
         subject: string;
         start: string;
         end: string;
         body?: string;
+        bodyContentType?: "text" | "html";
         location?: string;
         attendees?: string;
         isOnline?: boolean;
     }): Promise<string>;
     calendar_update(args: {
         eventId: string;
+        calendarId?: string;
         subject?: string;
         start?: string;
         end?: string;
         body?: string;
+        bodyContentType?: "text" | "html";
         location?: string;
     }): Promise<string>;
     calendar_delete(args: {
@@ -57,6 +67,11 @@ export declare const calendarToolSchemas: ({
     inputSchema: {
         type: string;
         properties: {
+            calendarId: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
             startDateTime: {
                 type: string;
                 description: string;
@@ -72,14 +87,16 @@ export declare const calendarToolSchemas: ({
                 description: string;
                 default: number;
             };
+            eventId?: undefined;
+            maxBodyChars?: undefined;
             subject?: undefined;
             start?: undefined;
             end?: undefined;
             body?: undefined;
+            bodyContentType?: undefined;
             location?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
-            eventId?: undefined;
             comment?: undefined;
             sendResponse?: undefined;
             users?: undefined;
@@ -92,6 +109,23 @@ export declare const calendarToolSchemas: ({
     inputSchema: {
         type: string;
         properties: {
+            eventId: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
+            calendarId: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
+            maxBodyChars: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
             startDateTime?: undefined;
             endDateTime?: undefined;
             top?: undefined;
@@ -99,10 +133,36 @@ export declare const calendarToolSchemas: ({
             start?: undefined;
             end?: undefined;
             body?: undefined;
+            bodyContentType?: undefined;
             location?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
+            comment?: undefined;
+            sendResponse?: undefined;
+            users?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            calendarId?: undefined;
+            startDateTime?: undefined;
+            endDateTime?: undefined;
+            top?: undefined;
             eventId?: undefined;
+            maxBodyChars?: undefined;
+            subject?: undefined;
+            start?: undefined;
+            end?: undefined;
+            body?: undefined;
+            bodyContentType?: undefined;
+            location?: undefined;
+            attendees?: undefined;
+            isOnline?: undefined;
             comment?: undefined;
             sendResponse?: undefined;
             users?: undefined;
@@ -115,6 +175,11 @@ export declare const calendarToolSchemas: ({
     inputSchema: {
         type: string;
         properties: {
+            calendarId: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
             subject: {
                 type: string;
                 description: string;
@@ -131,6 +196,12 @@ export declare const calendarToolSchemas: ({
                 type: string;
                 description: string;
             };
+            bodyContentType: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
             location: {
                 type: string;
                 description: string;
@@ -147,6 +218,7 @@ export declare const calendarToolSchemas: ({
             endDateTime?: undefined;
             top?: undefined;
             eventId?: undefined;
+            maxBodyChars?: undefined;
             comment?: undefined;
             sendResponse?: undefined;
             users?: undefined;
@@ -162,6 +234,12 @@ export declare const calendarToolSchemas: ({
             eventId: {
                 type: string;
                 description: string;
+                minLength?: undefined;
+            };
+            calendarId: {
+                type: string;
+                minLength: number;
+                description: string;
             };
             subject: {
                 type: string;
@@ -179,6 +257,12 @@ export declare const calendarToolSchemas: ({
                 type: string;
                 description: string;
             };
+            bodyContentType: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
             location: {
                 type: string;
                 description: string;
@@ -186,6 +270,7 @@ export declare const calendarToolSchemas: ({
             startDateTime?: undefined;
             endDateTime?: undefined;
             top?: undefined;
+            maxBodyChars?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
             comment?: undefined;
@@ -203,18 +288,22 @@ export declare const calendarToolSchemas: ({
             eventId: {
                 type: string;
                 description: string;
+                minLength?: undefined;
             };
             comment: {
                 type: string;
                 description: string;
             };
+            calendarId?: undefined;
             startDateTime?: undefined;
             endDateTime?: undefined;
             top?: undefined;
+            maxBodyChars?: undefined;
             subject?: undefined;
             start?: undefined;
             end?: undefined;
             body?: undefined;
+            bodyContentType?: undefined;
             location?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
@@ -232,6 +321,7 @@ export declare const calendarToolSchemas: ({
             eventId: {
                 type: string;
                 description: string;
+                minLength?: undefined;
             };
             comment: {
                 type: string;
@@ -241,13 +331,16 @@ export declare const calendarToolSchemas: ({
                 type: string;
                 description: string;
             };
+            calendarId?: undefined;
             startDateTime?: undefined;
             endDateTime?: undefined;
             top?: undefined;
+            maxBodyChars?: undefined;
             subject?: undefined;
             start?: undefined;
             end?: undefined;
             body?: undefined;
+            bodyContentType?: undefined;
             location?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
@@ -273,15 +366,18 @@ export declare const calendarToolSchemas: ({
                 type: string;
                 description: string;
             };
+            calendarId?: undefined;
             top?: undefined;
+            eventId?: undefined;
+            maxBodyChars?: undefined;
             subject?: undefined;
             start?: undefined;
             end?: undefined;
             body?: undefined;
+            bodyContentType?: undefined;
             location?: undefined;
             attendees?: undefined;
             isOnline?: undefined;
-            eventId?: undefined;
             comment?: undefined;
             sendResponse?: undefined;
         };

package/dist/tools/calendar.js

@@ -1,7 +1,21 @@
 /**
- * Calendar tools — list, today, week, create, update, cancel, decline, availability
+ * Calendar tools — list, get, today, week, create, update, cancel, decline, availability
  */
 import { normalizeTop } from "../validation.js";
+function calendarScope(calendarId) {
+    if (calendarId === undefined)
+        return "/me";
+    if (typeof calendarId !== "string" || !calendarId.trim() || calendarId === "." || calendarId === "..") {
+        throw new Error("calendarId must be a non-empty calendar ID");
+    }
+    return `/me/calendars/${encodeURIComponent(calendarId)}`;
+}
+function noteBody(content, contentType = "html") {
+    if (typeof content !== "string" || (contentType !== "text" && contentType !== "html")) {
+        throw new Error("body must be a string and bodyContentType must be text or html");
+    }
+    return { contentType: contentType === "text" ? "Text" : "HTML", content };
+}
 /** Build ISO 8601 start/end strings for a day in the given timezone. */
 export function tzDayBounds(timezone, offsetDays = 0) {
     const parts = new Intl.DateTimeFormat("en-US", {
@@ -48,14 +62,15 @@ export function registerCalendarTools(client) {
         // ── list ─────────────────────────────────────────────────────
         async calendar_list(args) {
             const top = normalizeTop(args.top, 50);
+            const scope = calendarScope(args.calendarId);
             if (!!args.startDateTime !== !!args.endDateTime)
                 throw new Error("Provide both startDateTime and endDateTime");
             let path;
             if (args.startDateTime && args.endDateTime) {
-                path = `${user}/calendarView?startDateTime=${encodeURIComponent(args.startDateTime)}&endDateTime=${encodeURIComponent(args.endDateTime)}&$top=${top}&$orderby=start/dateTime&$select=id,subject,start,end,location,isOnlineMeeting,onlineMeeting,onlineMeetingUrl,organizer,attendees,isAllDay,isOrganizer,responseStatus,webLink`;
+                path = `${scope}/calendarView?startDateTime=${encodeURIComponent(args.startDateTime)}&endDateTime=${encodeURIComponent(args.endDateTime)}&$top=${top}&$orderby=start/dateTime&$select=id,subject,start,end,location,isOnlineMeeting,onlineMeeting,onlineMeetingUrl,organizer,attendees,isAllDay,isOrganizer,responseStatus,webLink`;
             }
             else {
-                path = `${user}/events?$top=${top}&$orderby=start/dateTime&$select=id,subject,start,end,location,isOnlineMeeting,onlineMeeting,onlineMeetingUrl,organizer,attendees,isAllDay,isOrganizer,responseStatus,webLink`;
+                path = `${scope}/events?$top=${top}&$orderby=start/dateTime&$select=id,subject,start,end,location,isOnlineMeeting,onlineMeeting,onlineMeetingUrl,organizer,attendees,isAllDay,isOrganizer,responseStatus,webLink`;
             }
             const events = await client.getAll(path, 10, top);
             return JSON.stringify(events.map((e) => ({
@@ -74,6 +89,28 @@ export function registerCalendarTools(client) {
                 webLink: e.webLink,
             })), null, 2);
         },
+        // ── get ──────────────────────────────────────────────────────
+        async calendar_get(args) {
+            const limit = args.maxBodyChars ?? 10_000;
+            if (!Number.isInteger(limit) || limit < 0 || limit > 50_000) {
+                throw new Error("maxBodyChars must be an integer between 0 and 50000");
+            }
+            if (typeof args.eventId !== "string" || !args.eventId.trim() || args.eventId === "." || args.eventId === "..") {
+                throw new Error("eventId must be a non-empty event ID");
+            }
+            const event = await client.get(`${calendarScope(args.calendarId)}/events/${encodeURIComponent(args.eventId)}?$select=id,subject,start,end,body,webLink`);
+            const content = event.body?.content ?? "";
+            return JSON.stringify({
+                id: event.id,
+                subject: event.subject,
+                start: event.start,
+                end: event.end,
+                body: { contentType: event.body?.contentType ?? "text", content: content.slice(0, limit) },
+                bodyTruncated: content.length > limit,
+                bodyLength: content.length,
+                webLink: event.webLink,
+            }, null, 2);
+        },
         // ── today ────────────────────────────────────────────────────
         async calendar_today() {
             const bounds = tzDayBounds(client.timezone);
@@ -132,8 +169,8 @@ export function registerCalendarTools(client) {
                 start: client.dateTimeStr(args.start),
                 end: client.dateTimeStr(args.end),
             };
-            if (args.body)
-                event.body = { contentType: "HTML", content: args.body };
+            if (args.body !== undefined)
+                event.body = noteBody(args.body, args.bodyContentType);
             if (args.location)
                 event.location = { displayName: args.location };
             if (args.attendees) {
@@ -146,7 +183,7 @@ export function registerCalendarTools(client) {
                 event.isOnlineMeeting = true;
                 event.onlineMeetingProvider = "teamsForBusiness";
             }
-            const data = await client.post(`${user}/events`, event);
+            const data = await client.post(`${calendarScope(args.calendarId)}/events`, event);
             return JSON.stringify({
                 id: data.id,
                 subject: data.subject,
@@ -164,13 +201,13 @@ export function registerCalendarTools(client) {
             if (args.end)
                 patch.end = client.dateTimeStr(args.end);
             if (args.body !== undefined)
-                patch.body = { contentType: "HTML", content: args.body };
+                patch.body = noteBody(args.body, args.bodyContentType);
             if (args.location !== undefined)
                 patch.location = { displayName: args.location };
             if (Object.keys(patch).length === 0)
                 throw new Error("Provide at least one event field to update");
             const eventId = encodeURIComponent(args.eventId);
-            await client.patch(`${user}/events/${eventId}`, patch);
+            await client.patch(`${calendarScope(args.calendarId)}/events/${eventId}`, patch);
             return JSON.stringify({ success: true, eventId: args.eventId });
         },
         // ── delete (legacy organizer-cancel alias) ──────────────────
@@ -210,12 +247,26 @@ export const calendarToolSchemas = [
         inputSchema: {
             type: "object",
             properties: {
+                calendarId: { type: "string", minLength: 1, description: "Optional calendar ID; omit to preserve the default /me event scope" },
                 startDateTime: { type: "string", description: "Start datetime (ISO 8601)" },
                 endDateTime: { type: "string", description: "End datetime (ISO 8601)" },
                 top: { type: "integer", minimum: 1, maximum: 500, description: "Max events", default: 50 },
             },
         },
     },
+    {
+        name: "m365_calendar_get",
+        description: "Read one event including its notes, with body format, length and explicit truncation status",
+        inputSchema: {
+            type: "object",
+            properties: {
+                eventId: { type: "string", minLength: 1, description: "Event ID" },
+                calendarId: { type: "string", minLength: 1, description: "Optional calendar ID for a specific calendar" },
+                maxBodyChars: { type: "integer", minimum: 0, maximum: 50_000, default: 10_000, description: "Maximum returned note characters (UTF-16 code units); 0 returns metadata only" },
+            },
+            required: ["eventId"],
+        },
+    },
     {
         name: "m365_calendar_today",
         description: "Show today's calendar events",
@@ -228,40 +279,44 @@ export const calendarToolSchemas = [
     },
     {
         name: "m365_calendar_create",
-        description: "Create a calendar event (with optional Teams meeting)",
+        description: "Create a new event in your default or selected mailbox calendar, optionally as a Teams meeting. Supplying attendees sends invitation emails; omit them for a personal appointment. Use m365_calendar_update to edit an event or m365_calendar_availability to check free/busy first. Returns the event ID and available links. Repeated calls can create duplicate events; check m365_calendar_list before resubmitting after an uncertain outcome.",
         inputSchema: {
             type: "object",
             properties: {
+                calendarId: { type: "string", minLength: 1, description: "Optional ID of a calendar in your mailbox; omit for the default calendar. Does not grant shared-calendar access" },
                 subject: { type: "string", description: "Event title" },
-                start: { type: "string", description: "Start datetime (ISO 8601)" },
-                end: { type: "string", description: "End datetime (ISO 8601)" },
-                body: { type: "string", description: "Event description (HTML)" },
+                start: { type: "string", description: "Start date-time (ISO 8601); omit the offset to use the configured timezone, or include Z/an offset for an exact instant" },
+                end: { type: "string", description: "End date-time (ISO 8601), using the same timezone conventions as start" },
+                body: { type: "string", description: "Event notes; HTML by default" },
+                bodyContentType: { type: "string", enum: ["text", "html"], default: "html", description: "Format of the supplied body" },
                 location: { type: "string", description: "Event location" },
-                attendees: { type: "string", description: "Attendee emails, comma-separated" },
-                isOnline: { type: "boolean", description: "Create as Teams meeting" },
+                attendees: { type: "string", description: "Comma-separated email addresses; supplying attendees sends meeting invitations" },
+                isOnline: { type: "boolean", description: "Create a Teams meeting when true; requires Teams support in the selected calendar" },
             },
             required: ["subject", "start", "end"],
         },
     },
     {
         name: "m365_calendar_update",
-        description: "Update an existing calendar event",
+        description: "Change supplied fields on an existing event; omitted fields stay unchanged. Meeting changes may notify attendees. Body updates replace the notes: first read m365_calendar_get and preserve online-meeting details. Use m365_calendar_create for a new event or m365_calendar_cancel to cancel. Returns success and eventId. Check the event before repeating an update after an uncertain outcome.",
         inputSchema: {
             type: "object",
             properties: {
-                eventId: { type: "string", description: "Event ID" },
-                subject: { type: "string", description: "New subject" },
-                start: { type: "string", description: "New start time (ISO 8601)" },
-                end: { type: "string", description: "New end time (ISO 8601)" },
-                body: { type: "string", description: "New description" },
-                location: { type: "string", description: "New location" },
+                eventId: { type: "string", description: "Existing event ID from m365_calendar_list; must belong to the selected calendar" },
+                calendarId: { type: "string", minLength: 1, description: "Optional mailbox calendar ID matching the event; omit to use the default /me event scope" },
+                subject: { type: "string", description: "Replacement subject; omit to preserve it" },
+                start: { type: "string", description: "New ISO 8601 start date-time; no offset uses the configured timezone; Z/an offset specifies an instant" },
+                end: { type: "string", description: "New ISO 8601 end date-time, using the same timezone conventions as start" },
+                body: { type: "string", description: "Replacement notes; omit to preserve, or pass an empty string to clear. For online meetings preserve the meeting details in the body." },
+                bodyContentType: { type: "string", enum: ["text", "html"], default: "html", description: "Format of the supplied body" },
+                location: { type: "string", description: "Replacement location; omit to preserve it or use an empty string to clear it" },
             },
             required: ["eventId"],
         },
     },
     {
         name: "m365_calendar_delete",
-        description: "Legacy alias: cancel a calendar event you organize and notify attendees",
+        description: "Compatibility alias for m365_calendar_cancel: cancel an event you organize and send cancellation notices to attendees. Prefer m365_calendar_cancel for new calls; this is not a silent delete or an attendee decline. Use m365_calendar_decline for received invitations. Returns success and eventId; check the calendar before retrying an uncertain cancellation.",
         inputSchema: {
             type: "object",
             properties: {
@@ -285,12 +340,12 @@ export const calendarToolSchemas = [
     },
     {
         name: "m365_calendar_decline",
-        description: "Decline a calendar invitation as an attendee",
+        description: "Decline a received invitation as an attendee, not an event you organize. By default a response email goes to the organizer; set sendResponse=false to suppress it. Use m365_calendar_cancel if you are the organizer. Returns success and eventId; check response status in m365_calendar_list before retrying an uncertain decline.",
         inputSchema: {
             type: "object",
             properties: {
-                eventId: { type: "string", description: "Event ID" },
-                comment: { type: "string", description: "Optional response to the organizer" },
+                eventId: { type: "string", description: "ID of a received invitation from m365_calendar_list" },
+                comment: { type: "string", description: "Optional text to include in the response email when sendResponse=true" },
                 sendResponse: { type: "boolean", description: "Send the response to the organizer (default: true)" },
             },
             required: ["eventId"],
@@ -298,13 +353,13 @@ export const calendarToolSchemas = [
     },
     {
         name: "m365_calendar_availability",
-        description: "Check free/busy availability for users",
+        description: "Read free/busy schedules for the supplied users and time range, including a 30-minute availability view. This does not book a meeting or send invitations. Use m365_calendar_create after selecting a time, or m365_calendar_list for your event details. Returns per-user schedules and any Graph-reported errors.",
         inputSchema: {
             type: "object",
             properties: {
-                users: { type: "string", description: "User emails to check, comma-separated" },
-                startDateTime: { type: "string", description: "Start (ISO 8601)" },
-                endDateTime: { type: "string", description: "End (ISO 8601)" },
+                users: { type: "string", description: "Comma-separated mailbox email addresses to check" },
+                startDateTime: { type: "string", description: "Range start (ISO 8601); no offset uses the configured timezone; Z/an offset specifies an instant" },
+                endDateTime: { type: "string", description: "Range end (ISO 8601), using the same timezone conventions as startDateTime" },
             },
             required: ["users", "startDateTime", "endDateTime"],
         },