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.

Provenance

PublisherGoogle Calendar

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."
        }
      },
      "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."
        },
        "timeMin": {
          "type": "string",
          "description": "Inclusive ISO timestamp lower bound."
        },
        "timeMax": {
          "type": "string",
          "description": "Exclusive ISO timestamp upper bound."
        },
        "maxResults": {
          "type": "number",
          "description": "Maximum events to return."
        },
        "q": {
          "type": "string",
          "description": "Free-text event search."
        }
      },
      "required": [
        "calendarId"
      ],
      "additionalProperties": true
    }
  • 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",
          "description": "Event start with dateTime or date."
        },
        "end": {
          "type": "object",
          "description": "Event end with dateTime or date."
        },
        "attendees": {
          "type": "array",
          "description": "Optional attendee list.",
          "items": {
            "type": "object"
          }
        }
      },
      "required": [
        "calendarId",
        "summary",
        "start",
        "end"
      ],
      "additionalProperties": true
    }
  • 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."
        }
      },
      "required": [
        "calendarId",
        "eventId"
      ],
      "additionalProperties": true
    }
  • 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",
          "description": "Optional updated start with dateTime or date."
        },
        "end": {
          "type": "object",
          "description": "Optional updated end with dateTime or date."
        },
        "attendees": {
          "type": "array",
          "description": "Optional updated attendee list.",
          "items": {
            "type": "object"
          }
        }
      },
      "required": [
        "calendarId",
        "eventId"
      ],
      "additionalProperties": true
    }
  • 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": {
          "type": "string",
          "enum": [
            "all",
            "externalOnly",
            "none"
          ],
          "description": "Whether to notify attendees about the cancellation."
        }
      },
      "required": [
        "calendarId",
        "eventId"
      ],
      "additionalProperties": true
    }
  • 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."
        }
      },
      "required": [
        "summary"
      ],
      "additionalProperties": true
    }
  • 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."
        }
      },
      "required": [
        "calendarId"
      ],
      "additionalProperties": true
    }