MCP Reference

calendar_event_list

List Calendar Events

Beschreibung

List cached events overlapping a time range of at most 62 days. Use ISO 8601 timestamps with explicit UTC offsets. Google calendars sync in the background; last_synced_at states freshness. Use calendar_sync when the requested range is not synchronized or freshness is insufficient. All-day end_on is exclusive. Pagination uses an offset and returns has_more.

Zugriff

Zugriffsprofil: gated. Module: calendar. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name	Typ	Pflicht	Beschreibung
`account_id`	string	Ja
`calendar_id`	string	Ja	Calendar prefix ID (cal_…).
`from`	string	Ja
`to`	string	Ja
`offset`	integer	Nein

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "calendar_id": {
      "type": "string",
      "description": "Calendar prefix ID (cal_…)."
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "account_id",
    "calendar_id",
    "from",
    "to"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "calendar_id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "starts_at": {
            "type": "string"
          },
          "ends_at": {
            "type": "string"
          },
          "all_day": {
            "type": "boolean"
          },
          "start_on": {
            "type": [
              "string",
              "null"
            ]
          },
          "end_on": {
            "type": [
              "string",
              "null"
            ]
          },
          "time_zone": {
            "type": "string"
          },
          "version": {
            "type": "integer"
          },
          "google_meet_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "conference_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "reminders": {
            "type": "object",
            "properties": {
              "useDefault": {
                "type": "boolean"
              },
              "overrides": {
                "type": "array",
                "maxItems": 5,
                "items": {
                  "type": "object",
                  "properties": {
                    "method": {
                      "type": "string",
                      "enum": [
                        "popup",
                        "email"
                      ]
                    },
                    "minutes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 40320
                    }
                  },
                  "required": [
                    "method",
                    "minutes"
                  ]
                }
              }
            }
          },
          "recurrence": {
            "type": "object",
            "properties": {
              "frequency": {
                "type": "string",
                "enum": [
                  "none",
                  "daily",
                  "weekly",
                  "monthly",
                  "yearly"
                ]
              },
              "interval": {
                "type": "integer",
                "minimum": 1,
                "maximum": 99
              },
              "weekdays": {
                "type": "array",
                "maxItems": 7,
                "items": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 7
                }
              },
              "monthly_mode": {
                "type": "string",
                "enum": [
                  "date",
                  "weekday",
                  "last_weekday",
                  "last_day"
                ]
              },
              "ends_on": {
                "type": "string"
              },
              "count": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1000
              }
            }
          },
          "series_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "series_version": {
            "type": [
              "integer",
              "null"
            ]
          },
          "google_recurrence": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Original Google RRULE/EXDATE/RDATE entries; preserved when recurrence is omitted on updates. Read the event directly for a fresh series version."
          },
          "invitation": {
            "type": "boolean"
          },
          "response_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "organizer": {
            "type": [
              "string",
              "null"
            ]
          },
          "guests": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string"
                },
                "displayName": {
                  "type": "string"
                },
                "responseStatus": {
                  "type": "string"
                },
                "optional": {
                  "type": "boolean"
                },
                "organizer": {
                  "type": "boolean"
                },
                "self": {
                  "type": "boolean"
                }
              }
            }
          },
          "can_manage_guests": {
            "type": "boolean"
          },
          "can_edit_reminders": {
            "type": "boolean"
          },
          "can_respond": {
            "type": "boolean"
          },
          "recurring_occurrence": {
            "type": "boolean"
          },
          "writable": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "calendar_id",
          "title",
          "starts_at",
          "ends_at",
          "all_day",
          "time_zone",
          "version",
          "invitation",
          "can_respond",
          "recurring_occurrence",
          "writable"
        ]
      }
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "type": [
        "integer",
        "null"
      ]
    },
    "last_synced_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "sync_error": {
      "type": [
        "string",
        "null"
      ]
    },
    "range_synchronized": {
      "type": "boolean"
    },
    "sync_window_start_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "sync_window_end_at": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "events",
    "has_more",
    "range_synchronized"
  ],
  "type": "object"
}