update_project — MCP tool

added 2026-09-29can overwrite dataidempotent

Change a project's name, description, key (issue prefix), colour or visibility. Only the project owner may do this. public lets any signed-in user read the project by key and join it as a viewer; public to shared or private removes those self-joined viewers (list_members shows how many) and must fit the plan limits.

acceptance_criteriabooleanoptional
Turn the acceptance criteria list on or off (off only hides the items)
colorstringoptional
Project colour as #rrggbb
definition_of_donebooleanoptional
Turn the definition of done list on or off (same as acceptance_criteria)
descriptionstringoptional
New description
done_gateenumoptional
On a move to done with open AC / DoD items: off (nothing), warn (asks confirm_open_criteria), block. default: warn while the definition of done is on, else off
offwarnblockdefault
keystringoptional
New issue key prefix, 2–10 letters/digits starting with a letter. Issue keys change with it; the old key stops working
namestringoptional
New name
projectstringrequired
Project key
visibilityenumoptional
New visibility; from public it removes self-joined viewers and must fit the plan limits
privatesharedpublic

Returns

acceptanceCriteriabooleanrequired
definitionOfDonebooleanrequired
doneGatestringrequired
Effective done gate: off, warn or block
idstring (uuid)required
keystringrequired
Project key (issue prefix)
labelsarray of stringoptional
Default labels created (create_project only)
namestringrequired
removedSelfJoinedintegeroptional
People who joined by link and were removed by this narrowing; they can rejoin only by invitation
urlstringrequired
visibilitystringrequired

2026-09-30 — key, color
2026-10-06 — Visibility can be narrowed again: public to shared or private removes the viewers who joined by link (removedSelfJoined says how many) or is refused with plan_limit_reached.
2026-10-03 — New optional acceptance_criteria (bool), definition_of_done (bool) and done_gate (off, warn, block, or default: warn while the definition of done is on, else off).
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.