Timeline

Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages.

Updated 16 Sep 20261 min read

Send "type": "timeline".

Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages. Use this for simple chronological visualization of events or milestones WITHOUT task management. For project plans with tasks, durations, progress, and assignees, use render_gantt instead.

Also available as the MCP tool render_timeline. The same payload works through either surface.

Fields

data

eventsobject[]required

Array of timeline events

Child attributes

idstringrequired

Unique event ID (e.g., "evt_1")

titlestringrequired

Event title

descriptionstringrequired

Detailed event description

datestringrequired

ISO date string (real date for date mode, placeholder for label mode)

labelValuestringrequired

Empty string for date mode, meaningful label for label mode (e.g., "Stage 1", "3300 BCE")

coverTypestring

null, or "image" when this render includes images

coverFileIDstring

null, or when this render includes images: "mfimg::" followed by a description of this event's picture (no text, letters or numbers in it)

settingsobjectrequired

Timeline settings

Child attributes

boardTitlestring

Title of the timeline

themestring

Defaults to transparent.

layoutenum<string>

One of horizontal or vertical. Defaults to horizontal.

labelTypeenum<string>

"date" for chronological events with real dates, "label" for stages/phases/abstract sequences. One of date or label.

Example

{
  "type": "timeline",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "description": "string",
        "date": "string",
        "labelValue": "string",
        "coverType": "string",
        "coverFileID": "string"
      }
    ],
    "settings": {
      "boardTitle": "Q4 Launch Planning",
      "theme": "transparent",
      "layout": "horizontal",
      "labelType": "date"
    }
  }
}

Was this page helpful?