delete_event
Remove calendar events from Outlook by specifying the event ID. This tool helps manage your schedule by deleting unwanted or outdated appointments directly through the Outlook MCP Server.
Instructions
Delete a calendar event by its ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eventId | Yes | Event ID to delete | |
| calendar | No | Calendar name (optional) |
Implementation Reference
- src/outlook-manager.ts:822-870 (handler)Core handler function that executes PowerShell script to delete the Outlook calendar event using the provided eventId via Outlook COM interop.async deleteEvent(options: { eventId: string; calendar?: string; }): Promise<{ success: boolean; message: string }> { try { 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, '""')}" } # Delete the appointment $appointment.Delete() 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 delete event'); } return { success: true, message: 'Event deleted successfully' }; } catch (error) { throw new Error(`Failed to delete event: ${error instanceof Error ? error.message : String(error)}`); } }
- src/index.ts:378-395 (registration)Tool registration in the MCP server's tools array, including name, description, and input schema for delete_event.{ name: "delete_event", description: "Delete a calendar event by its ID", inputSchema: { type: "object", properties: { eventId: { type: "string", description: "Event ID to delete" }, calendar: { type: "string", description: "Calendar name (optional)" } }, required: ["eventId"] } },
- src/index.ts:381-394 (schema)Input schema definition specifying eventId as required string and optional calendar string.inputSchema: { type: "object", properties: { eventId: { type: "string", description: "Event ID to delete" }, calendar: { type: "string", description: "Calendar name (optional)" } }, required: ["eventId"] }
- src/index.ts:764-777 (handler)MCP request handler case that extracts arguments, calls the core deleteEvent handler, and formats the response.case 'delete_event': { const result = await outlookManager.deleteEvent({ eventId: (args as any)?.eventId, calendar: (args as any)?.calendar }); return { content: [ { type: 'text', text: `${result.success ? '✅' : '❌'} **Event Deletion**\n\n${result.message}`, }, ], }; }