create_event

This reference is generated from the published tool contract.

Behavior and boundaries

Creates one standalone event without guests in a writable Google, Microsoft or CalDAV calendar. Bounded weekly series are supported only for Google and Microsoft; CalDAV series must be created in the calendar app. For a series provide recurrence with frequency weekly, count (2–104 total occurrences including the first), and optional interval (weeks, default 1); the last occurrence must be within 104 weeks. The series repeats on the weekday and local clock time of start in timeZone. start and end must be on the same local day for a series and must not cross or lie inside a local clock change. Confirm the requested repetition and total count with the user before creating a series; do not invent them. requestId identifies the entire series and must be reused unchanged on retries. start and end must include UTC offsets; timeZone must be IANA. This tool never sends invitations. Series and their occurrences cannot yet be edited or deleted through MCP; use the provider calendar for those operations.

Permissions

Granted scopes, accounts, calendars and visibility rules limit access. Workspace administrators do not automatically gain access to other users’ accounts.

calendar:read, calendar:write

Consent and boundaries

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "minLength": 1
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "recurrence": {
      "type": "object",
      "properties": {
        "frequency": {
          "type": "string",
          "const": "weekly"
        },
        "interval": {
          "type": "integer",
          "minimum": 1,
          "maximum": 104
        },
        "count": {
          "type": "integer",
          "minimum": 2,
          "maximum": 104
        }
      },
      "required": [
        "frequency",
        "count"
      ],
      "additionalProperties": false
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "description": {
      "type": "string",
      "maxLength": 10000
    },
    "location": {
      "type": "string",
      "maxLength": 1000
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "freeBusyStatus": {
      "type": "string",
      "enum": [
        "free",
        "busy"
      ]
    }
  },
  "required": [
    "calendarId",
    "requestId",
    "title",
    "start",
    "end",
    "timeZone"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "eventId": {
      "type": "string"
    },
    "idempotentReplay": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "idempotencyStatus": {
      "type": "string",
      "enum": [
        "created",
        "replayed",
        "provider_managed"
      ]
    }
  },
  "required": [
    "ok",
    "eventId",
    "idempotentReplay",
    "idempotencyStatus"
  ],
  "additionalProperties": false
}

Errors and retries

Check the tool result for errors. Do not blindly retry writes after a timeout. Check the calendar state first.

Error handling