hanzo-tools-todo¶

Task management tools for tracking progress and organizing work.

Installation¶

pip install hanzo-tools-todo

Or as part of the full toolkit:

pip install hanzo-mcp[tools-all]

Overview¶

hanzo-tools-todo provides task management:

todo - Unified task management with list, add, update, remove, clear operations

Quick Start¶

# List all todos
todo()
todo(action="list")

# Add a new todo
todo(action="add", content="Fix the authentication bug")

# Update status
todo(action="update", id="abc123", status="in_progress")

# Mark complete
todo(action="update", id="abc123", status="completed")

# Remove a todo
todo(action="remove", id="abc123")

# Clear all todos
todo(action="clear")

Actions Reference¶

list¶

List all todos, optionally filtered by status.

# List all
todo(action="list")

# Filter by status
todo(action="list", filter="pending")
todo(action="list", filter="in_progress")
todo(action="list", filter="completed")

Response:

{
  "todos": [
    {"id": "abc123", "content": "Fix bug", "status": "in_progress", "priority": "high"},
    {"id": "def456", "content": "Write tests", "status": "pending", "priority": "medium"}
  ],
  "count": 2
}

add¶

Add a new todo item.

# Simple add
todo(action="add", content="Implement feature X")

# With priority
todo(action="add", content="Critical fix", priority="high")

# With status
todo(action="add", content="Already started", status="in_progress")

Parameters: - content (required): Todo description - status: Initial status - "pending" (default), "in_progress", "completed" - priority: Priority level - "low", "medium" (default), "high"

update¶

Update an existing todo.

# Update status
todo(action="update", id="abc123", status="completed")

# Update content
todo(action="update", id="abc123", content="Updated description")

# Update priority
todo(action="update", id="abc123", priority="high")

Parameters: - id (required): Todo ID - content: New content - status: New status - priority: New priority

remove¶

Remove a todo by ID.

todo(action="remove", id="abc123")

clear¶

Clear all todos.

todo(action="clear")

Status Workflow¶

pending → in_progress → completed
    ↑_________|  (can go back if needed)

Statuses: - pending - Not yet started - in_progress - Currently being worked on - completed - Finished

Priority Levels¶

high - Urgent, do first
medium - Normal priority (default)
low - Can wait

Storage¶

Todos are stored per-session in memory. For persistent todos, use the memory tools to save to disk.

Examples¶

Project Workflow¶

# Add tasks for a feature
todo(action="add", content="Design API schema", priority="high")
todo(action="add", content="Implement endpoints", priority="high")
todo(action="add", content="Write tests", priority="medium")
todo(action="add", content="Update documentation", priority="low")

# Start working
todo(action="update", id="<design_id>", status="in_progress")

# Complete and move on
todo(action="update", id="<design_id>", status="completed")
todo(action="update", id="<implement_id>", status="in_progress")

Tracking Progress¶

# Check what's in progress
todo(action="list", filter="in_progress")

# Check what's pending
todo(action="list", filter="pending")

# Check completed
todo(action="list", filter="completed")

Best Practices¶

Use meaningful descriptions - Clear content helps tracking
Set appropriate priorities - High for blockers, medium for features
Update status promptly - Keep todos current
Clear completed items - Periodically clean up finished tasks