List tasks from Taskwarrior with optional filtering.

Use this tool to view tasks, search for specific tasks, or get an overview
of pending work. Supports Taskwarrior filter expressions for powerful querying.

Args:
    params: ListTasksInput containing filter, status, limit, and response_format

Returns:
    Formatted list of tasks (markdown or JSON based on response_format)

Examples:
    - List all pending tasks: params with status="pending"
    - List tasks for a project: params with filter="project:work"
    - List urgent tasks: params with filter="+urgent"
    - List tasks due today: params with filter="due:today"
    - List completed tasks: params with status="completed"

Create a new task in Taskwarrior.

Use this tool to add new tasks with optional project, priority, due date, and tags.

Args:
    params: AddTaskInput containing description and optional attributes

Returns:
    Confirmation message with the created task ID

Examples:
    - Simple task: params with description="Buy groceries"
    - Task with project: params with description="Review PR", project="work"
    - High priority task: params with description="Fix bug", priority="H"
    - Task with due date: params with description="Submit report", due="friday"
    - Task with tags: params with description="Call mom", tags=["personal", "important"]

Mark a task as completed.

Use this tool when a task has been finished and should be marked as done.

Args:
    params: CompleteTaskInput containing the task_id to complete

Returns:
    Confirmation message

Examples:
    - Complete task #5: params with task_id="5"
    - Complete by UUID: params with task_id="a1b2c3d4"

Modify an existing task's attributes.

Use this tool to update task description, project, priority, due date, or tags.

Args:
    params: ModifyTaskInput containing task_id and attributes to modify

Returns:
    Confirmation message with updated task info

Examples:
    - Change description: params with task_id="5", description="Updated task name"
    - Change project: params with task_id="5", project="personal"
    - Set priority: params with task_id="5", priority="H"
    - Add tags: params with task_id="5", add_tags=["urgent"]
    - Remove due date: params with task_id="5", due=""

Delete a task from Taskwarrior.

Use this tool to remove a task. The task is marked as deleted but can be
recovered with 'undo' if needed.

Args:
    params: DeleteTaskInput containing the task_id to delete

Returns:
    Confirmation message

Examples:
    - Delete task #5: params with task_id="5"

Get detailed information about a specific task.

Use this tool to view all attributes and annotations of a single task.

Args:
    params: GetTaskInput containing task_id and response_format

Returns:
    Detailed task information (markdown or JSON)

Examples:
    - Get task #5: params with task_id="5"
    - Get task as JSON: params with task_id="5", response_format="json"

Add an annotation (note) to a task.

Use this tool to add notes, comments, or additional context to a task.

Args:
    params: AnnotateTaskInput containing task_id and annotation text

Returns:
    Confirmation message

Examples:
    - Add note: params with task_id="5", annotation="Discussed with John, needs review"

Start working on a task.

Use this tool to indicate you're actively working on a task. This adds the
'active' state to the task.

Args:
    params: StartTaskInput containing the task_id to start

Returns:
    Confirmation message

Examples:
    - Start task #5: params with task_id="5"

Stop working on a task.

Use this tool to indicate you've paused work on a task.

Args:
    params: StopTaskInput containing the task_id to stop

Returns:
    Confirmation message

Examples:
    - Stop task #5: params with task_id="5"

List all projects in Taskwarrior.

Use this tool to see all projects and the number of tasks in each.

Args:
    params: ListProjectsInput with response_format

Returns:
    List of projects with task counts

Examples:
    - List projects: params with response_format="markdown"

List all tags used in Taskwarrior.

Use this tool to see all tags and how many tasks use each tag.

Args:
    params: ListTagsInput with response_format

Returns:
    List of tags with usage counts

Examples:
    - List tags: params with response_format="markdown"

Undo the last Taskwarrior operation.

Use this tool to revert the most recent change to tasks.

Args:
    params: UndoInput (no parameters needed)

Returns:
    Confirmation message

Examples:
    - Undo last action: params with no special values

Get a summary of task statistics.

Use this tool to get an overview of pending tasks, including counts by
project, priority, and urgency.

Returns:
    Summary statistics of tasks