Skip to main content
Glama

Send a new calendar invitation

create_event

Create a meeting and send calendar invitations to the attendees (all on allow_send_to); it appears in Outlook, Gmail and Apple Calendar.

Instructions

Create a meeting and send calendar invitations to the attendees (all on allow_send_to); it appears in Outlook, Gmail and Apple Calendar. Remember the returned id: to change or cancel the meeting use update_event or cancel_event, never create a second one. Times without offset are read in timezone or the mailbox time zone; for all-day events (holidays, absences) set all_day and give dates, and show_as free keeps calendars free; the invitation is reviewed and counts towards the send limit. Returns the event with id, UTC and local times.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
endNoEnd, same format as start and after it; for all_day the last day (inclusive, defaults to start)
startYesStart, e.g. 2026-10-05T14:00 (mailbox time zone) or with offset/Z; for all_day a date like 2026-10-05
titleYesMeeting title shown in calendars
all_dayNotrue: all-day event over whole days; start and end are dates. Default false
show_asNoHow the time shows in attendees' calendars: busy (default), free, tentative or oof (out of office)
locationNoPlace or meeting link
timezoneNoIANA zone for times without offset; defaults to the mailbox timezone
attendeesYesEmail addresses to invite; each must be on allow_send_to
description_markdownNoAgenda or notes in Markdown

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changedv0.5.0
    • addedInput schema / properties / all_day
      Added value: +{
      +  "description": "true: all-day event over whole days; start and end are dates. Default false",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / end / anyOf
      Added value: +[
      +  {
      +    "format": "date",
      +    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +    "type": "string"
      +  },
      +  {
      +    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / end / description
      Previous value: -"End, same format as start; must be after start"New value: +"End, same format as start and after it; for all_day the last day (inclusive, defaults to start)"
    • removedInput schema / properties / end / pattern
      Removed value: -"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$"
    • removedInput schema / properties / end / type
      Removed value: -"string"
    • addedInput schema / properties / show_as
      Added value: +{
      +  "description": "How the time shows in attendees' calendars: busy (default), free, tentative or oof (out of office)",
      +  "enum": [
      +    "busy",
      +    "free",
      +    "tentative",
      +    "oof"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / start / anyOf
      Added value: +[
      +  {
      +    "format": "date",
      +    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +    "type": "string"
      +  },
      +  {
      +    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / start / description
      Previous value: -"Start, e.g. 2026-10-05T14:00 (mailbox time zone) or with offset/Z"New value: +"Start, e.g. 2026-10-05T14:00 (mailbox time zone) or with offset/Z; for all_day a date like 2026-10-05"
    • removedInput schema / properties / start / pattern
      Removed value: -"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$"
    • removedInput schema / properties / start / type
      Removed value: -"string"
    • changedInput schema / required
      Previous value: -[
      -  "title",
      -  "start",
      -  "end",
      -  "attendees"
      -]New value: +[
      +  "title",
      +  "start",
      +  "attendees"
      +]
  2. Changed7 schema fields changedv0.3.2
    • addedInput schema / properties / attendees / description
      Added value: +"Email addresses to invite; each must be on allow_send_to"
    • addedInput schema / properties / description_markdown / description
      Added value: +"Agenda or notes in Markdown"
    • addedInput schema / properties / description_markdown / maxLength
      Added value: +512000
    • addedInput schema / properties / end / description
      Added value: +"End, same format as start; must be after start"
    • addedInput schema / properties / location / description
      Added value: +"Place or meeting link"
    • addedInput schema / properties / start / description
      Added value: +"Start, e.g. 2026-10-05T14:00 (mailbox time zone) or with offset/Z"
    • addedInput schema / properties / title / description
      Added value: +"Meeting title shown in calendars"
  3. First observedv0.1.0

TDQS

Score is being calculated.