MCP Tools Reference: calendarmcp.googleapis.com

Alat: list_calendars

Menampilkan kalender yang dapat diakses pengguna ini (daftar kalendernya). Gunakan alat ini untuk menyelesaikan data identifikasi kalender (misalnya, 'kalender keluarga saya') ke calendar_id yang sesuai (pengenal email)

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_calendars.

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

Skema Input

ListCalendarsRequest

Representasi JSON 
{

  "pageSize": integer

  "pageToken": string
}
Kolom

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari berikut:
pageSize

integer

Opsional. Hasil maksimum per halaman. Default 100, maks. 250.

Kolom union _page_token.

_page_token hanya dapat berupa salah satu dari berikut:
pageToken

string

Opsional. Token yang menentukan halaman hasil yang akan ditampilkan.

Skema Output

ListCalendarsResponse

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

  "nextPageToken": string
}
Kolom
calendars[]

object (CalendarListItem)

Daftar kalender.

Kolom union _next_page_token.

_next_page_token hanya dapat berupa salah satu dari berikut:
nextPageToken

string

Token halaman berikutnya. Dihilangkan jika tidak ada halaman berikutnya.

CalendarListItem

Representasi JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Kolom
id

string

Pengenal. Alamat email kalender.
summary

string

Hanya output. Judul.
description

string

Hanya output. Deskripsi.
timeZone

string

Hanya output. Zona waktu.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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