update_task
Modify existing Todoist tasks by updating content, due dates, priorities, labels, or descriptions to keep task management current and accurate.
Instructions
Update an existing task.
Args:
task_id: The ID of the task to update
content: Updated task content/title
description: Updated task description
labels: Updated list of label names
priority: Updated priority from 1 (normal) to 4 (urgent)
due_string: Updated human readable due date
due_date: Updated ISO 8601 formatted due dateInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| content | No | ||
| description | No | ||
| labels | No | ||
| priority | No | ||
| due_string | No | ||
| due_date | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- todoist_mcp/server.py:149-193 (handler)The MCP tool handler for 'update_task'. It validates inputs via type hints, constructs updates dictionary from provided parameters, calls the TodoistClient.update_task method, and returns a formatted success message with task details.
@mcp.tool() async def update_task( task_id: str, content: Optional[str] = None, description: Optional[str] = None, labels: Optional[List[str]] = None, priority: Optional[int] = None, due_string: Optional[str] = None, due_date: Optional[str] = None ) -> str: """Update an existing task. Args: task_id: The ID of the task to update content: Updated task content/title description: Updated task description labels: Updated list of label names priority: Updated priority from 1 (normal) to 4 (urgent) due_string: Updated human readable due date due_date: Updated ISO 8601 formatted due date """ _check_client() updates = {} if content is not None: updates["content"] = content if description is not None: updates["description"] = description if labels is not None: updates["labels"] = labels if priority is not None: updates["priority"] = priority if due_string is not None: updates["due_string"] = due_string if due_date is not None: updates["due_date"] = due_date task = await todoist_client.update_task(task_id, **updates) return ( f"Task updated successfully!\n" f"ID: {task.id}\n" f"Title: {task.content}\n" f"URL: {task.url}" ) - todoist_mcp/client.py:137-140 (helper)Helper method in TodoistClient that performs the HTTP POST request to Todoist's REST API to update the task with the given updates.
async def update_task(self, task_id: str, **updates) -> TodoistTask: """Update an existing task.""" data = await self._request("POST", f"/tasks/{task_id}", json=updates) return TodoistTask(**data) - todoist_mcp/server.py:149-149 (registration)The @mcp.tool() decorator registers the update_task function as an MCP tool with the name 'update_task' using FastMCP.
@mcp.tool()