v1.0.0 — First stable release

First stable release

This is an enhanced fork of ispyridis/todolist-mcp with major improvements:

New tools (16 total)

• complete_task — mark a task as done in one call
• get_task_stats — aggregated counts by status, priority, category
• backup_tdl / restore_tdl — safety net before big changes
• delete_task — remove tasks and their children
• add_comment — append to description (never replaces)

New features

• start_date and tags fields in add_task / update_task
• status filter in search_tasks
• mcp_server.ini with active = yes/no toggle for local dev

Architecture

• Refactored to src/ modular structure (models, manager, tools)
• XPath injection protection (_escape_xpath_value)
• Path traversal protection (_validate_safe_path)
• Environment variable TODOLIST_FILE support

Quality

• 192 tests — 80 unit + 112 MCP contract tests
• mypy + ruff + pyright clean
• Diataxis documentation (tutorial, how-to, explanation, reference)

Installation

git clone https://github.com/killo3967/todolist-mcp.git
cd todolist-mcp
pip install -r requirements.txt
python main.py

Tested with ToDoList 9.2.4.