# Calendar

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

Source: https://mockflow.com/developers/reference/item-types/calendar

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

- `events` (object[], required): Array of calendar events. Use same color for all events.
    - `id` (string, required): Unique event ID (e.g., event_1)
  - `title` (string, required): Event title
  - `description` (string): Event description
  - `start` (string, required): Start date/time in ISO 8601 format with Z suffix
  - `end` (string): End date/time. For timed events: same day as start. For all-day: equals start.
  - `allDay` (boolean): True for all-day events
  - `color` (string): Event color. Use one of: #4285f4, #ea4335, #fbbc04, #34a853, #ff6d01, #46bdc6, #7986cb, #8e24aa
  - `location` (string): Event location
  - `attendees` (string[])
  - `reminders` (object[])
  - `recurrence` (string): Recurrence rule or null
  - `createdAt` (string): ISO date string
- `settings` (object, required): Calendar settings
    - `theme` (string): Defaults to `default`.
  - `weekStartsOn` (enum<integer>): 0 for Sunday, 1 for Monday. One of `0` or `1`.
  - `dateFormat` (enum<string>): One of `MM/DD/YYYY` or `DD/MM/YYYY`. Defaults to `MM/DD/YYYY`.
  - `timeFormat` (enum<string>): One of `12h` or `24h`. Defaults to `12h`.
  - `highlightWeekends` (boolean): Defaults to `true`.
  - `showWeekNumbers` (boolean): Defaults to `false`.

## Example

```json
{
  "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
    }
  }
}
```