delete_todo
Permanently delete entire TODO lists and associated tasks from the Knowledge MCP Server. Use this tool to clean up completed, obsolete, or duplicate TODOs, ensuring project organization. Confirms permanent removal upon execution.
Instructions
Delete an entire TODO list and all its tasks permanently.
When to use this tool:
- TODO is completely finished
- TODO is obsolete or cancelled
- Cleaning up old TODOs
- Consolidating duplicate TODOs
- User explicitly requests deletion
Key features:
- Removes entire TODO list
- Deletes all associated tasks
- Permanent removal
- Frees up TODO number
You should:
- Verify all tasks are complete or obsolete
- Confirm TODO number is correct
- Understand deletion is permanent
- Consider if TODO has value for history
- Check no active work depends on it
DO NOT use when:
- TODO has incomplete relevant tasks
- Might need TODO for reference
- Unsure about deletion impact
Returns: {success: bool, message: str, error?: str}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | The project identifier | |
| todo_number | Yes | The TODO list number to delete |