task — Tool Reference

Task board. create, update, and list tasks. When a task is marked completed, its result is automatically saved as a memory for future reference.

Aliases

The deprecated agent tool routes create_task, update_task, and list_tasks to the task tool. Other agent actions return a deprecation notice.

Parameters

Name	Type	Required	Description
`action`	string	Yes	One of `create`, `update`, `list`.
`task_id`	string	—	Task ID. Used with `update`.
`title`	string	—	Task title. Used with `create`.
`description`	string	—	Task description.
`status`	string	—	One of `open`, `in_progress`, `completed`, `cancelled`.
`priority`	string	—	One of `low`, `medium`, `high`, `urgent`.
`tags`	string[]	—	Tags for categorization.
`domain`	string	—	Knowledge domain. Filters tasks on `list`, tags on `create`/`update`.
`result`	object	—	Task outcome. Used with `update` when completing.
`metadata`	object	—	Arbitrary metadata.
`query`	string	—	Search tasks by title or description. Used with `list`.
`limit`	number	—	Maximum number of results.

create

Create a new task. Tasks start with status open by default.

Parameters: title (required), description, priority, tags, domain, metadata

{
  "name": "task",
  "arguments": {
    "action": "create",
    "title": "Migrate analytics from GA to Plausible",
    "description": "Replace Google Analytics tracking with Plausible on all client sites",
    "priority": "high",
    "domain": "infrastructure",
    "tags": ["analytics", "migration"]
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Task created: Migrate analytics from GA to Plausible (task_m1n2o3)\nPriority: high\nStatus: open\nDomain: infrastructure"
    }
  ]
}

update

Update a task's status, priority, description, or record its result. Setting status to completed auto-saves the result as a memory.

Parameters: task_id (required), status, priority, description, tags, domain, result, metadata

{
  "name": "task",
  "arguments": {
    "action": "update",
    "task_id": "task_m1n2o3",
    "status": "completed",
    "result": {
      "summary": "Plausible installed on 4 client sites, GA removed, verified tracking for 48 hours",
      "sites_migrated": ["acme.com", "globex.com", "initech.com", "umbrella.co"]
    }
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Task task_m1n2o3 updated: status → completed.\nResult saved as memory mem_p4q5r6 in domain: infrastructure."
    }
  ]
}

list

List tasks with optional filters. Supports filtering by status, domain, priority, and free-text search.

Parameters: status, domain, priority, tags, query, limit

{
  "name": "task",
  "arguments": {
    "action": "list",
    "status": "open",
    "domain": "infrastructure",
    "limit": 10
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "3 open tasks in infrastructure:\n\n1. [task_s7t8u9] Set up staging environment for new API (high)\n   Tags: devops, staging\n\n2. [task_v0w1x2] Audit CloudFlare WAF rules (medium)\n   Tags: security\n\n3. [task_y3z4a5] Document backup restore procedure (low)\n   Tags: documentation, disaster-recovery"
    }
  ]
}