Skip to main content
Glama

Edit Task

task_edit
DestructiveIdempotent

Update fields on one task (task) or on several at once (tasks, max 50). Only the provided fields are changed; omitted fields are left untouched. To remove a value, list the field in clear (e.g. clear: ["deadline"]). Notes replace the existing notes (no append). assignee assigns the task; clear it to unassign. add_labels and remove_labels change which labels are on it. Editing several tasks applies the same changes to every one of them and cannot be undone in one call, so confirm the list with the user first. For status changes use task_done, task_reopen or task_archive, and for checklist items use the available checklist tools; this tool does not change either.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
taskNoWorkspace-scoped task number, encoded as a string
teamNoTeam id, key, or name
whenNoMove to a different GTD view
clearNoFields to remove a value from, e.g. ["deadline"]. Use this rather than sending an empty string.
notesNoNew description/notes (replaces existing)
tasksNoSeveral workspace-scoped task numbers (max 50), instead of `task`. Confirm the list with the user first: one call changes every task in it.
titleNoNew title
contextYesExplain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."
projectNoProject id, key, or name
assigneeNoAssign to a member (user id, name, or email) or a task agent (id or name)
deadlineNoSet due date (YYYY-MM-DD)
timezoneNoIANA timezone used to resolve "today" for views and scheduling (e.g. Australia/Melbourne). Defaults to UTC, which misclassifies Today/Upcoming for users in other timezones, so always pass the user's timezone when known.
workspaceNoWorkspace id, slug, or name. Required when the account has more than one workspace: a call without it then fails and names the choices
add_labelsNoLabels to attach (each a label id, title, or id prefix). The label has to exist already — create one with label_create
remove_labelsNoLabels to detach (each a label id, title, or id prefix)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
countYes
tasksYesEvery task the call changed, in the order it was given
actionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / assignee / description
      Previous value: -"Assign to a member (user id, name, or email)"New value: +"Assign to a member (user id, name, or email) or a task agent (id or name)"
  2. Changed1 schema field changed
    • changedInput schema / properties / workspace / description
      Previous value: -"Workspace id, slug, or name"New value: +"Workspace id, slug, or name. Required when the account has more than one workspace: a call without it then fails and names the choices"
  3. Changed9 schema fields changed
    • addedInput schema / properties / add_labels
      Added value: +{
      +  "description": "Labels to attach (each a label id, title, or id prefix). The label has to exist already — create one with label_create",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / remove_labels
      Added value: +{
      +  "description": "Labels to detach (each a label id, title, or id prefix)",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / tasks
      Added value: +{
      +  "description": "Several workspace-scoped task numbers (max 50), instead of `task`. Confirm the list with the user first: one call changes every task in it.",
      +  "items": {
      +    "description": "Workspace-scoped task number, encoded as a string",
      +    "pattern": "^[1-9]\\d*$",
      +    "type": "string"
      +  },
      +  "maxItems": 50,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "task",
      -  "context"
      -]New value: +[
      +  "context"
      +]
    • addedOutput schema / properties / count
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • removedOutput schema / properties / id
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / number
      Removed value: -{
      -  "exclusiveMinimum": 0,
      -  "maximum": 9007199254740991,
      -  "type": "integer"
      -}
    • addedOutput schema / properties / tasks
      Added value: +{
      +  "description": "Every task the call changed, in the order it was given",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "type": "string"
      +      },
      +      "number": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "title": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "number",
      +      "title"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "action",
      -  "id",
      -  "number",
      -  "ok"
      -]New value: +[
      +  "action",
      +  "count",
      +  "ok",
      +  "tasks"
      +]
  4. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources