Outlook Meetings Scheduler MCP Server

Instructions

Implementation Reference

• src/tools/event-create.ts:24-92 (handler)

  Executes the core logic for creating a calendar event: handles authentication, default times, Graph API call, and response formatting.

      async ({ subject, body, start, end, timeZone = "GMT Standard Time" }) => {
        const { graph, userEmail, authError } = await getGraphConfig();
  
        if (authError) {
          return {
            content: [{ type: "text", text: `🔐 Authentication Required\n\n${authError}\n\nPlease complete the authentication and try again.` }]
          };
        }
    
        // Calculate default times if not provided
        const nextDay: string = format(addBusinessDays(new Date(), 1), 'yyyy-MM-dd');
        const startTime: string = start ? start : `${nextDay}T12:00:00`;
        const endTime: string = end ? end : `${nextDay}T13:00:00`;
    
        // Create the event object
        const event: Event = {
          subject,
          body: {
            contentType: "html",
            content: `${body}<br/>Request submitted around ${format(new Date(), 'dd-MMM-yyyy HH:mm')}`
          },
          start: {
            dateTime: startTime,
            timeZone
          },
          end: {
            dateTime: endTime,
            timeZone
          }
        };
    
        // Call the Graph API to create the event
        const result = await graph.createEvent(event, userEmail);
        
        if (!result) {
          return {
            content: [
              {
                type: "text",
                text: "Failed to create calendar event. Check the logs for details.",
              },
            ],
          };
        }
    
        // Format the result for response
        const eventUrl = result.webLink || "No event URL available";
        const eventId = result.id || "No event ID available";
        const successMessage = `
  Calendar event created successfully!
  
  Subject: ${subject}
  Start: ${startTime}
  End: ${endTime}
  Time Zone: ${timeZone}
  User: ${userEmail}
  Event ID: ${eventId}
  Event URL: ${eventUrl}
                      `;
    
        return {
          content: [
            {
              type: "text",
              text: successMessage,
            },
          ],
        };
      }

• src/tools/event-create.ts:17-23 (schema)

  Zod input schema defining parameters for the create-event tool.

  {
    subject: z.string().describe("Subject of the calendar event"),
    body: z.string().describe("Content/body of the calendar event"),
    start: z.string().optional().describe("Start time in ISO format (e.g. 2025-04-20T12:00:00). Defaults to next business day at noon"),
    end: z.string().optional().describe("End time in ISO format (e.g. 2025-04-20T13:00:00). Defaults to next business day at 1PM"),
    timeZone: z.string().optional().describe("Time zone for the event. Defaults to GMT Standard Time"),
  },

• src/tools/event-create.ts:13-93 (registration)

  Registers the 'create-event' tool on the MCP server using the registerTool helper, including schema and handler.

    registerTool(
      server,
      "create-event",
      "Create a calendar event using Microsoft Graph API",
      {
        subject: z.string().describe("Subject of the calendar event"),
        body: z.string().describe("Content/body of the calendar event"),
        start: z.string().optional().describe("Start time in ISO format (e.g. 2025-04-20T12:00:00). Defaults to next business day at noon"),
        end: z.string().optional().describe("End time in ISO format (e.g. 2025-04-20T13:00:00). Defaults to next business day at 1PM"),
        timeZone: z.string().optional().describe("Time zone for the event. Defaults to GMT Standard Time"),
      },
      async ({ subject, body, start, end, timeZone = "GMT Standard Time" }) => {
        const { graph, userEmail, authError } = await getGraphConfig();
  
        if (authError) {
          return {
            content: [{ type: "text", text: `🔐 Authentication Required\n\n${authError}\n\nPlease complete the authentication and try again.` }]
          };
        }
    
        // Calculate default times if not provided
        const nextDay: string = format(addBusinessDays(new Date(), 1), 'yyyy-MM-dd');
        const startTime: string = start ? start : `${nextDay}T12:00:00`;
        const endTime: string = end ? end : `${nextDay}T13:00:00`;
    
        // Create the event object
        const event: Event = {
          subject,
          body: {
            contentType: "html",
            content: `${body}<br/>Request submitted around ${format(new Date(), 'dd-MMM-yyyy HH:mm')}`
          },
          start: {
            dateTime: startTime,
            timeZone
          },
          end: {
            dateTime: endTime,
            timeZone
          }
        };
    
        // Call the Graph API to create the event
        const result = await graph.createEvent(event, userEmail);
        
        if (!result) {
          return {
            content: [
              {
                type: "text",
                text: "Failed to create calendar event. Check the logs for details.",
              },
            ],
          };
        }
    
        // Format the result for response
        const eventUrl = result.webLink || "No event URL available";
        const eventId = result.id || "No event ID available";
        const successMessage = `
  Calendar event created successfully!
  
  Subject: ${subject}
  Start: ${startTime}
  End: ${endTime}
  Time Zone: ${timeZone}
  User: ${userEmail}
  Event ID: ${eventId}
  Event URL: ${eventUrl}
                      `;
    
        return {
          content: [
            {
              type: "text",
              text: successMessage,
            },
          ],
        };
      }
    );

• src/index.ts:33-33 (registration)

  Top-level invocation of registerEventCreateTools during server setup, which in turn registers the create-event tool.

  registerEventCreateTools(server);

• src/utils/tool-registration.ts:8-39 (helper)

  Helper utility that registers tools on the MCP server with standardized logging and error handling wrapping.

  export function registerTool(
    server: McpServer,
    name: string,
    description: string,
    params: any,
    handler: (args: any) => Promise<any>
  ): void {
    server.tool(
      name,
      description,
      params,
      async (args: any) => {
        // Common logging pattern for all tools
        logger.info(`ℹ️ Executing ${name} tool with params: ${JSON.stringify(args)}`);
  
        try {
          // Call the actual handler function
          return await handler(args);
        } catch (error) {
          logger.error(`Error in ${name}:`, error);
          return {
            content: [
              {
                type: "text",
                text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`
              }
            ]
          };
        }
      }
    );
  }