MCP Tools Reference: calendarmcp.googleapis.com

כלי: list_calendars

מחזירה את היומנים שלמשתמש הזה יש גישה אליהם (רשימת היומנים שלו). אפשר להשתמש בכלי הזה כדי לזהות נתונים ביומן (לדוגמה, 'היומן המשפחתי שלי') ולמצוא את calendar_id (מזהה האימייל) שמתאים להם.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ list_calendars.

בקשת Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--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
}'

סכימת הקלט

ListCalendarsRequest

ייצוג JSON 
{

  "pageSize": integer

  "pageToken": string
}
שדות

שדה איחוד _page_size.

הערך _page_size יכול להיות רק אחד מהבאים:
pageSize

integer

אופציונלי. מספר התוצאות המקסימלי בכל דף. ברירת מחדל 100, מקסימום 250.

שדה איחוד _page_token.

הערך _page_token יכול להיות רק אחד מהבאים:
pageToken

string

אופציונלי. אסימון שמציין איזה דף תוצאות להציג.

סכימת הפלט

ListCalendarsResponse

ייצוג JSON 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
שדות
calendars[]

object (CalendarListItem)

רשימת היומנים.

שדה איחוד _next_page_token.

הערך _next_page_token יכול להיות רק אחד מהבאים:
nextPageToken

string

טוקן של הדף הבא. השדה מושמט אם לא קיים דף הבא.

CalendarListItem

ייצוג JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
שדות
id

string

מזהה. כתובת האימייל של היומן.
summary

string

פלט בלבד. שם.
description

string

פלט בלבד. תיאור.
timeZone

string

פלט בלבד. אזור זמן.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