MCP Tools Reference: calendarmcp.googleapis.com

Herramienta: list_calendars

Devuelve los calendarios a los que tiene acceso este usuario (su lista de calendarios). Usa esta herramienta para resolver los datos de identificación del calendario (por ejemplo, "mi calendario familiar") en su calendar_id correspondiente (identificador de correo electrónico).

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_calendars.

Solicitud de Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_calendars",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

ListCalendarsRequest

Representación JSON 
{

  "pageSize": integer

  "pageToken": string
}
Campos

Campo de unión _page_size.

_page_size puede ser una de las siguientes opciones:
pageSize

integer

Opcional. Es la cantidad máxima de resultados por página. El valor predeterminado es 100 y el valor máximo es 250.

Campo de unión _page_token.

_page_token puede ser una de las siguientes opciones:
pageToken

string

Opcional. Es un token que especifica qué página de resultados se debe devolver.

Esquema de salida

ListCalendarsResponse

Representación JSON 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Campos
calendars[]

object (CalendarListItem)

Es la lista de calendarios.

Campo de unión _next_page_token.

_next_page_token puede ser una de las siguientes opciones:
nextPageToken

string

Token de página siguiente Se omite si no existe una página siguiente.

CalendarListItem

Representación JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Campos
id

string

Es el identificador. Dirección de correo electrónico del calendario.
summary

string

Solo salida. Título.
description

string

Solo salida. Descripción.
timeZone

string

Solo salida. Zona horaria.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.calendarlist
  • https://www.googleapis.com/auth/calendar.calendarlist.readonly