Outlook MCP Server

Instructions

Implementation Reference

• src/index.ts:332-377 (registration)

  Registers the update_event tool in the MCP server's tool list, including its description and input schema definition.
  { name: "update_event", description: "Update an existing calendar event", inputSchema: { type: "object", properties: { eventId: { type: "string", description: "Event ID to update" }, subject: { type: "string", description: "New event subject/title (optional)" }, startDate: { type: "string", description: "New start date in MM/DD/YYYY format (optional)" }, startTime: { type: "string", description: "New start time in HH:MM AM/PM format (optional)" }, endDate: { type: "string", description: "New end date in MM/DD/YYYY format (optional)" }, endTime: { type: "string", description: "New end time in HH:MM AM/PM format (optional)" }, location: { type: "string", description: "New event location (optional)" }, body: { type: "string", description: "New event description/body (optional)" }, calendar: { type: "string", description: "Calendar name (optional)" } }, required: ["eventId"] } },
• src/index.ts:742-762 (handler)

  MCP server dispatch handler for update_event tool calls, which extracts parameters and delegates to OutlookManager.updateEvent.
  case 'update_event': { const result = await outlookManager.updateEvent({ eventId: (args as any)?.eventId, subject: (args as any)?.subject, startDate: (args as any)?.startDate, startTime: (args as any)?.startTime, endDate: (args as any)?.endDate, endTime: (args as any)?.endTime, location: (args as any)?.location, body: (args as any)?.body, calendar: (args as any)?.calendar }); return { content: [ { type: 'text', text: `${result.success ? '✅' : '❌'} **Event Update**\n\n${result.message}`, }, ], }; }
• src/outlook-manager.ts:741-817 (handler)

  Core implementation of the update_event tool in OutlookManager class. Parses input options, constructs PowerShell script to update Outlook appointment via COM, executes it, and returns success/error status.
  async updateEvent(options: { eventId: string; subject?: string; startDate?: string; startTime?: string; endDate?: string; endTime?: string; location?: string; body?: string; calendar?: string; }): Promise<{ success: boolean; message: string }> { try { const calendarName = options.calendar || ''; let startDateTime = ''; let endDateTime = ''; if (options.startDate && options.startTime) { startDateTime = `${options.startDate} ${options.startTime}`; } if (options.endDate && options.endTime) { endDateTime = `${options.endDate} ${options.endTime}`; } else if (startDateTime) { // Default to 30 minutes after start endDateTime = 'ADD30MIN'; } const script = ` try { Add-Type -AssemblyName "Microsoft.Office.Interop.Outlook" -ErrorAction Stop $outlook = New-Object -ComObject Outlook.Application -ErrorAction Stop $namespace = $outlook.GetNamespace("MAPI") # Get appointment $appointment = $namespace.GetItemFromID("${options.eventId.replace(/"/g, '""')}") if (-not $appointment) { throw "Event not found with ID: ${options.eventId.replace(/"/g, '""')}" } # Update properties ${options.subject ? `$appointment.Subject = "${options.subject.replace(/"/g, '""')}"` : ''} ${startDateTime ? `$appointment.Start = [DateTime]"${startDateTime.replace(/"/g, '""')}"` : ''} ${endDateTime === 'ADD30MIN' ? `$appointment.End = $appointment.Start.AddMinutes(30)` : endDateTime ? `$appointment.End = [DateTime]"${endDateTime.replace(/"/g, '""')}"` : ''} ${options.location ? `$appointment.Location = "${options.location.replace(/"/g, '""')}"` : ''} ${options.body ? `$appointment.Body = "${options.body.replace(/"/g, '""')}"` : ''} $appointment.Save() Write-Output ([PSCustomObject]@{ Success = $true } | ConvertTo-Json -Compress) } catch { Write-Output ([PSCustomObject]@{ Success = $false Error = $_.Exception.Message } | ConvertTo-Json -Compress) } `; const result = await this.executePowerShell(script); const cleanResult = result.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '').trim(); const data = JSON.parse(cleanResult); if (!data.Success) { throw new Error(data.Error || 'Failed to update event'); } return { success: true, message: 'Event updated successfully' }; } catch (error) { throw new Error(`Failed to update event: ${error instanceof Error ? error.message : String(error)}`); } }