update_checklist_item
Update a ClickUp checklist item's name, assignee, or resolved status by specifying the checklist and item IDs.
Instructions
Update an existing ClickUp checklist item's properties including name, assignee, and resolved status.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| checklist_id | Yes | The ID of the checklist containing the item | |
| checklist_item_id | Yes | The ID of the checklist item to update | |
| name | No | The new name of the checklist item | |
| assignee | No | The ID of the user to assign to the checklist item | |
| resolved | No | Whether the checklist item is resolved |
Implementation Reference
- src/tools/checklist-tools.ts:116-147 (registration)Tool registration and handler for 'update_checklist_item'. Defines the tool with Zod schema params (checklist_id, checklist_item_id, optional name/assignee/resolved), and the handler that calls checklistsClient.updateChecklistItem() and returns the result.
// Register update_checklist_item tool server.tool( 'update_checklist_item', 'Update an existing ClickUp checklist item\'s properties including name, assignee, and resolved status.', { checklist_id: z.string().describe('The ID of the checklist containing the item'), checklist_item_id: z.string().describe('The ID of the checklist item to update'), name: z.string().optional().describe('The new name of the checklist item'), assignee: z.number().optional().describe('The ID of the user to assign to the checklist item'), resolved: z.boolean().optional().describe('Whether the checklist item is resolved') }, async ({ checklist_id, checklist_item_id, name, assignee, resolved }) => { try { const itemParams: UpdateChecklistItemParams = {}; if (name !== undefined) itemParams.name = name; if (assignee !== undefined) itemParams.assignee = assignee; if (resolved !== undefined) itemParams.resolved = resolved; const checklistItem = await checklistsClient.updateChecklistItem(checklist_id, checklist_item_id, itemParams); return { content: [{ type: 'text', text: JSON.stringify(checklistItem, null, 2) }] }; } catch (error: any) { console.error('Error updating checklist item:', error); return { content: [{ type: 'text', text: `Error updating checklist item: ${error.message}` }], isError: true }; } } ); - TypeScript interface for update checklist item parameters: all optional fields (name, assignee, resolved).
export interface UpdateChecklistItemParams { name?: string; assignee?: number; resolved?: boolean; } - src/clickup-client/checklists.ts:99-101 (handler)The API client method that sends a PUT request to /checklist/{checklistId}/checklist_item/{checklistItemId} to update the checklist item.
async updateChecklistItem(checklistId: string, checklistItemId: string, params: UpdateChecklistItemParams): Promise<ChecklistItem> { return this.client.put(`/checklist/${checklistId}/checklist_item/${checklistItemId}`, params); } - src/index.ts:40-47 (registration)Server entry point: calls setupChecklistTools(server) which registers 'update_checklist_item' among other checklist tools.
private setupTools() { // Set up all tools setupTaskTools(this.server); setupDocTools(this.server); setupSpaceTools(this.server); setupChecklistTools(this.server); setupCommentTools(this.server); }