Getting started
Turn it on
This module starts inactive. Ask your agent to activate it, or flip the switch on the Todo List card on the homepage. Activation calls create_database with moduleSlug: "todo-list" and a name you choose, and unlocks the tools on this page. If it was active before and got switched off, the same call reactivates it instead of creating a duplicate.
Reference
Fields
What an entry in this module looks like.
| Field | Type | Notes |
|---|---|---|
| task | string | Required. |
| status | todo | in_progress | waiting_on | completed | |
| important | boolean | Eisenhower matrix: does this matter for a real goal? |
| urgent | boolean | Eisenhower matrix: does this need attention soon? |
| due_date | string | ISO date, e.g. 2026-08-20 |
| project | string | Freeform project label. Independent of project_id. |
| project_id | string | Exact todo_list_projects.id (from todo_list_create_project or todo_list_list_projects) to group this todo under. Leave unset to keep the todo unassigned/ungrouped. |
| notes | string | |
| tags | string[] | Freeform labels. Normalized to trimmed, lowercased text on write. |
| recurrence | none | daily | weekly | biweekly | monthly | weekdays | Defaults to none. Only takes effect if the todo has a due_date when marked completed. |
| recurrence_interval | number | Multiplier for recurrence, e.g. 2 with weekly means every 2 weeks. Defaults to 1. |
Reference
Tools
Todo List has 18 dedicated tools once active: add, list, update, and delete, plus a few built for how this module actually gets used.
todo_list_attach_phototodo_list_add_entrytodo_list_list_entriestodo_list_update_entrytodo_list_delete_entrytodo_list_list_opentodo_list_list_overduetodo_list_mark_completedtodo_list_list_by_quadranttodo_list_status_summarytodo_list_list_by_tagtodo_list_list_tagstodo_list_list_recurringtodo_list_create_projecttodo_list_list_projectstodo_list_update_projecttodo_list_delete_projecttodo_list_by_project
Full tool reference, with parameters and return valuesTry it
Example prompts
Talk to your agent like this once Todo List is active. It picks the right tool and fields on its own.
Add 'renew passport' to my todo list, due next Friday, important and urgent.
What's still open on my todo list?
What's overdue?
Mark 'call the plumber' as completed.
Add 'take out trash' as a weekly recurring task, tagged chores, due this Sunday.
What tags am I using on my todo list?
Create a project called 'Kitchen Remodel' on my todo list.
Show me my todos grouped by project.
Show me my Eisenhower matrix for my todo list.
What's my todo status summary?
Mark 'follow up with contractor' as waiting_on.