update_checklist_item
Idempotent
Rename or check/uncheck a sub-item in a Microsoft To Do task.
Instructions
Update a sub-item (rename or check/uncheck).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| task_id | Yes | ||
| item_id | Yes | ||
| display_name | No | ||
| is_checked | No | ||
| verbose | No | If true: returns full JSON. Otherwise: compact text format (default, saves tokens). |
Implementation Reference
- src/graph.ts:678-691 (handler)The actual implementation of updateChecklistItem: calls Microsoft Graph PATCH endpoint to update a checklist item's displayName and/or isChecked.
export async function updateChecklistItem( listId: string, taskId: string, itemId: string, patch: { displayName?: string; isChecked?: boolean } ): Promise<ChecklistItem> { return graphFetch<ChecklistItem>( `/me/todo/lists/${enc(listId)}/tasks/${enc(taskId)}/checklistItems/${enc(itemId)}`, { method: "PATCH", body: JSON.stringify(patch), } ); } - src/index.ts:1087-1094 (handler)Tool handler: parses args with zod schema, calls updateChecklistItem from graph.ts, formats the result.
case "update_checklist_item": { const a = schemas.update_checklist_item.strict().parse(args); const item = await updateChecklistItem(a.list_id, a.task_id, a.item_id, { displayName: a.display_name, isChecked: a.is_checked, }); return out(item, a.verbose, formatChecklistCompact); } - src/index.ts:231-238 (schema)Zod schema for update_checklist_item inputs: list_id, task_id, item_id (required), display_name and is_checked (optional).
update_checklist_item: z.object({ list_id: z.string(), task_id: z.string(), item_id: z.string(), display_name: z.string().optional(), is_checked: z.boolean().optional(), ...verboseField, }), - src/index.ts:689-703 (registration)Tool registration: declares name 'update_checklist_item', description, and inputSchema for MCP protocol.
name: "update_checklist_item", description: "Update a sub-item (rename or check/uncheck).", inputSchema: { type: "object", properties: { list_id: { type: "string" }, task_id: { type: "string" }, item_id: { type: "string" }, display_name: { type: "string" }, is_checked: { type: "boolean" }, ...verboseJsonProp, }, required: ["list_id", "task_id", "item_id"], }, }, - src/index.ts:476-476 (helper)Capability metadata entry: marks update_checklist_item as WRITE_UPDATE (non-idempotent write operation).
update_checklist_item: { ...WRITE_UPDATE, title: "Update checklist item" },