MCP Tools Reference: calendarmcp.googleapis.com

الأداة: list_calendars

تعرض هذه الأداة التقاويم التي يمكن للمستخدم الوصول إليها (قائمة التقاويم). استخدِم هذه الأداة لحلّ بيانات تعريف التقويم (مثل "تقويم عائلتي") وتحويلها إلى calendar_id المقابل (معرّف البريد الإلكتروني)

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_calendars في MCP.

طلب 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

الناتج فقط المنطقة الزمنية

التعليقات التوضيحية للأداة

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات غير المدمّرة: ✅ | تلميح بشأن الإجراءات للقراءة فقط: ✅ | تلميح بشأن الإجراءات في العالم المفتوح: ❌