MCP Tools Reference: calendarmcp.googleapis.com

Narzędzie: list_calendars

Zwraca kalendarze, do których ten użytkownik ma dostęp (jego lista kalendarzy). Użyj tego narzędzia, aby przekształcić dane identyfikujące kalendarz (np. „mój kalendarz rodzinny”) w odpowiedni calendar_id (identyfikator e-mail).

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie list_calendars MCP.

Żądanie 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
}'

Schemat danych wejściowych

ListCalendarsRequest

Zapis JSON 
{

  "pageSize": integer

  "pageToken": string
}
Pola

Pole zbiorcze _page_size.

Pole _page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Opcjonalnie. Maksymalna liczba wyników na stronie. Domyślna wartość to 100, a maksymalna to 250.

Pole zbiorcze _page_token.

Pole _page_token może mieć tylko jedną z tych wartości:
pageToken

string

Opcjonalnie. Token określający, którą stronę wyników należy zwrócić.

Schemat wyjściowy

ListCalendarsResponse

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

  "nextPageToken": string
}
Pola
calendars[]

object (CalendarListItem)

Lista kalendarzy.

Pole zbiorcze _next_page_token.

Pole _next_page_token może mieć tylko jedną z tych wartości:
nextPageToken

string

Token następnej strony. Pomijane, jeśli nie ma następnej strony.

CalendarListItem

Zapis JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Pola
id

string

Identyfikator. Adres e-mail kalendarza.
summary

string

Tylko dane wyjściowe. Tytuł.
description

string

Tylko dane wyjściowe. Opis.
timeZone

string

Tylko dane wyjściowe. Strefa czasowa.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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