Skip to main content
FuseFuse
IntegrationsGoogle workspaceActions

List Google Calendar events

List events on a calendar the connected principal can access.

Agent markdown

calendar.events.list · Google Workspace · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • https://www.googleapis.com/auth/calendar.events.readonly

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
calendar_idstringNominLength 1; maxLength 256
page_sizeintegerNominimum 1; maximum 250
page_tokenstringNominLength 1; maxLength 512
time_minstringNominLength 10; maxLength 64
time_maxstringNominLength 10; maxLength 64
qstringNomaxLength 512

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
eventsarray<object>YesmaxItems 250
events[]objectYesadditionalProperties false
events[].idstringYesmaxLength 1024
events[].statusstringYesmaxLength 64
events[].summarystringNomaxLength 1024
events[].descriptionstringNomaxLength 8192
events[].locationstringNomaxLength 1024
events[].startobjectNoadditionalProperties false; oneOf branch 1: required date_time / branch 2: required date
events[].start.date_timestringNominLength 10; maxLength 64
events[].start.datestringNominLength 10; maxLength 10; pattern ^\d{4}-\d{2}-\d{2}$
events[].start.time_zonestringNominLength 1; maxLength 64
events[].endobjectNoadditionalProperties false; oneOf branch 1: required date_time / branch 2: required date
events[].end.date_timestringNominLength 10; maxLength 64
events[].end.datestringNominLength 10; maxLength 10; pattern ^\d{4}-\d{2}-\d{2}$
events[].end.time_zonestringNominLength 1; maxLength 64
events[].html_linkstringNomaxLength 2048
next_page_tokenstringNomaxLength 512

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "calendar_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "page_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "time_min": {
      "type": "string",
      "minLength": 10,
      "maxLength": 64
    },
    "time_max": {
      "type": "string",
      "minLength": 10,
      "maxLength": 64
    },
    "q": {
      "type": "string",
      "maxLength": 512
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 1024
          },
          "status": {
            "type": "string",
            "maxLength": 64
          },
          "summary": {
            "type": "string",
            "maxLength": 1024
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          },
          "location": {
            "type": "string",
            "maxLength": 1024
          },
          "start": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "date_time": {
                "type": "string",
                "minLength": 10,
                "maxLength": 64
              },
              "date": {
                "type": "string",
                "minLength": 10,
                "maxLength": 10,
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "time_zone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              }
            },
            "oneOf": [
              {
                "required": [
                  "date_time"
                ]
              },
              {
                "required": [
                  "date"
                ]
              }
            ]
          },
          "end": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "date_time": {
                "type": "string",
                "minLength": 10,
                "maxLength": 64
              },
              "date": {
                "type": "string",
                "minLength": 10,
                "maxLength": 10,
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "time_zone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              }
            },
            "oneOf": [
              {
                "required": [
                  "date_time"
                ]
              },
              {
                "required": [
                  "date"
                ]
              }
            ]
          },
          "html_link": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "required": [
          "id",
          "status"
        ]
      },
      "maxItems": 250
    },
    "next_page_token": {
      "type": "string",
      "maxLength": 512
    }
  },
  "required": [
    "events"
  ]
}