@jbctechsolutions/mcp-office365 2.5.1

package/dist/tools/planner.js

@@ -0,0 +1,368 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Microsoft Planner Plans and Buckets MCP tools.
+ *
+ * Provides tools for managing Planner plans and buckets with ETag caching
+ * for optimistic concurrency control, and two-phase approval for destructive
+ * delete operations.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListPlansInput = z.strictObject({});
+export const GetPlanInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+});
+export const CreatePlanInput = z.strictObject({
+    title: z.string().min(1).describe('Plan title'),
+    group_id: z.string().min(1).describe('M365 group ID that owns the plan'),
+});
+export const UpdatePlanInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+    title: z.string().min(1).optional().describe('New plan title'),
+});
+export const ListBucketsInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+});
+export const CreateBucketInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+    name: z.string().min(1).describe('Bucket name'),
+});
+export const UpdateBucketInput = z.strictObject({
+    bucket_id: z.number().int().positive().describe('Bucket ID from list_buckets'),
+    name: z.string().min(1).optional().describe('New bucket name'),
+});
+export const PrepareDeleteBucketInput = z.strictObject({
+    bucket_id: z.number().int().positive().describe('Bucket ID from list_buckets'),
+});
+export const ConfirmDeleteBucketInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_delete_bucket'),
+});
+export const ListPlannerTasksInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+});
+export const GetPlannerTaskInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID from list_planner_tasks'),
+});
+export const CreatePlannerTaskInput = z.strictObject({
+    plan_id: z.number().int().positive().describe('Plan ID from list_plans'),
+    title: z.string().min(1).describe('Task title'),
+    bucket_id: z.number().int().positive().optional().describe('Bucket ID from list_buckets'),
+    assignments: z.record(z.string(), z.object({}).passthrough()).optional().describe('User assignments. Keys are user IDs, values should be { "@odata.type": "#microsoft.graph.plannerAssignment", "orderHint": " !" }'),
+    priority: z.number().int().min(0).max(10).optional().describe('Priority (0-10)'),
+    start_date: z.string().optional().describe('Start date in ISO format'),
+    due_date: z.string().optional().describe('Due date in ISO format'),
+});
+export const UpdatePlannerTaskInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID from list_planner_tasks'),
+    title: z.string().min(1).optional().describe('New task title'),
+    bucket_id: z.number().int().positive().optional().describe('New bucket ID from list_buckets'),
+    percent_complete: z.number().int().min(0).max(100).optional().describe('Percent complete (0-100)'),
+    priority: z.number().int().min(0).max(10).optional().describe('Priority (0-10)'),
+    start_date: z.string().optional().describe('Start date in ISO format'),
+    due_date: z.string().optional().describe('Due date in ISO format'),
+    assignments: z.record(z.string(), z.object({}).passthrough()).optional().describe('User assignments. Keys are user IDs, values should be { "@odata.type": "#microsoft.graph.plannerAssignment", "orderHint": " !" }'),
+});
+export const PrepareDeletePlannerTaskInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID from list_planner_tasks'),
+});
+export const ConfirmDeletePlannerTaskInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_delete_planner_task'),
+});
+export const GetPlannerTaskDetailsInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Planner task ID'),
+});
+export const UpdatePlannerTaskDetailsInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Planner task ID'),
+    description: z.string().optional().describe('Task description/notes'),
+    checklist: z.record(z.string(), z.object({}).passthrough()).optional().describe('Checklist items. Keys are GUIDs, values have title (string) and isChecked (boolean)'),
+    references: z.record(z.string(), z.object({}).passthrough()).optional().describe('Reference links. Keys are encoded URLs, values have alias (string) and type (string)'),
+});
+// =============================================================================
+// Planner Tools
+// =============================================================================
+/**
+ * Microsoft Planner tools with ETag caching and two-phase delete approval.
+ */
+export class PlannerTools {
+    repo;
+    tokenManager;
+    constructor(repo, tokenManager) {
+        this.repo = repo;
+        this.tokenManager = tokenManager;
+    }
+    async listPlans() {
+        const plans = await this.repo.listPlansAsync();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ plans }, null, 2),
+                }],
+        };
+    }
+    async getPlan(params) {
+        const plan = await this.repo.getPlanAsync(params.plan_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ plan }, null, 2),
+                }],
+        };
+    }
+    async createPlan(params) {
+        const planId = await this.repo.createPlanAsync(params.title, params.group_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, plan_id: planId, message: 'Plan created' }, null, 2),
+                }],
+        };
+    }
+    async updatePlan(params) {
+        const updates = {};
+        if (params.title != null)
+            updates.title = params.title;
+        await this.repo.updatePlanAsync(params.plan_id, updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Plan updated' }, null, 2),
+                }],
+        };
+    }
+    async listBuckets(params) {
+        const buckets = await this.repo.listBucketsAsync(params.plan_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ buckets }, null, 2),
+                }],
+        };
+    }
+    async createBucket(params) {
+        const bucketId = await this.repo.createBucketAsync(params.plan_id, params.name);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, bucket_id: bucketId, message: 'Bucket created' }, null, 2),
+                }],
+        };
+    }
+    async updateBucket(params) {
+        const updates = {};
+        if (params.name != null)
+            updates.name = params.name;
+        await this.repo.updateBucketAsync(params.bucket_id, updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Bucket updated' }, null, 2),
+                }],
+        };
+    }
+    prepareDeleteBucket(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'delete_bucket',
+            targetType: 'bucket',
+            targetId: params.bucket_id,
+            targetHash: String(params.bucket_id),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        bucket_id: params.bucket_id,
+                        action: `To confirm deleting bucket ${params.bucket_id}, call confirm_delete_bucket with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmDeleteBucket(params) {
+        const token = this.tokenManager.lookupToken(params.approval_token);
+        if (token == null) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'Token not found or already used',
+                        }, null, 2),
+                    }],
+            };
+        }
+        const result = this.tokenManager.consumeToken(params.approval_token, 'delete_bucket', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_delete_bucket again.',
+                OPERATION_MISMATCH: 'Token was not generated for delete_bucket',
+                TARGET_MISMATCH: 'Token was generated for a different bucket',
+                ALREADY_CONSUMED: 'Token has already been used',
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: errorMessages[result.error ?? ''] ?? 'Invalid token',
+                        }, null, 2),
+                    }],
+            };
+        }
+        await this.repo.deleteBucketAsync(result.token.targetId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Bucket deleted' }, null, 2),
+                }],
+        };
+    }
+    // ===========================================================================
+    // Planner Tasks
+    // ===========================================================================
+    async listPlannerTasks(params) {
+        const tasks = await this.repo.listPlannerTasksAsync(params.plan_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ tasks }, null, 2),
+                }],
+        };
+    }
+    async getPlannerTask(params) {
+        const task = await this.repo.getPlannerTaskAsync(params.task_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ task }, null, 2),
+                }],
+        };
+    }
+    async createPlannerTask(params) {
+        const taskId = await this.repo.createPlannerTaskAsync(params.plan_id, params.title, params.bucket_id, params.assignments, params.priority, params.start_date, params.due_date);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, task_id: taskId, message: 'Planner task created' }, null, 2),
+                }],
+        };
+    }
+    async updatePlannerTask(params) {
+        const updates = {};
+        if (params.title != null)
+            updates.title = params.title;
+        if (params.bucket_id != null)
+            updates.bucketId = params.bucket_id;
+        if (params.percent_complete != null)
+            updates.percentComplete = params.percent_complete;
+        if (params.priority != null)
+            updates.priority = params.priority;
+        if (params.start_date != null)
+            updates.startDate = params.start_date;
+        if (params.due_date != null)
+            updates.dueDate = params.due_date;
+        if (params.assignments != null)
+            updates.assignments = params.assignments;
+        await this.repo.updatePlannerTaskAsync(params.task_id, updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Planner task updated' }, null, 2),
+                }],
+        };
+    }
+    prepareDeletePlannerTask(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'delete_planner_task',
+            targetType: 'planner_task',
+            targetId: params.task_id,
+            targetHash: String(params.task_id),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        task_id: params.task_id,
+                        action: `To confirm deleting planner task ${params.task_id}, call confirm_delete_planner_task with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmDeletePlannerTask(params) {
+        const token = this.tokenManager.lookupToken(params.approval_token);
+        if (token == null) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'Token not found or already used',
+                        }, null, 2),
+                    }],
+            };
+        }
+        const result = this.tokenManager.consumeToken(params.approval_token, 'delete_planner_task', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_delete_planner_task again.',
+                OPERATION_MISMATCH: 'Token was not generated for delete_planner_task',
+                TARGET_MISMATCH: 'Token was generated for a different task',
+                ALREADY_CONSUMED: 'Token has already been used',
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: errorMessages[result.error ?? ''] ?? 'Invalid token',
+                        }, null, 2),
+                    }],
+            };
+        }
+        await this.repo.deletePlannerTaskAsync(result.token.targetId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Planner task deleted' }, null, 2),
+                }],
+        };
+    }
+    // ===========================================================================
+    // Planner Task Details
+    // ===========================================================================
+    async getPlannerTaskDetails(params) {
+        const details = await this.repo.getPlannerTaskDetailsAsync(params.task_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ details }, null, 2),
+                }],
+        };
+    }
+    async updatePlannerTaskDetails(params) {
+        const updates = {};
+        if (params.description != null)
+            updates.description = params.description;
+        if (params.checklist != null)
+            updates.checklist = params.checklist;
+        if (params.references != null)
+            updates.references = params.references;
+        await this.repo.updatePlannerTaskDetailsAsync(params.task_id, updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Planner task details updated' }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/tools/planner.js.map

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

package/dist/tools/scheduling.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Calendar scheduling MCP tools.
+ *
+ * Provides tools for checking free/busy availability and
+ * finding optimal meeting times for groups of attendees.
+ */
+import { z } from 'zod';
+export interface ISchedulingRepository {
+    getScheduleAsync(params: {
+        emailAddresses: string[];
+        startTime: string;
+        endTime: string;
+        availabilityViewInterval?: number;
+    }): Promise<unknown[]>;
+    findMeetingTimesAsync(params: {
+        attendees: string[];
+        durationMinutes: number;
+        startTime?: string;
+        endTime?: string;
+        maxCandidates?: number;
+    }): Promise<unknown>;
+}
+export declare const CheckAvailabilityInput: z.ZodObject<{
+    email_addresses: z.ZodArray<z.ZodString>;
+    start_time: z.ZodString;
+    end_time: z.ZodString;
+    availability_view_interval: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const FindMeetingTimesInput: z.ZodObject<{
+    attendees: z.ZodArray<z.ZodString>;
+    duration_minutes: z.ZodNumber;
+    start_time: z.ZodOptional<z.ZodString>;
+    end_time: z.ZodOptional<z.ZodString>;
+    max_candidates: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare class SchedulingTools {
+    private readonly repository;
+    constructor(repository: ISchedulingRepository);
+    checkAvailability(params: z.input<typeof CheckAvailabilityInput>): Promise<{
+        schedules: unknown[];
+    }>;
+    findMeetingTimes(params: z.input<typeof FindMeetingTimesInput>): Promise<unknown>;
+}
+export declare function createSchedulingTools(repository: ISchedulingRepository): SchedulingTools;
+//# sourceMappingURL=scheduling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/tools/scheduling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,MAAM,EAAE;QACvB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvB,qBAAqB,CAAC,MAAM,EAAE;QAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAYD,eAAO,MAAM,sBAAsB;;;;;kBAuB/B,CAAC;AAEL,eAAO,MAAM,qBAAqB;;;;;;kBAmC9B,CAAC;AAML,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,qBAAqB;IAExD,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAWpG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAUxF;AAMD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CAExF"}

package/dist/tools/scheduling.js

@@ -0,0 +1,115 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Calendar scheduling MCP tools.
+ *
+ * Provides tools for checking free/busy availability and
+ * finding optimal meeting times for groups of attendees.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Zod Schemas
+// =============================================================================
+const iso8601DateTimeString = z
+    .string()
+    .refine((value) => !Number.isNaN(Date.parse(value)), {
+    message: 'must be a valid ISO 8601 date-time string',
+});
+export const CheckAvailabilityInput = z
+    .strictObject({
+    email_addresses: z.array(z.string().email()).min(1).describe('Email addresses to check availability for'),
+    start_time: iso8601DateTimeString.describe('Start of time window (ISO 8601)'),
+    end_time: iso8601DateTimeString.describe('End of time window (ISO 8601)'),
+    availability_view_interval: z
+        .number()
+        .int()
+        .min(5)
+        .max(1440)
+        .default(30)
+        .describe('Time slot interval in minutes (default: 30)'),
+})
+    .superRefine((data, ctx) => {
+    const start = Date.parse(data.start_time);
+    const end = Date.parse(data.end_time);
+    if (!Number.isNaN(start) && !Number.isNaN(end) && start >= end) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['end_time'],
+            message: 'end_time must be after start_time',
+        });
+    }
+});
+export const FindMeetingTimesInput = z
+    .strictObject({
+    attendees: z.array(z.string().email()).min(1).describe('Attendee email addresses'),
+    duration_minutes: z.number().int().min(1).describe('Meeting duration in minutes'),
+    start_time: iso8601DateTimeString.optional().describe('Start of search window (ISO 8601)'),
+    end_time: iso8601DateTimeString.optional().describe('End of search window (ISO 8601)'),
+    max_candidates: z
+        .number()
+        .int()
+        .min(1)
+        .max(25)
+        .default(5)
+        .describe('Max time suggestions to return (default: 5)'),
+})
+    .superRefine((data, ctx) => {
+    if (data.start_time != null && data.end_time != null) {
+        const start = Date.parse(data.start_time);
+        const end = Date.parse(data.end_time);
+        if (!Number.isNaN(start) && !Number.isNaN(end) && start >= end) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['end_time'],
+                message: 'end_time must be after start_time when both are provided',
+            });
+        }
+    }
+    const hasStart = data.start_time !== undefined;
+    const hasEnd = data.end_time !== undefined;
+    if (hasStart !== hasEnd) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: hasStart ? ['end_time'] : ['start_time'],
+            message: 'start_time and end_time must be provided together or omitted together',
+        });
+    }
+});
+// =============================================================================
+// Scheduling Tools Class
+// =============================================================================
+export class SchedulingTools {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    async checkAvailability(params) {
+        const parsed = CheckAvailabilityInput.parse(params);
+        const schedules = await this.repository.getScheduleAsync({
+            emailAddresses: parsed.email_addresses,
+            startTime: parsed.start_time,
+            endTime: parsed.end_time,
+            availabilityViewInterval: parsed.availability_view_interval,
+        });
+        return { schedules };
+    }
+    async findMeetingTimes(params) {
+        const parsed = FindMeetingTimesInput.parse(params);
+        return await this.repository.findMeetingTimesAsync({
+            attendees: parsed.attendees,
+            durationMinutes: parsed.duration_minutes,
+            ...(parsed.start_time !== undefined && { startTime: parsed.start_time }),
+            ...(parsed.end_time !== undefined && { endTime: parsed.end_time }),
+            maxCandidates: parsed.max_candidates,
+        });
+    }
+}
+// =============================================================================
+// Factory
+// =============================================================================
+export function createSchedulingTools(repository) {
+    return new SchedulingTools(repository);
+}
+//# sourceMappingURL=scheduling.js.map

package/dist/tools/scheduling.js.map

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