create_checklist_item
Add a checklist sub-item to a Microsoft To Do task. Specify the parent list, task, and the name of the new sub-item.
Instructions
Add a sub-item (checklist) to a task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| task_id | Yes | ||
| display_name | Yes | ||
| is_checked | No | ||
| verbose | No | If true: returns full JSON. Otherwise: compact text format (default, saves tokens). |
Implementation Reference
- src/graph.ts:663-676 (handler)Core handler that calls Microsoft Graph API POST endpoint to create a checklist item on a task.
export async function createChecklistItem( listId: string, taskId: string, displayName: string, isChecked = false ): Promise<ChecklistItem> { return graphFetch<ChecklistItem>( `/me/todo/lists/${enc(listId)}/tasks/${enc(taskId)}/checklistItems`, { method: "POST", body: JSON.stringify({ displayName, isChecked }), } ); } - src/index.ts:224-230 (schema)Zod input schema for create_checklist_item tool defining list_id, task_id, display_name, and is_checked fields.
create_checklist_item: z.object({ list_id: z.string(), task_id: z.string(), display_name: z.string(), is_checked: z.boolean().optional(), ...verboseField, }), - src/index.ts:673-687 (registration)Tool registration in the ListTools handler with name, description, and JSON Schema input definition.
{ name: "create_checklist_item", description: "Add a sub-item (checklist) to a task.", inputSchema: { type: "object", properties: { list_id: { type: "string" }, task_id: { type: "string" }, display_name: { type: "string" }, is_checked: { type: "boolean" }, ...verboseJsonProp, }, required: ["list_id", "task_id", "display_name"], }, }, - src/index.ts:1077-1086 (registration)CallToolRequestSchema handler case that parses args, calls createChecklistItem, and formats output.
case "create_checklist_item": { const a = schemas.create_checklist_item.strict().parse(args); const item = await createChecklistItem( a.list_id, a.task_id, a.display_name, a.is_checked ); return out(item, a.verbose, formatChecklistCompact); } - src/index.ts:475-476 (registration)Tool annotations/readability metadata: write_create semantics with title 'Create checklist item'.
create_checklist_item: { ...WRITE_CREATE, title: "Create checklist item" }, update_checklist_item: { ...WRITE_UPDATE, title: "Update checklist item" },