@juvantlabs/m365-graph-mcp-server 0.1.0

package/dist/tools/get_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_event.d.ts","sourceRoot":"","sources":["../../src/tools/get_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAoBxF,UAAU,SAAU,SAAQ,UAAU,CAAC,OAAO,cAAc,CAAC;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYrE;AAgBD,eAAO,MAAM,YAAY,EAAE,IAA8B,CAAC"}

package/dist/tools/get_event.js

@@ -0,0 +1,55 @@
+/**
+ * Tool: m365-graph:get_event
+ *
+ * Fetch a single event's full detail (including the full body,
+ * attendees with response statuses, location, recurrence rule for
+ * series masters). Wraps Graph `/me/events/{id}`.
+ *
+ * Required Graph scope: `Calendars.Read` (delegated). Read-only.
+ *
+ * Input:
+ *   event_id  (string, required) — id from list_events / search_events
+ *
+ * Output: full event summary plus `body` (the long-form HTML/text
+ * preview, capped) and `recurrence` (the recurrence rule if any).
+ */
+import { summarizeEvent } from "./list_events.js";
+import { validateRequiredString } from "../types/validators.js";
+const BODY_CHAR_CAP = 8_000;
+const definition = {
+    name: "m365-graph:get_event",
+    description: "Fetch full details for a single event — body, attendees with response statuses, location, recurrence rule. Body is capped at 8000 chars; use the webLink for full content. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            event_id: {
+                type: "string",
+                description: "Event ID from list_events or search_events.",
+            },
+        },
+        required: ["event_id"],
+    },
+};
+export function expandEvent(event) {
+    const summary = summarizeEvent(event);
+    const body = event.body;
+    const bodyContent = String(body?.content ?? "");
+    const truncated = bodyContent.length > BODY_CHAR_CAP;
+    return {
+        ...summary,
+        body_content_type: String(body?.contentType ?? "text"),
+        body: truncated ? bodyContent.slice(0, BODY_CHAR_CAP) : bodyContent,
+        body_truncated: truncated,
+        recurrence: event.recurrence ?? null,
+    };
+}
+const handler = async (graph, args) => {
+    const eventId = validateRequiredString(args.event_id, "event_id");
+    const event = await graph.api(`/me/events/${encodeURIComponent(eventId)}`).get();
+    const result = expandEvent(event);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+};
+export const getEventTool = { definition, handler };
+//# sourceMappingURL=get_event.js.map

package/dist/tools/get_event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_event.js","sourceRoot":"","sources":["../../src/tools/get_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B,MAAM,UAAU,GAAmB;IACjC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,uLAAuL;IACzL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC;AASF,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAA2C,CAAC;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC;IACrD,OAAO;QACL,GAAG,OAAO;QACV,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,MAAM,CAAC;QACtD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW;QACnE,cAAc,EAAE,SAAS;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAgB,KAAK,EAChC,KAAa,EACb,IAA6B,EACN,EAAE;IACzB,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAElE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,cAAc,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACjF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool registry — single source of truth for which tools the server
+ * exposes. Both the tools/list handler and the tools/call dispatcher
+ * read from this module.
+ *
+ * Each new tool: add an import here + push into ALL_TOOLS. The
+ * dispatcher in src/index.ts builds a map from tool name to handler
+ * once at startup; no per-call registration overhead.
+ */
+import type { Tool } from "../types/tool.js";
+export declare const ALL_TOOLS: ReadonlyArray<Tool>;
+export declare function buildHandlerMap(tools: ReadonlyArray<Tool>): Map<string, Tool["handler"]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAuB7C,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,IAAI,CAsBzC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAMxF"}

package/dist/tools/index.js

