Google Super
GOOGLESUPER_CREATE_EVENT
Create a Google Calendar event using `start_datetime` plus `event_duration_hour` and `event_duration_minutes` fields to derive the end time. Requires calendar write access. The organizer is added as an attendee unless `exclude_organizer` is True. Example request to create event for 1 hour 30 minutes: { "calendar_id": "primary", "start_datetime": "2025-01-16T13:00:00", "timezone": "America/New_York", "event_duration_hour": 1, "event_duration_minutes": 30, "summary": "Client sync", "attendees": [{"email": "[email protected]"}] }
Remote googlesuper
Other tools also called GOOGLESUPER_CREATE_EVENT?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"summary": {
"type": "string",
"title": "Summary",
"default": null,
"nullable": true,
"description": "Summary (title) of the event."
},
"location": {
"type": "string",
"title": "Location",
"default": null,
"nullable": true,
"description": "Geographic location of the event as free-form text."
},
"timezone": {
"type": "string",
"title": "Timezone",
"default": null,
"nullable": true,
"description": "IANA timezone name (e.g., 'America/New_York'). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC."
},
"attendees": {
"type": "array",
"items": {
"type": "string",
"properties": {}
},
"title": "Attendees",
"default": null,
"nullable": true,
"description": "List of attendee emails (strings)."
},
"eventType": {
"enum": [
"birthday",
"default",
"focusTime",
"outOfOffice",
"workingLocation"
],
"type": "string",
"title": "Event Type",
"default": "default",
"description": "Type of the event, immutable post-creation. 'workingLocation' (REQUIRES Google Workspace Enterprise). Note: 'fromGmail' events cannot be created via API."
},
"recurrence": {
"type": "array",
"items": {
"type": "string",
"properties": {}
},
"title": "Recurrence",
"default": null,
"nullable": true,
"description": "List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. Provide an empty list to remove recurrence so the event becomes non-recurring."
},
"visibility": {
"enum": [
"default",
"public",
"private",
"confidential"
],
"type": "string",
"title": "Visibility",
"default": "default",
"description": "Event visibility: 'default', 'public', 'private', or 'confidential'."
},
"calendar_id": {
"type": "string",
"title": "Calendar Id",
"default": "primary",
"examples": [
"primary",
"[email protected]",
"[email protected]"
],
"description": "Target calendar: 'primary' for the user's main calendar, or the calendar's email address. Must be provided in snake_case format."
},
"description": {
"type": "string",
"title": "Description",
"default": null,
"nullable": true,
"description": "Description of the event. Can contain HTML. Optional. Must be omitted for 'birthday' event type."
},
"send_updates": {
"type": "boolean",
"title": "Send Updates",
"default": null,
"nullable": true,
"description": "Defaults to True. Whether to send updates to the attendees."
},
"transparency": {
"enum": [
"opaque",
"transparent"
],
"type": "string",
"title": "Transparency",
"default": "opaque",
"description": "'opaque' (busy) or 'transparent' (available)."
},
"start_datetime": {
"type": "string",
"title": "Start Datetime",
"description": "Event start time in format YYYY-MM-DDTHH:MM:SS (no fractional seconds, no 'Z', no timezone offsets). Examples: '2025-01-16T13:00:00' or '2025-01-16T13:00'. Timezone info (Z, +, -) will be automatically stripped if provided."
},
"exclude_organizer": {
"type": "boolean",
"title": "Exclude Organizer",
"default": false,
"description": "If True, the organizer will NOT be added as an attendee. Default is False (organizer is included)."
},
"guests_can_modify": {
"type": "boolean",
"title": "Guests Can Modify",
"default": false,
"description": "If True, guests can modify the event."
},
"birthdayProperties": {
"type": "object",
"title": "BirthdayProperties",
"default": null,
"nullable": true,
"properties": {
"type": {
"enum": [
"birthday",
"anniversary",
"other"
],
"type": "string",
"title": "BirthdayType",
"default": null,
"nullable": true,
"description": "Type of birthday event: 'birthday', 'anniversary', or 'other'. Default 'birthday' works without contact field."
},
"contact": {
"type": "string",
"title": "Contact",
"default": null,
"nullable": true,
"description": "Contact ID in format 'people/c12345' from Google People API. REQUIRED when type is not 'birthday'."
},
"customTypeName": {
"type": "string",
"title": "Custom Type Name",
"default": null,
"nullable": true,
"description": "Custom type name when type is 'other'. Requires valid contact field."
}
},
"description": "Properties for birthday events.",
"additionalProperties": false
},
"create_meeting_room": {
"type": "boolean",
"title": "Create Meeting Room",
"default": null,
"nullable": true,
"description": "If true, a Google Meet link is created and added to the event. CRITICAL: As of 2024, this REQUIRES a paid Google Workspace account ($13+/month). Personal Gmail accounts will fail with 'Invalid conference type value' error. Solutions: 1) Upgrade to Workspace, 2) Use domain-wide delegation with Workspace user, 3) Use the new Google Meet REST API, or 4) Create events without conferences. See https://github.com/googleapis/google-api-nodejs-client/issues/3234"
},
"event_duration_hour": {
"type": "integer",
"title": "Event Duration Hour",
"default": 0,
"maximum": 24,
"minimum": 0,
"description": "Number of hours (0-24). Increase by 1 here rather than passing 60 in `event_duration_minutes`"
},
"focusTimeProperties": {
"type": "object",
"title": "FocusTimeProperties",
"default": null,
"nullable": true,
"properties": {
"chatStatus": {
"enum": [
"active",
"doNotDisturb"
],
"type": "string",
"title": "ChatStatus",
"default": null,
"nullable": true,
"description": "Chat status during focus time: 'active' or 'doNotDisturb'."
},
"declineMessage": {
"type": "string",
"title": "Decline Message",
"default": null,
"nullable": true,
"description": "Message to include in declined meeting invitations. Only used when autoDeclineMode is set."
},
"autoDeclineMode": {
"enum": [
"declineNone",
"declineAllConflictingInvitations",
"declineOnlyNewConflictingInvitations"
],
"type": "string",
"title": "AutoDeclineMode",
"default": null,
"nullable": true,
"description": "Auto decline mode: 'declineNone' (no invitations declined), 'declineAllConflictingInvitations' (all conflicting invitations declined), or 'declineOnlyNewConflictingInvitations' (only new conflicting invitations declined)."
}
},
"description": "Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.",
"additionalProperties": false
},
"guestsCanInviteOthers": {
"type": "boolean",
"title": "Guests Can Invite Others",
"default": null,
"nullable": true,
"description": "Whether attendees other than the organizer can invite others to the event."
},
"outOfOfficeProperties": {
"type": "object",
"title": "OutOfOfficeProperties",
"default": null,
"nullable": true,
"properties": {
"declineMessage": {
"type": "string",
"title": "Decline Message",
"default": null,
"nullable": true,
"description": "Message to include in declined meeting invitations. Only used when autoDeclineMode is set."
},
"autoDeclineMode": {
"enum": [
"declineNone",
"declineAllConflictingInvitations",
"declineOnlyNewConflictingInvitations"
],
"type": "string",
"title": "AutoDeclineMode",
"default": null,
"nullable": true,
"description": "Auto decline mode: 'declineNone' (no invitations declined), 'declineAllConflictingInvitations' (all conflicting invitations declined), or 'declineOnlyNewConflictingInvitations' (only new conflicting invitations declined)."
}
},
"description": "Properties for outOfOffice events.",
"additionalProperties": false
},
"event_duration_minutes": {
"type": "integer",
"title": "Event Duration Minutes",
"default": 30,
"maximum": 59,
"minimum": 0,
"description": "Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0."
},
"guestsCanSeeOtherGuests": {
"type": "boolean",
"title": "Guests Can See Other Guests",
"default": null,
"nullable": true,
"description": "Whether attendees other than the organizer can see who the event's attendees are."
},
"workingLocationProperties": {
"type": "object",
"title": "WorkingLocationProperties",
"default": null,
"nullable": true,
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"homeOffice",
"officeLocation",
"customLocation"
],
"type": "string",
"title": "Type",
"description": "Type of working location ('homeOffice' | 'officeLocation' | 'customLocation')."
},
"homeOffice": {
"type": "object",
"title": "WorkingLocationHomeOffice",
"default": null,
"nullable": true,
"properties": {},
"description": "Empty object marker for home office working location.\n\nThis is used to indicate the user is working from home.\nGoogle Calendar API accepts an empty object for this field.",
"additionalProperties": false
},
"customLocation": {
"type": "object",
"title": "WorkingLocationCustom",
"default": null,
"nullable": true,
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"title": "Label",
"description": "Label for a custom working location (e.g., 'Client site')."
}
},
"description": "Custom working location with a display label.",
"additionalProperties": false
},
"officeLocation": {
"type": "object",
"title": "WorkingLocationOffice",
"default": null,
"nullable": true,
"properties": {
"label": {
"type": "string",
"title": "Label",
"default": null,
"nullable": true,
"description": "Office name displayed in Calendar clients (e.g., building name)."
},
"deskId": {
"type": "string",
"title": "Desk Id",
"default": null,
"nullable": true,
"description": "Optional desk identifier."
},
"floorId": {
"type": "string",
"title": "Floor Id",
"default": null,
"nullable": true,
"description": "Optional floor identifier."
},
"buildingId": {
"type": "string",
"title": "Building Id",
"default": null,
"nullable": true,
"description": "Optional building identifier from org Resources."
},
"floorSectionId": {
"type": "string",
"title": "Floor Section Id",
"default": null,
"nullable": true,
"description": "Optional floor section identifier."
}
},
"description": "Office-based working location details.",
"additionalProperties": false
}
},
"description": "Properties for workingLocation events. REQUIRES Google Workspace Enterprise.\n\nConstraints discovered from testing:\n- Must set transparency='transparent' and visibility='public'\n- Description must be omitted\n- Depending on 'type', include one of 'homeOffice', 'officeLocation', or 'customLocation'",
"additionalProperties": false
}
}
}