Mcp Microsoft Todo

List all the user's To Do lists (Tasks, Inbox, custom lists, etc.).

List the tasks of a To Do list. Supports OData filter, $orderby, $top, and pagination.

Fetch a task's detail by ID.

Create a new task in a To Do list. Supports recurrence and reminder.

Update an existing task (title, status, recurrence, reminder, etc.).

Shortcut to mark a task as completed.

Delete a task permanently.

Move a task from one list to another. Recreates the task in the target list (title, body, due, recurrence, reminder, categories preserved) then deletes the original. Note: checklistItems and linkedResources are NOT moved (Graph limitation). The task ID changes.

Search a term in the titles of tasks across ALL lists (case-sensitive). By default excludes completed tasks.

Summary of tasks due today and overdue, aggregated per list. Useful for the question "what do I have to do today?".

Fetch every active task across every list in a single round-trip (uses Graph $batch internally). Use this for the question "what are all my tasks?" instead of N×list_tasks calls. Optional `filter` is an OData filter applied per list (e.g. "importance eq 'high'"). By default `status ne 'completed'` is appended unless `include_completed` is true.

List the sub-items (checklist) of a task.

Add a sub-item (checklist) to a task.

Update a sub-item (rename or check/uncheck).

Delete a sub-item.

List the linked resources (external URLs, third-party app refs) of a task.

Attach a linked resource (URL or external ref) to a task.

Delete a linked resource from a task.

Create several tasks in a single HTTP call via Microsoft Graph $batch (up to 100 items, auto-chunked by 20). Returns: status + result OR error per item, in order. More efficient than N create_task calls.

Mark several tasks as completed in a single $batch HTTP call (up to 100 items).

Delete several tasks in a single $batch HTTP call (up to 100 items).

List the open extensions (custom JSON metadata) attached to a task.

Create or update (upsert) an open extension on a task. Lets you attach arbitrary JSON metadata (project_id, external_ref, custom flags...) that persist in Microsoft Graph.

Delete an open extension from a task.

List ALL overdue tasks (status ne completed and dueDateTime < today) across every list. Aggregated via Promise.all.

List ALL tasks containing a given category, across every list. OData filter: categories/any(c: c eq '...').

Add/remove categories on several tasks in one operation. 2-phase batch: GET to read existing categories, then PATCH with the updated set. Per-item errors, no global fail.

Export tasks to iCalendar format (text/calendar VTODO) for import into Google Calendar, Apple Calendar, Outlook, Thunderbird, etc. Recurrence converted to RRULE when possible. Reminder converted to VALARM.