Sign up
All data sources

Google Calendar

OAuthgoogleCalendar

Google Calendar connector for managing calendars and events (read & write). CRITICAL USAGE RULES: 1. Use createCalendar() to create new calendars; deleteCalendar() to remove them (cannot delete primary). 2. Use listCalendars() to discover calendar IDs; use "primary" when unsure. 3. Provide ISO timestamps for timeMin/timeMax when filtering events. 4. For createEvent/updateEvent, start and end must include either dateTime or date. 5. Use deleteEvent with sendUpdates='all' to notify attendees of cancellations.

Get this contract as JSON

Provenance

PublisherGoogle Calendar
API basehttps://www.googleapis.com/

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (OAuth)

Methods (8)

  • listCalendars

    read

    List Google calendars for the current user.

    Input schema
    {
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "number",
      "description": "Maximum calendars to return."
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token."
    },
    "minAccessRole": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

  • listEvents

    read

    List events for a calendar with optional time filters.

    Required paramscalendarId
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Google Calendar ID or primary."
    },
    "maxResults": {
      "type": "number",
      "description": "Maximum events to return."
    },
    "pageToken": {
      "type": "string"
    },
    "timeMin": {
      "type": "string",
      "description": "Inclusive ISO timestamp lower bound."
    },
    "timeMax": {
      "type": "string",
      "description": "Exclusive ISO timestamp upper bound."
    },
    "q": {
      "type": "string",
      "description": "Free-text event search."
    },
    "singleEvents": {
      "type": "boolean"
    },
    "orderBy": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "startTime"
          ]
        },
        {
          "type": "string",
          "enum": [
            "updated"
          ]
        }
      ]
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId"
  ]
}

  • createEvent

    write

    Create an event on a Google calendar.

    Required paramscalendarIdsummarystartend
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Google Calendar ID or primary."
    },
    "summary": {
      "type": "string",
      "description": "Event title."
    },
    "description": {
      "type": "string",
      "description": "Optional event description."
    },
    "location": {
      "type": "string",
      "description": "Optional event location."
    },
    "start": {
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "timeZone": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "Event start with dateTime or date."
    },
    "end": {
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "timeZone": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "Event end with dateTime or date."
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional attendee list."
    },
    "reminders": {
      "type": "object",
      "properties": {
        "useDefault": {
          "type": "boolean"
        },
        "overrides": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "method": {
                "type": "string"
              },
              "minutes": {
                "type": "number"
              }
            },
            "required": [
              "method",
              "minutes"
            ],
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "recurrence": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "colorId": {
      "type": "string"
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId",
    "summary",
    "start",
    "end"
  ]
}

  • getEvent

    read

    Fetch one Google Calendar event by ID.

    Required paramscalendarIdeventId
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Google Calendar ID or primary."
    },
    "eventId": {
      "type": "string",
      "description": "Google Calendar event ID."
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId",
    "eventId"
  ]
}

  • updateEvent

    write

    Update an existing Google Calendar event, including moving or resizing it by changing start and end.

    Required paramscalendarIdeventId
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Google Calendar ID or primary."
    },
    "eventId": {
      "type": "string",
      "description": "Google Calendar event ID."
    },
    "summary": {
      "type": "string",
      "description": "Optional updated event title."
    },
    "description": {
      "type": "string",
      "description": "Optional updated event description."
    },
    "location": {
      "type": "string",
      "description": "Optional updated location."
    },
    "start": {
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "timeZone": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "Optional updated start with dateTime or date."
    },
    "end": {
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "timeZone": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "Optional updated end with dateTime or date."
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional updated attendee list."
    },
    "reminders": {
      "type": "object",
      "properties": {
        "useDefault": {
          "type": "boolean"
        },
        "overrides": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "method": {
                "type": "string"
              },
              "minutes": {
                "type": "number"
              }
            },
            "required": [
              "method",
              "minutes"
            ],
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "recurrence": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "colorId": {
      "type": "string"
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId",
    "eventId"
  ]
}

  • deleteEvent

    write

    Delete an event from a Google Calendar.

    Required paramscalendarIdeventId
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Google Calendar ID or primary."
    },
    "eventId": {
      "type": "string",
      "description": "Google Calendar event ID."
    },
    "sendUpdates": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "all"
          ]
        },
        {
          "type": "string",
          "enum": [
            "externalOnly"
          ]
        },
        {
          "type": "string",
          "enum": [
            "none"
          ]
        }
      ],
      "type": "string",
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "description": "Whether to notify attendees about the cancellation."
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId",
    "eventId"
  ]
}

  • createCalendar

    write

    Create a new secondary Google Calendar.

    Required paramssummary
    Input schema
    {
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Calendar name."
    },
    "description": {
      "type": "string",
      "description": "Optional calendar description."
    },
    "location": {
      "type": "string",
      "description": "Optional calendar location."
    },
    "timeZone": {
      "type": "string",
      "description": "IANA time zone, defaults to America/Chicago."
    }
  },
  "additionalProperties": true,
  "required": [
    "summary"
  ]
}

  • deleteCalendar

    write

    Delete a secondary Google Calendar. The primary calendar cannot be deleted.

    Required paramscalendarId
    Input schema
    {
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Secondary Google Calendar ID."
    }
  },
  "additionalProperties": true,
  "required": [
    "calendarId"
  ]
}