create_project — MCP tool

added 2026-09-29

Create a project owned by you. visibility: private (only you), shared (you and invited members) or public (any signed-in user can read it; only members can change it). The key (issue prefix) is derived from the name unless given. The project starts with the labels bug, feature and improvement. template adds example issues (example_issues).

acceptance_criteriabooleanoptional
Turn the acceptance criteria list on for every issue (default off; can be changed later with update_project)
definition_of_donebooleanoptional
Turn the definition of done list on for every issue (default off). The done gate then starts at warn; change it with update_project
descriptionstringoptional
Short description (optional)
idempotency_keystringoptional
As in create_issue
keystringoptional
Issue key prefix, 2–10 letters/digits starting with a letter (optional)
namestringrequired
Project name
templateenumoptional
Add example issues
softwarepersonallaunch
visibilityenumoptional
Who can see the project (default private)
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-10-10 — New template and idempotency_key arguments.
2026-10-04 — Free accounts own at most 5 live projects (see plan in get_preferences); a full plan refuses with code plan_limit_reached and details {limit, used, max, plan, subject}.
2026-10-03 — New optional booleans acceptance_criteria and definition_of_done turn those checklists on from the start (both default 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.