update_status — MCP tool

added 2026-10-01idempotent

Rename a status, change its colour or (for a custom status) its category (needs edit access). The key never changes. The four default statuses (todo, in_progress, review, done) can be renamed and recoloured, but keep their category. color: #rrggbb, or an empty string to clear it.

categoryenumoptional
New category (custom statuses only)
todoin_progressreviewdone
colorstringoptional
New colour as #rrggbb, or empty to clear
namestringoptional
New name
projectstringrequired
Project key
statusstringrequired
Status key (see list_statuses)

Returns

categorystringrequired
colorstringoptional
#rrggbb, absent when the status has no colour
keystringrequired
namestringrequired
projectstringrequired

2026-10-03 — Also answers structuredContent (see outputSchema); a failed call adds structuredContent.error. Text unchanged. Details: /docs/mcp, "Structured results and errors".
2026-10-04 — Claude Code 2.1.288+ (clientInfo claude-code): the text of a successful answer is itself up to 512 bytes, else "Result in structuredContent (N bytes)."; structuredContent and errors are unchanged. See /docs/mcp.