MCP Tools Reference: calendarmcp.googleapis.com

Strumento: list_calendars

Restituisce i calendari a cui ha accesso questo utente (il suo elenco di calendari). Utilizza questo strumento per risolvere i dati identificativi del calendario (ad esempio "il mio calendario della famiglia") nel relativo calendar_id (identificatore email)

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_calendars.

Richiesta 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
}'

Schema di input

ListCalendarsRequest

Rappresentazione JSON 
{

  "pageSize": integer

  "pageToken": string
}
Campi

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Facoltativo. Numero massimo di risultati per pagina. Valore predefinito 100, massimo 250.

Campo unione _page_token.

_page_token può essere solo uno dei seguenti tipi:
pageToken

string

Facoltativo. Token che specifica quale pagina dei risultati restituire.

Schema di output

ListCalendarsResponse

Rappresentazione JSON 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Campi
calendars[]

object (CalendarListItem)

Elenco dei calendari.

Campo unione _next_page_token.

_next_page_token può essere solo uno dei seguenti tipi:
nextPageToken

string

Token di pagina successiva. Omesso se non esiste una pagina successiva.

CalendarListItem

Rappresentazione JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Campi
id

string

Identificatore. Indirizzo email del calendario.
summary

string

Solo output. Titolo.
description

string

Solo output. Descrizione.
timeZone

string

Solo output. Fuso orario.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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