Outlook Calendar MCP

Instructions

Implementation Reference

• src/outlookTools.js:118-141 (handler)

  The handler function for the 'create_event' MCP tool. It calls the createEvent helper from scriptRunner.js, processes the result, and returns a formatted MCP response with success or error content.

    handler: async (eventDetails) => {
      try {
        const result = await createEvent(eventDetails);
        return {
          content: [
            {
              type: 'text',
              text: `Event created successfully with ID: ${result.eventId}`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: 'text',
              text: `Error creating event: ${error.message}`
            }
          ],
          isError: true
        };
      }
    }
  },

• src/outlookTools.js:72-117 (schema)

  The input schema for the 'create_event' tool, defining properties and requirements for event creation parameters.

  inputSchema: {
    type: 'object',
    properties: {
      subject: {
        type: 'string',
        description: 'Event subject/title'
      },
      startDate: {
        type: 'string',
        description: 'Start date in MM/DD/YYYY format'
      },
      startTime: {
        type: 'string',
        description: 'Start time in HH:MM AM/PM format'
      },
      endDate: {
        type: 'string',
        description: 'End date in MM/DD/YYYY format (optional, defaults to start date)'
      },
      endTime: {
        type: 'string',
        description: 'End time in HH:MM AM/PM format (optional, defaults to 30 minutes after start time)'
      },
      location: {
        type: 'string',
        description: 'Event location (optional)'
      },
      body: {
        type: 'string',
        description: 'Event description/body (optional)'
      },
      isMeeting: {
        type: 'boolean',
        description: 'Whether this is a meeting with attendees (optional, defaults to false)'
      },
      attendees: {
        type: 'string',
        description: 'Semicolon-separated list of attendee email addresses (optional)'
      },
      calendar: {
        type: 'string',
        description: 'Calendar name (optional)'
      }
    },
    required: ['subject', 'startDate', 'startTime']
  },

• src/index.js:34-35 (registration)

  Registers the Outlook tools, including 'create_event', by calling defineOutlookTools() and storing in this.tools, which is used by MCP request handlers.

  // Define the tools
  this.tools = defineOutlookTools();

• src/scriptRunner.js:84-86 (helper)

  Helper function that executes the underlying 'createEvent.vbs' VBScript file with the provided event details using the general executeScript utility.

  export async function createEvent(eventDetails) {
    return executeScript('createEvent', eventDetails);
  }