delete-todo-task-list
delete-todo-task-listDestructive
Delete a specific Microsoft To Do task list by providing its ID. Removes custom lists but cannot delete built-in lists such as Flagged emails or the default Tasks list.
Instructions
Deletes a todoTaskList object.
š” TIP: Deletes a Microsoft To Do task list. Built-in lists (Flagged emails, the default Tasks list) cannot be deleted ā the API returns an error for those. Get list ids via list-todo-task-lists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data. | |
| If-Match | No | ETag | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| todoTaskListId | Yes | Path parameter: todoTaskListId | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |