MCP Tools Reference: calendarmcp.googleapis.com

Araç: list_calendars

Bu kullanıcının erişebildiği takvimleri (takvim listesi) döndürür. Takvim tanımlama verilerini (ör. "aile takvimim") karşılık gelen calendar_id (e-posta tanımlayıcısı) ile eşleştirmek için bu aracı kullanın.

Aşağıdaki örnekte, list_calendars MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

ListCalendarsRequest

JSON gösterimi 
{

  "pageSize": integer

  "pageToken": string
}
Alanlar

_page_size birleşik alanı.

_page_size aşağıdakilerden yalnızca biri olabilir:
pageSize

integer

İsteğe bağlı. Sayfa başına maksimum sonuç sayısı. Varsayılan 100, maksimum 250.

_page_token birleşik alanı.

_page_token aşağıdakilerden yalnızca biri olabilir:
pageToken

string

İsteğe bağlı. Hangi sonuç sayfasının döndürüleceğini belirten jeton.

Çıkış Şeması

ListCalendarsResponse

JSON gösterimi 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Alanlar
calendars[]

object (CalendarListItem)

Takvim listesi.

_next_page_token birleşik alanı.

_next_page_token aşağıdakilerden yalnızca biri olabilir:
nextPageToken

string

Sonraki sayfa jetonu. Sonraki sayfa yoksa atlanır.

CalendarListItem

JSON gösterimi 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Alanlar
id

string

Tanımlayıcı. Takvimin e-posta adresi.
summary

string

Yalnızca çıkış. Başlık.
description

string

Yalnızca çıkış. Açıklama.
timeZone

string

Yalnızca çıkış. Saat dilimi.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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