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. When the user organizes it and it has attendees (a cancellation would be emailed), the first call deletes nothing and previews the event: subject, date, attendees, and whether the id is a whole recurring series; call again with confirm=true after the user approves. Any other event is deleted on the first call (it goes to Deleted Items). 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": "true after the user approved deleting a meeting they organize with attendees (it emails a cancellation).",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    },
    "remember": {
      "description": "With confirm: true, also stop asking for this kind of action from now on. Only when the person said so (\"don't ask again\"). The person can revoke it in LMCP or with set_always_allowed.",
      "type": "boolean"
    }
  },
  "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"
}

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. The event is deleted in Microsoft 365 through Microsoft Graph, which moves it to Deleted Items (restore it from there in Outlook); an ID of a recurring series deletes every occurrence. When the user is the organizer of a meeting with attendees, Microsoft 365 sends them a cancellation: only then (or when the event cannot be read) the call without confirm=true returns a preview; any other event is deleted on the first call. 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 delete a meeting you organize that has attendees (they get a cancellation). Other events do not need it.",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    },
    "remember": {
      "description": "With confirm=true, and only after the person said so: do this kind of action without asking from now on («don't ask me again»). The preview names the family.",
      "type": "boolean"
    }
  },
  "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"
}