Add a new item to the shared global TODO list. Use list="backlog" for things to park and not hold in context (deferred findings, low-priority follow-ups); list="todo" (default) for near-term actionable items.

Edit an existing item's title/description/category/priority/dueDate/list by id. Only fields you pass are changed. Pass an empty string ("") for description/category/priority/dueDate to clear that field.

Mark an item as actively being worked on by you (the calling agent). Advisory, not a lock — check todo_list(inProgress: true) before starting new work to avoid duplicating another agent's active item. Call todo_release or todo_complete when you stop.

Clear the in-progress claim on an item without completing it (e.g. you're pausing this work).

List items from the shared global TODO list, formatted as a checklist.

Mark a todo as done by id.

Show the change history (create/edit/claim/release/complete) for one item, who made each change and when.

Report this todo-mcp process's data format version and start time. Use to sanity-check whether your MCP connection is running stale code (e.g. right after an update) — if todo_list output looks wrong (missing/undefined fields), check this first and reconnect if the process looks old.

Permanently remove a todo by id.