MCP Reference
calendar_event_reminders_set
Set Calendar Event Alerts
Beschreibung
Change only the personal alerts on this calendar's event copy, including an external Google invitation whose title and times cannot be edited. Requires calendar write access and the current event version. Changes this occurrence only; organizer fields and other guests' alerts stay unchanged. Up to five popup alerts, or Google email alerts; useDefault true uses Google calendar defaults, false with overrides [] removes alerts.
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 | |
event_id |
string | Ja | |
expected_version |
integer | Ja | |
reminders |
object | Ja |
Eingabeschema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"account_id": {
"type": "string"
},
"calendar_id": {
"type": "string"
},
"event_id": {
"type": "string"
},
"expected_version": {
"type": "integer",
"minimum": 0
},
"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"
]
}
}
}
}
},
"required": [
"account_id",
"calendar_id",
"event_id",
"expected_version",
"reminders"
],
"type": "object"
}
Ausgabeschema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"event": {
"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"
]
}
},
"required": [
"event"
],
"type": "object"
}