Skip to content
All tools

m365_delete_event

Microsoft 365 · macOS · Windows

Effect: delete (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Deletes an event from the connected Microsoft 365 / Outlook calendar by its id (from m365_list_events). If the user organizes the meeting and it has attendees, Microsoft 365 sends them a cancellation. For a recurring event the id from m365_list_events is the whole series: deleting it removes every occurrence. Requires confirm=true; without it nothing is deleted and the answer previews the event: subject, date, attendees, and whether the id is a whole recurring series. Tell the user which event it is before confirming — the id alone does not say. For the Mac's Calendar app use delete_calendar_event instead.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to confirm deletion (required)",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    }
  },
  "required": [
    "id",
    "confirm"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "id": "demo-item-001"
}

Windows

Purpose

Deletes an event from the calendar of the connected Microsoft 365 account by its ID: the `ID:` line that m365_list_events or m365_create_event returns. Without confirm=true nothing is deleted and the answer previews the event: subject, date, attendees, and whether the ID is a whole recurring series (every occurrence goes) or one occurrence; tell the user which event it is before confirming. With confirm=true the event is deleted in Microsoft 365 through Microsoft Graph; when the user is the organizer of a meeting, Microsoft 365 sends the attendees a cancellation. This server has no tool to restore a deleted event. An ID that no longer exists returns 'item not found'.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to confirm deletion (required)",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "id": "demo-item-001"
}