Gantt
Create a Gantt chart with project phases and tasks for project planning, scheduling, and milestone tracking.
Send "type": "gantt".
Create a Gantt chart with project phases and tasks for project planning, scheduling, and milestone tracking. Use this for task management with durations, progress, assignees, and grouped phases. For simple chronological event visualization (history, milestones, biography events), use render_timeline instead.
Also available as the MCP tool render_gantt. The same payload works through either surface.
Fields
columnsobject[]requiredArray of Gantt chart columns/phases. Each column must have a different color.
Child attributes
idstringrequiredUnique column ID (e.g., col_1, col_2)
titlestringrequiredPhase/category title (e.g., Planning, Development)
colorstringrequiredColumn accent color. Use: #1c7ce2, #ff9800, #9c27b0, #4caf50, #2196f3
fontColorstringFont color for column. Defaults to #5e6c84.
cardsobject[]requiredArray of task cards in this phase
settingsobjectrequiredChart settings
Child attributes
boardTitlestringTitle of the Gantt chart
viewModestringView mode: day, week, or month. Defaults to day.
themestringDefaults to light.
showWeekendsbooleanDefaults to true.
Example
{
"type": "gantt",
"data": {
"columns": [
{
"id": "string",
"title": "Q4 Launch Planning",
"color": "string",
"fontColor": "#5e6c84",
"cards": [
{
"id": "string",
"title": "Q4 Launch Planning",
"description": "string",
"startDate": "string",
"endDate": "string",
"dueDate": "string",
"progress": 0,
"assignees": [
"string"
],
"labels": [
"string"
],
"comments": [
{}
]
}
]
}
],
"settings": {
"boardTitle": "Q4 Launch Planning",
"viewMode": "day",
"theme": "light",
"showWeekends": true
}
}
}
Add one record
POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.
Record fields
titlestringrequiredstartDatestringrequiredendDatestringphasestringThe phase it goes in; made when the chart has none by that name.
progressnumberkeystringYour own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.
{
"record": {
"title": "Q4 Launch Planning",
"startDate": "string",
"endDate": "string",
"phase": "string",
"progress": 0,
"key": "string"
}
}