clickup_set_custom_field_value
Update custom field values on ClickUp tasks to track project details, status updates, or specific attributes within your workspace.
Instructions
Set a value for a custom field on a task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ClickUp task ID | |
| custom_field_id | Yes | Custom field ID | |
| value | Yes | Value to set for the custom field. Type depends on the custom field type. |
Implementation Reference
- The MCP tool handler function that destructures input and calls the CustomFieldService to set the custom field value on a task, then returns the response as JSON text.
handler: async (input) => { const { task_id, custom_field_id, value } = input; const response = await customFieldService.setCustomFieldValue( task_id, custom_field_id, value ); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }, - Zod input schema validating task_id, custom_field_id, and flexible value (string, number, boolean, array, or object).
inputSchema: { task_id: z.string().describe("ClickUp task ID"), custom_field_id: z.string().describe("Custom field ID"), value: z .union([ z.string(), z.number(), z.boolean(), z.array(z.unknown()), z.record(z.unknown()), ]) .describe( "Value to set for the custom field. Type depends on the custom field type." ), }, - src/index.ts:89-91 (registration)Registers the clickup_set_custom_field_value tool (along with others) to the MCP server by calling server.tool() in a loop over the tools array.
tools.forEach((tool) => { server.tool(tool.name, tool.description, tool.inputSchema, tool.handler); }); - Service method that sends a POST request to ClickUp API to set the custom field value on the specified task.
async setCustomFieldValue( taskId: string, customFieldId: string, value: any ): Promise<{ field: ClickUpCustomField }> { return this.request<{ field: ClickUpCustomField }>( `/task/${taskId}/field/${customFieldId}`, { method: "POST", body: JSON.stringify({ value }), } ); } - src/index.ts:48-49 (registration)Includes the setCustomFieldValueTool in the tools array used for MCP server registration.
getListCustomFieldsTool, setCustomFieldValueTool,