Documentation

Delete Task Tool

Permanently deletes a task that is ALREADY ARCHIVED. This is irreversible. It mirrors the app's trash → empty-trash flow: a task must first be archived (ArchiveTaskTool), then it can be purged from the archive here. Active tasks cannot be permanently deleted in one step. Requires confirm:true and owner, admin, or member role.

Permanently deletes a task that is ALREADY ARCHIVED. This is irreversible. It mirrors the app's trash → empty-trash flow: a task must first be archived (ArchiveTaskTool), then it can be purged from the archive here. Active tasks cannot be permanently deleted in one step. Requires confirm:true and owner, admin, or member role.

Safety: Destructive

Tool names, field names, and schema descriptions remain in canonical MCP English so copied calls match the server exactly.

Input schema

Field Type Required Description
task_id integer no The ID of the archived task to permanently delete.
search string no Locate the archived task by "#number" or name. task_id is preferred for a destructive action.
confirm boolean no Must be set to true to confirm permanent, irreversible deletion. Defaults to false.

Example prompt

Use delete-task-tool to help me with the relevant Taskavel task.

Example call

{
  "name": "delete-task-tool",
  "arguments": {}
}

Last reviewed Jul 26, 2026