List To Do Tasks
list_todo_tasksLists Microsoft To Do tasks in a specified list and tracks changes since a prior call using a delta token, returning added, modified, or removed tasks.
Instructions
List tasks in a To Do list, or what changed in it since your last call. For changes, call once with delta: true, which returns every task and a 'Delta token: …' line; keep the token and pass it as delta_token next time to get only the tasks added, changed or removed since (removed ones as 'Removed: ()' lines), and a new token. Completing a repeating task makes Graph keep the series and split off the finished occurrence as a new, already-completed task with a new id, so an unseen completed task is a done occurrence, not new work. Your own writes come back as changes too. The Flagged Emails list (wellknownListName flaggedEmails) holds the emails flagged in Outlook; each of its tasks carries (Mail: ), the id the mail tools use, when its Outlook link parses
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"list_id": "<list_id>"
},
"name": "list_todo_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delta | No | Start a change feed: return every task and a first delta token. Always reads every page | |
| list_id | Yes | To Do list ID. A delta token works only with the list it came from | |
| delta_token | No | The token from the last 'Delta token: …' line. Returns only what changed since. If the token is refused, start again with delta: true | |
| extension_name | No | Print this extension's fields at the end of each task line, as (Ext: {...}). With a change feed, only calls with a delta_token can include them | |
| fetch_all_pages | No | Fetch all pages of results (max 50 pages) |