update_task

update_task

Modify the properties of an existing task. Use this tool when you need to change a task's name, description, status, priority, or due date. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups. Only the fields you specify will be updated; other fields will remain unchanged.

Input Schema

Name	Required	Description
`description`	No	New plain text description for the task
`listName`	No	Optional: Name of the list to narrow down task search when multiple tasks have the same name
`markdown_description`	No	New markdown formatted description for the task. If provided, this takes precedence over description
`name`	No	New name for the task
`priority`	No	New priority for the task (1-4 or null), where 1 is urgent/highest priority and 4 is lowest priority. Set to null to clear priority.
`status`	No	New status for the task (must be a valid status in the task's list)
`taskId`	No	ID of the task to update (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
`taskName`	No	Name of the task to update - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses.

Input Schema (JSON Schema)

{
  "oneOf": [
    {
      "required": [
        "taskId"
      ]
    },
    {
      "required": [
        "taskName"
      ]
    }
  ],
  "properties": {
    "description": {
      "description": "New plain text description for the task",
      "type": "string"
    },
    "listName": {
      "description": "Optional: Name of the list to narrow down task search when multiple tasks have the same name",
      "type": "string"
    },
    "markdown_description": {
      "description": "New markdown formatted description for the task. If provided, this takes precedence over description",
      "type": "string"
    },
    "name": {
      "description": "New name for the task",
      "type": "string"
    },
    "priority": {
      "description": "New priority for the task (1-4 or null), where 1 is urgent/highest priority and 4 is lowest priority. Set to null to clear priority.",
      "enum": [
        1,
        2,
        3,
        4,
        null
      ],
      "optional": true,
      "type": [
        "number",
        "null"
      ]
    },
    "status": {
      "description": "New status for the task (must be a valid status in the task's list)",
      "type": "string"
    },
    "taskId": {
      "description": "ID of the task to update (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name.",
      "type": "string"
    },
    "taskName": {
      "description": "Name of the task to update - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses.",
      "type": "string"
    }
  },
  "type": "object"
}

Input Schema

Input Schema (JSON Schema)

Other Tools