@@ -0,0 +1,61 @@
+/**
+ * Tool registry — single source of truth for which tools the server
+ * exposes. Both the tools/list handler and the tools/call dispatcher
+ * read from this module.
+ *
+ * Each new tool: add an import here + push into ALL_TOOLS. The
+ * dispatcher in src/index.ts builds a map from tool name to handler
+ * once at startup; no per-call registration overhead.
+ */
+// Files — read
+import { downloadFileTool } from "./download_file.js";
+import { listDrivesTool } from "./list_drives.js";
+import { listItemsTool } from "./list_items.js";
+import { searchFilesTool } from "./search_files.js";
+// Files — write
+import { copyFileTool } from "./copy_file.js";
+import { deleteFileTool } from "./delete_file.js";
+import { moveFileTool } from "./move_file.js";
+import { uploadFileTool } from "./upload_file.js";
+// Calendars — read
+import { getEventTool } from "./get_event.js";
+import { listCalendarsTool } from "./list_calendars.js";
+import { listEventsTool } from "./list_events.js";
+import { searchEventsTool } from "./search_events.js";
+import { searchEventsContentTool } from "./search_events_content.js";
+// Calendars — write
+import { cancelEventTool } from "./cancel_event.js";
+import { createEventTool } from "./create_event.js";
+import { declineEventTool } from "./decline_event.js";
+import { updateEventTool } from "./update_event.js";
+export const ALL_TOOLS = [
+    // Files — read
+    listDrivesTool,
+    listItemsTool,
+    searchFilesTool,
+    downloadFileTool,
+    // Files — write
+    uploadFileTool,
+    copyFileTool,
+    moveFileTool,
+    deleteFileTool,
+    // Calendars — read
+    listCalendarsTool,
+    listEventsTool,
+    searchEventsTool,
+    searchEventsContentTool,
+    getEventTool,
+    // Calendars — write
+    createEventTool,
+    updateEventTool,
+    cancelEventTool,
+    declineEventTool,
+];
+export function buildHandlerMap(tools) {
+    const m = new Map();
+    for (const t of tools) {
+        m.set(t.definition.name, t.handler);
+    }
+    return m;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,MAAM,SAAS,GAAwB;IAC5C,eAAe;IACf,cAAc;IACd,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,uBAAuB;IACvB,YAAY;IACZ,oBAAoB;IACpB,eAAe;IACf,eAAe;IACf,eAAe;IACf,gBAAgB;CACjB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,KAA0B;IACxD,MAAM,CAAC,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/tools/list_calendars.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool: m365-graph:list_calendars
+ *
+ * List the user's calendars (primary calendar + any group / shared
+ * calendars they have access to). Wraps Graph `/me/calendars`.
+ *
+ * Required Graph scope: `Calendars.Read` (delegated). Read-only.
+ *
+ * Output: JSON list of calendars with id, name, color, owner,
+ * canEdit, canShare, isDefaultCalendar.
+ */
+import type { Tool } from "../types/tool.js";
+interface CalendarSummary {
+    id: string;
+    name: string;
+    color: string;
+    owner_name: string | null;
+    owner_email: string | null;
+    is_default: boolean;
+    can_edit: boolean;
+    can_share: boolean;
+}
+export declare function summarizeCalendar(cal: Record<string, unknown>): CalendarSummary;
+export declare const listCalendarsTool: Tool;
+export {};
+//# sourceMappingURL=list_calendars.d.ts.map

package/dist/tools/list_calendars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_calendars.d.ts","sourceRoot":"","sources":["../../src/tools/list_calendars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAoBxF,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAY/E;AA0BD,eAAO,MAAM,iBAAiB,EAAE,IAA8B,CAAC"}

package/dist/tools/list_calendars.js

