todoist_update_label
Modify an existing label in Todoist by updating its name, color, favorite status, or order using the label ID. Simplifies label management within task organization.
Instructions
Update an existing label by its ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | New color for the label (optional). | |
| isFavorite | No | New favorite status (optional). | |
| labelId | Yes | The ID of the label to update. | |
| name | No | New name for the label (optional). | |
| order | No | New order for the label (optional). |
Implementation Reference
- src/index.ts:1590-1604 (handler)Handler logic that validates arguments using isUpdateLabelArgs, destructures labelId and updateArgs, calls todoistClient.updateLabel, and returns formatted response or error.if (name === "todoist_update_label") { if (!isUpdateLabelArgs(args)) { return { content: [{ type: "text", text: "Invalid arguments for update_label" }], isError: true }; } try { const { labelId, ...updateArgs } = args; const updatedLabel = await todoistClient.updateLabel(labelId, updateArgs); return { content: [{ type: "text", text: `Label updated:\n${formatLabel(updatedLabel)}` }], isError: false }; } catch (error: any) { return { content: [{ type: "text", text: `Error updating label: ${error.message}` }], isError: true }; } }
- src/index.ts:335-349 (schema)Tool schema definition including name 'todoist_update_label', description, and inputSchema specifying required labelId and optional update fields.const UPDATE_LABEL_TOOL: Tool = { name: "todoist_update_label", description: "Update an existing label by its ID.", inputSchema: { type: "object", properties: { labelId: { type: "string", description: "The ID of the label to update." }, name: { type: "string", description: "New name for the label (optional)." }, color: { type: "string", description: "New color for the label (optional)." }, isFavorite: { type: "boolean", description: "New favorite status (optional)." }, order: { type: "number", description: "New order for the label (optional)." } }, required: ["labelId"] } };
- src/index.ts:1083-1121 (registration)Registration of the tool in the ListToolsRequestHandler by including UPDATE_LABEL_TOOL in the tools array.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ // Task tools CREATE_TASK_TOOL, QUICK_ADD_TASK_TOOL, GET_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, COMPLETE_TASK_TOOL, REOPEN_TASK_TOOL, SEARCH_TASKS_TOOL, MOVE_TASK_TOOL, BULK_MOVE_TASKS_TOOL, // Project tools GET_PROJECTS_TOOL, GET_PROJECT_TOOL, CREATE_PROJECT_TOOL, UPDATE_PROJECT_TOOL, DELETE_PROJECT_TOOL, // Section tools GET_SECTIONS_TOOL, CREATE_SECTION_TOOL, UPDATE_SECTION_TOOL, DELETE_SECTION_TOOL, // Label tools CREATE_LABEL_TOOL, GET_LABEL_TOOL, GET_LABELS_TOOL, UPDATE_LABEL_TOOL, DELETE_LABEL_TOOL, // Comment tools CREATE_COMMENT_TOOL, GET_COMMENT_TOOL, GET_COMMENTS_TOOL, UPDATE_COMMENT_TOOL, DELETE_COMMENT_TOOL, ], }));
- src/index.ts:1001-1014 (helper)Type guard helper function used in the handler to validate input arguments for the todoist_update_label tool.function isUpdateLabelArgs(args: unknown): args is { labelId: string; name?: string; color?: string; isFavorite?: boolean; order?: number; } { return ( typeof args === "object" && args !== null && "labelId" in args && typeof (args as { labelId: string }).labelId === "string" ); }
- src/index.ts:727-729 (helper)Helper function to format the updated label details for the response message.function formatLabel(label: any): string { return `- ${label.name} (ID: ${label.id})${label.color ? `\n Color: ${label.color}` : ''}${label.isFavorite ? `\n Favorite: Yes` : ''}${label.order ? `\n Order: ${label.order}`: ''}`; }