Calendar find free time

calendar__find_free_time

Access

Requires a project integration connection for calendar.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
timeMinstringNoExact RFC3339 instant start. For local times use localFrom/localTo and timeZone instead.
timeMaxstringNoExact RFC3339 instant end. Do not combine with localFrom/localTo.
itemsvalue[]YesArray of {id: calendarId} to check
localFromstringNoLocal window start, inclusive (YYYY-MM-DDTHH:mm:ss). Use with localTo and timeZone for local-time availability.
localTostringNoLocal window end, exclusive (YYYY-MM-DDTHH:mm:ss).
timeZonestringNoIANA timezone for local bounds and returned busy intervals, e.g. Europe/Berlin.

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__find_free_time",
    "arguments": {
      "items": []
    }
  }
}

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": {
    "timeMin": {
      "type": "string",
      "description": "Exact RFC3339 instant start. For local times use localFrom/localTo and timeZone instead."
    },
    "timeMax": {
      "type": "string",
      "description": "Exact RFC3339 instant end. Do not combine with localFrom/localTo."
    },
    "items": {
      "type": "array",
      "description": "Array of {id: calendarId} to check"
    },
    "localFrom": {
      "type": "string",
      "description": "Local window start, inclusive (YYYY-MM-DDTHH:mm:ss). Use with localTo and timeZone for local-time availability."
    },
    "localTo": {
      "type": "string",
      "description": "Local window end, exclusive (YYYY-MM-DDTHH:mm:ss)."
    },
    "timeZone": {
      "type": "string",
      "description": "IANA timezone for local bounds and returned busy intervals, e.g. Europe/Berlin."
    }
  },
  "required": [
    "items"
  ],
  "description": "Arguments for the calendar__find_free_time tool."
}