@@ -0,0 +1,60 @@
+/**
+ * Tool: m365-graph:list_calendars
+ *
+ * List the user's calendars (primary calendar + any group / shared
+ * calendars they have access to). Wraps Graph `/me/calendars`.
+ *
+ * Required Graph scope: `Calendars.Read` (delegated). Read-only.
+ *
+ * Output: JSON list of calendars with id, name, color, owner,
+ * canEdit, canShare, isDefaultCalendar.
+ */
+import { validateOptionalInteger } from "../types/validators.js";
+const definition = {
+    name: "m365-graph:list_calendars",
+    description: "List the user's calendars: their primary calendar plus any group or shared calendars they have access to. Read-only. Use the returned id with list_events / search_events / get_event to scope to a specific calendar.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 100,
+                description: "Maximum number of calendars to return (default 50).",
+            },
+        },
+        required: [],
+    },
+};
+export function summarizeCalendar(cal) {
+    const owner = cal.owner;
+    return {
+        id: String(cal.id ?? ""),
+        name: String(cal.name ?? ""),
+        color: String(cal.color ?? "auto"),
+        owner_name: owner?.name ?? null,
+        owner_email: owner?.address ?? null,
+        is_default: Boolean(cal.isDefaultCalendar),
+        can_edit: Boolean(cal.canEdit),
+        can_share: Boolean(cal.canShare),
+    };
+}
+const handler = async (graph, args) => {
+    const limit = validateOptionalInteger(args.limit, "limit", {
+        min: 1,
+        max: 100,
+        default: 50,
+    });
+    const response = await graph.api("/me/calendars").top(limit).get();
+    const items = Array.isArray(response?.value) ? response.value : [];
+    const calendars = items.map((c) => summarizeCalendar(c));
+    const result = {
+        count: calendars.length,
+        calendars,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+};
+export const listCalendarsTool = { definition, handler };
+//# sourceMappingURL=list_calendars.js.map

package/dist/tools/list_calendars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_calendars.js","sourceRoot":"","sources":["../../src/tools/list_calendars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,UAAU,GAAmB;IACjC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,wNAAwN;IAC1N,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAaF,MAAM,UAAU,iBAAiB,CAAC,GAA4B;IAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,KAA4C,CAAC;IAC/D,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC;QAClC,UAAU,EAAG,KAAK,EAAE,IAA2B,IAAI,IAAI;QACvD,WAAW,EAAG,KAAK,EAAE,OAA8B,IAAI,IAAI;QAC3D,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC1C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAC9B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAgB,KAAK,EAChC,KAAa,EACb,IAA6B,EACN,EAAE;IACzB,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE;QACzD,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,GAAG;QACR,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,SAAS;KACV,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC"}

package/dist/tools/list_drives.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tool: m365-graph:list_drives
+ *
+ * Returns the drives the authenticated user has access to:
+ *   - Their primary OneDrive (`/me/drive`)
+ *   - Other drives accessible to them (`/me/drives`), which includes
+ *     SharePoint document libraries the user is a member of.
+ *
+ * Required Graph scope: `Files.Read` (delegated). No write side-effects.
+ *
+ * This is the simplest read-only tool, used to validate the auth +
+ * Graph plumbing end-to-end. Subsequent tools (search, list items,
+ * download, etc.) follow the same pattern: typed input, typed output,
+ * single Graph URL surface, no caller-supplied paths.
+ */
+import type { Tool } from "../types/tool.js";
+interface DriveSummary {
+    id: string;
+    driveType: string;
+    name: string;
+    webUrl: string;
+    owner: string | null;
+}
+export declare function summarizeDrive(drive: Record<string, unknown>): DriveSummary;
+export declare const listDrivesTool: Tool;
+export {};
+//# sourceMappingURL=list_drives.d.ts.map

package/dist/tools/list_drives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_drives.d.ts","sourceRoot":"","sources":["../../src/tools/list_drives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAaxF,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAe3E;AAsBD,eAAO,MAAM,cAAc,EAAE,IAA8B,CAAC"}

package/dist/tools/list_drives.js

@@ -0,0 +1,58 @@
+/**
+ * Tool: m365-graph:list_drives
+ *
+ * Returns the drives the authenticated user has access to:
+ *   - Their primary OneDrive (`/me/drive`)
+ *   - Other drives accessible to them (`/me/drives`), which includes
+ *     SharePoint document libraries the user is a member of.
+ *
+ * Required Graph scope: `Files.Read` (delegated). No write side-effects.
+ *
+ * This is the simplest read-only tool, used to validate the auth +
+ * Graph plumbing end-to-end. Subsequent tools (search, list items,
+ * download, etc.) follow the same pattern: typed input, typed output,
+ * single Graph URL surface, no caller-supplied paths.
+ */
+const definition = {
+    name: "m365-graph:list_drives",
+    description: "List the drives the authenticated user has access to. Returns the user's primary OneDrive plus any shared SharePoint document libraries they're a member of. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+export function summarizeDrive(drive) {
+    const owner = drive.owner;
+    const ownerUser = owner?.user;
+    const ownerGroup = owner?.group;
+    const ownerName = ownerUser?.displayName ??
+        ownerGroup?.displayName ??
+        null;
+    return {
+        id: String(drive.id ?? ""),
+        driveType: String(drive.driveType ?? ""),
+        name: String(drive.name ?? ""),
+        webUrl: String(drive.webUrl ?? ""),
+        owner: ownerName,
+    };
+}
+const handler = async (graph) => {
+    const primary = await graph.api("/me/drive").get();
+    const all = await graph.api("/me/drives").get();
+    const driveList = Array.isArray(all?.value) ? all.value : [];
+    const result = {
+        primary: summarizeDrive(primary),
+        accessible: driveList.map((d) => summarizeDrive(d)),
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const listDrivesTool = { definition, handler };
+//# sourceMappingURL=list_drives.js.map

package/dist/tools/list_drives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_drives.js","sourceRoot":"","sources":["../../src/tools/list_drives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,UAAU,GAAmB;IACjC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,yKAAyK;IAC3K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAUF,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,KAA4C,CAAC;IACjE,MAAM,SAAS,GAAG,KAAK,EAAE,IAA2C,CAAC;IACrE,MAAM,UAAU,GAAG,KAAK,EAAE,KAA4C,CAAC;IACvE,MAAM,SAAS,GACZ,SAAS,EAAE,WAAkC;QAC7C,UAAU,EAAE,WAAkC;QAC/C,IAAI,CAAC;IACP,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAClC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAgB,KAAK,EAAE,KAAa,EAAyB,EAAE;IAC1E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAChC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;KAC7E,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC"}

package/dist/tools/list_events.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Tool: m365-graph:list_events
+ *
+ * List events in a date window. Uses Graph `/me/calendarView`
+ * (or `/me/calendars/{id}/calendarView` for a specific calendar)
+ * which **expands recurrences** — each occurrence appears as its own
+ * event, which is what humans + agents almost always want when asked
+ * "what's on my calendar tomorrow?". Compare to `/me/events` which
+ * returns recurrence series masters.
+ *
+ * Required Graph scope: `Calendars.Read` (delegated). Read-only.
+ *
+ * Input:
+ *   start         (ISO date/datetime, required)
+ *   end           (ISO date/datetime, required)
+ *   calendar_id   (string, optional)
+ *   limit         (integer 1..200, default 100)
+ *
+ * Output: JSON list of events with id, subject, start, end, organizer,
+ * attendees, location, body_preview, is_all_day, web_url.
+ */
+import type { Tool } from "../types/tool.js";
+interface AttendeeSummary {
+    name: string;
+    email: string;
+    type: string;
+    response: string;
+}
+interface EventSummary {
+    id: string;
+    subject: string;
+    body_preview: string;
+    start: {
+        datetime: string;
+        timezone: string;
+    };
+    end: {
+        datetime: string;
+        timezone: string;
+    };
+    is_all_day: boolean;
+    location: string | null;
+    organizer_name: string | null;
+    organizer_email: string | null;
+    attendees: AttendeeSummary[];
+    webLink: string;
+}
+export declare function summarizeEvent(event: Record<string, unknown>): EventSummary;
+export declare const listEventsTool: Tool;
+export {};
+//# sourceMappingURL=list_events.d.ts.map

package/dist/tools/list_events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_events.d.ts","sourceRoot":"","sources":["../../src/tools/list_events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAkCxF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CA0B3E;AAyCD,eAAO,MAAM,cAAc,EAAE,IAA8B,CAAC"}

package/dist/tools/list_events.js

@@ -0,0 +1,119 @@
+/**
+ * Tool: m365-graph:list_events
+ *
+ * List events in a date window. Uses Graph `/me/calendarView`
+ * (or `/me/calendars/{id}/calendarView` for a specific calendar)
+ * which **expands recurrences** — each occurrence appears as its own
+ * event, which is what humans + agents almost always want when asked
+ * "what's on my calendar tomorrow?". Compare to `/me/events` which
+ * returns recurrence series masters.
+ *
+ * Required Graph scope: `Calendars.Read` (delegated). Read-only.
+ *
+ * Input:
+ *   start         (ISO date/datetime, required)
+ *   end           (ISO date/datetime, required)
+ *   calendar_id   (string, optional)
+ *   limit         (integer 1..200, default 100)
+ *
+ * Output: JSON list of events with id, subject, start, end, organizer,
+ * attendees, location, body_preview, is_all_day, web_url.
+ */
+import { validateOptionalInteger, validateOptionalString, validateRequiredISODate, } from "../types/validators.js";
+const definition = {
+    name: "m365-graph:list_events",
+    description: "List events in a date window from the user's primary calendar (or a specified calendar_id). Recurrences are expanded — each occurrence is one event in the response. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start: {
+                type: "string",
+                description: "Window start, ISO 8601 (e.g. '2026-05-04' or '2026-05-04T00:00:00Z').",
+            },
+            end: {
+                type: "string",
+                description: "Window end, ISO 8601. Exclusive upper bound is recommended (e.g. midnight of the day after the last day you want).",
+            },
+            calendar_id: {
+                type: "string",
+                description: "Optional calendar id from list_calendars. Defaults to /me's primary calendar.",
+            },
+            limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 200,
+                description: "Maximum events to return (default 100).",
+            },
+        },
+        required: ["start", "end"],
+    },
+};
+function summarizeAttendee(a) {
+    const email = a.emailAddress;
+    const status = a.status;
+    return {
+        name: email?.name ?? "",
+        email: email?.address ?? "",
+        type: String(a.type ?? "required"),
+        response: String(status?.response ?? "none"),
+    };
+}
+export function summarizeEvent(event) {
+    const start = event.start;
+    const end = event.end;
+    const location = event.location;
+    const organizer = event.organizer;
+    const orgEmail = organizer?.emailAddress;
+    const attendees = Array.isArray(event.attendees) ? event.attendees : [];
+    return {
+        id: String(event.id ?? ""),
+        subject: String(event.subject ?? ""),
+        body_preview: String(event.bodyPreview ?? ""),
+        start: {
+            datetime: String(start?.dateTime ?? ""),
+            timezone: String(start?.timeZone ?? ""),
+        },
+        end: {
+            datetime: String(end?.dateTime ?? ""),
+            timezone: String(end?.timeZone ?? ""),
+        },
+        is_all_day: Boolean(event.isAllDay),
+        location: location?.displayName || null,
+        organizer_name: orgEmail?.name ?? null,
+        organizer_email: orgEmail?.address ?? null,
+        attendees: attendees.map((a) => summarizeAttendee(a)),
+        webLink: String(event.webLink ?? ""),
+    };
+}
+const handler = async (graph, args) => {
+    const start = validateRequiredISODate(args.start, "start");
+    const end = validateRequiredISODate(args.end, "end");
+    const calendarId = validateOptionalString(args.calendar_id, "calendar_id");
+    const limit = validateOptionalInteger(args.limit, "limit", {
+        min: 1,
+        max: 200,
+        default: 100,
+    });
+    const apiBase = calendarId
+        ? `/me/calendars/${encodeURIComponent(calendarId)}/calendarView`
+        : "/me/calendarView";
+    const response = await graph
+        .api(apiBase)
+        .query({ startDateTime: start, endDateTime: end })
+        .top(limit)
+        .orderby("start/dateTime")
+        .get();
+    const items = Array.isArray(response?.value) ? response.value : [];
+    const events = items.map((e) => summarizeEvent(e));
+    const result = {
+        calendar_id: calendarId ?? null,
+        window: { start, end },
+        count: events.length,
+        events,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+};
+export const listEventsTool = { definition, handler };
+//# sourceMappingURL=list_events.js.map

package/dist/tools/list_events.js.map

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

package/dist/tools/list_items.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool: m365-graph:list_items
+ *
+ * List the children of a folder (root or specified item) in a drive.
+ * Wraps Graph `/drives/{id}/items/{item-id}/children` (or
+ * `/me/drive/root/children` when no item_id is provided).
+ *
+ * Required Graph scope: `Files.Read` (delegated). Read-only.
+ *
+ * Input:
+ *   drive_id  (string, optional) — drive to list; default = /me/drive
+ *   item_id   (string, optional) — folder ID; default = drive root
+ *   limit     (integer, 1..100)  — max items; default 50
+ *
+ * Output: JSON list of items with name, type (file|folder), size,
+ * lastModified, webUrl.
+ */
+import type { Tool } from "../types/tool.js";
+interface DriveItemSummary {
+    id: string;
+    name: string;
+    type: "file" | "folder";
+    size: number;
+    child_count: number | null;
+    lastModified: string;
+    webUrl: string;
+}
+export declare function summarizeDriveItem(item: Record<string, unknown>): DriveItemSummary;
+export declare const listItemsTool: Tool;
+export {};
+//# sourceMappingURL=list_items.d.ts.map

package/dist/tools/list_items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_items.d.ts","sourceRoot":"","sources":["../../src/tools/list_items.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AA6BxF,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAWlF;AAmCD,eAAO,MAAM,aAAa,EAAE,IAA8B,CAAC"}

package/dist/tools/list_items.js

@@ -0,0 +1,81 @@
+/**
+ * Tool: m365-graph:list_items
+ *
+ * List the children of a folder (root or specified item) in a drive.
+ * Wraps Graph `/drives/{id}/items/{item-id}/children` (or
+ * `/me/drive/root/children` when no item_id is provided).
+ *
+ * Required Graph scope: `Files.Read` (delegated). Read-only.
+ *
+ * Input:
+ *   drive_id  (string, optional) — drive to list; default = /me/drive
+ *   item_id   (string, optional) — folder ID; default = drive root
+ *   limit     (integer, 1..100)  — max items; default 50
+ *
+ * Output: JSON list of items with name, type (file|folder), size,
+ * lastModified, webUrl.
+ */
+import { validateOptionalInteger, validateOptionalString, } from "../types/validators.js";
+const definition = {
+    name: "m365-graph:list_items",
+    description: "List the immediate children (files + folders) of a folder in a drive. Defaults to the root of the user's primary OneDrive; pass drive_id and/or item_id to navigate elsewhere. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            drive_id: {
+                type: "string",
+                description: "Optional drive ID. Defaults to the user's primary OneDrive.",
+            },
+            item_id: {
+                type: "string",
+                description: "Optional folder item ID. Defaults to the drive root. Pass an item ID returned by a previous list_items / search_files call to navigate into subfolders.",
+            },
+            limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 100,
+                description: "Maximum number of children to return (default 50).",
+            },
+        },
+        required: [],
+    },
+};
+export function summarizeDriveItem(item) {
+    const folder = item.folder;
+    return {
+        id: String(item.id ?? ""),
+        name: String(item.name ?? ""),
+        type: folder !== undefined ? "folder" : "file",
+        size: Number(item.size ?? 0),
+        child_count: folder !== undefined ? Number(folder.childCount ?? 0) : null,
+        lastModified: String(item.lastModifiedDateTime ?? ""),
+        webUrl: String(item.webUrl ?? ""),
+    };
+}
+const handler = async (graph, args) => {
+    const driveId = validateOptionalString(args.drive_id, "drive_id");
+    const itemId = validateOptionalString(args.item_id, "item_id");
+    const limit = validateOptionalInteger(args.limit, "limit", {
+        min: 1,
+        max: 100,
+        default: 50,
+    });
+    const driveRoot = driveId ? `/drives/${encodeURIComponent(driveId)}` : "/me/drive";
+    const itemPath = itemId
+        ? `${driveRoot}/items/${encodeURIComponent(itemId)}/children`
+        : `${driveRoot}/root/children`;
+    const response = await graph.api(itemPath).top(limit).get();
+    const items = Array.isArray(response?.value) ? response.value : [];
+    const summaries = items.map((i) => summarizeDriveItem(i));
+    const result = {
+        drive_id: driveId ?? null,
+        item_id: itemId ?? null,
+        count: summaries.length,
+        items: summaries,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+};
+export const listItemsTool = { definition, handler };
+//# sourceMappingURL=list_items.js.map

package/dist/tools/list_items.js.map

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