Calendar create event

calendar__create_event

Access

Requires a project integration connection for calendar.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
calendarIdstringYesCalendar ID
summarystringYesEvent title
descriptionstringNoEvent description
startobjectYesEvent time: {dateTime: "YYYY-MM-DDTHH:mm:ss", timeZone: "IANA zone"} for local time. Explicit-offset timestamps retain provider semantics; use date for all-day events.
endobjectYesEvent time: {dateTime: "YYYY-MM-DDTHH:mm:ss", timeZone: "IANA zone"} for local time. Explicit-offset timestamps retain provider semantics; use date for all-day events.
attendeesvalue[]NoArray of {email: string} objects
locationstringNoEvent location

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calendar__create_event",
    "arguments": {
      "calendarId": "example",
      "summary": "example",
      "start": {},
      "end": {}
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the calendar integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "description": {
      "type": "string",
      "description": "Event description"
    },
    "start": {
      "type": "object",
      "description": "Event time: {dateTime: \"YYYY-MM-DDTHH:mm:ss\", timeZone: \"IANA zone\"} for local time. Explicit-offset timestamps retain provider semantics; use date for all-day events."
    },
    "end": {
      "type": "object",
      "description": "Event time: {dateTime: \"YYYY-MM-DDTHH:mm:ss\", timeZone: \"IANA zone\"} for local time. Explicit-offset timestamps retain provider semantics; use date for all-day events."
    },
    "attendees": {
      "type": "array",
      "description": "Array of {email: string} objects"
    },
    "location": {
      "type": "string",
      "description": "Event location"
    }
  },
  "required": [
    "calendarId",
    "summary",
    "start",
    "end"
  ],
  "description": "Arguments for the calendar__create_event tool."
}