Calendar

Create a calendar with events for schedules, appointments, holidays, and event planning.

Updated 18 Sep 20261 min read

Send "type": "calendar".

Create a calendar with events for schedules, appointments, holidays, and event planning.

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

Fields

data

eventsobject[]required

Array of calendar events. Use same color for all events.

Child attributes

idstringrequired

Unique event ID (e.g., event_1)

titlestringrequired

Event title

descriptionstring

Event description

startstringrequired

Start date/time in ISO 8601 format with Z suffix

endstring

End date/time. For timed events: same day as start. For all-day: equals start.

allDayboolean

True for all-day events

colorstring

Event color. Use one of: #4285f4, #ea4335, #fbbc04, #34a853, #ff6d01, #46bdc6, #7986cb, #8e24aa

locationstring

Event location

attendeesstring[]

remindersobject[]

recurrencestring

Recurrence rule or null

createdAtstring

ISO date string

settingsobjectrequired

Calendar settings

Child attributes

themestring

Defaults to default.

weekStartsOnenum<integer>

0 for Sunday, 1 for Monday. One of 0 or 1.

dateFormatenum<string>

One of MM/DD/YYYY or DD/MM/YYYY. Defaults to MM/DD/YYYY.

timeFormatenum<string>

One of 12h or 24h. Defaults to 12h.

highlightWeekendsboolean

Defaults to true.

showWeekNumbersboolean

Defaults to false.

Example

{
  "type": "calendar",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "description": "string",
        "start": "string",
        "end": "string",
        "allDay": false,
        "color": "string",
        "location": "string",
        "attendees": [
          "string"
        ]
      }
    ],
    "settings": {
      "theme": "default",
      "weekStartsOn": 0,
      "dateFormat": "MM/DD/YYYY",
      "timeFormat": "12h",
      "highlightWeekends": true,
      "showWeekNumbers": false
    }
  }
}

Was this page helpful?