MCP Tools Reference: calendarmcp.googleapis.com

ابزار: list_calendars

تقویم‌هایی را که این کاربر به آنها دسترسی دارد (لیست تقویم‌هایش) برمی‌گرداند. از این ابزار برای تبدیل داده‌های شناسایی تقویم (مثلاً «تقویم خانوادگی من») به calendar_id (شناسه ایمیل) مربوطه استفاده کنید.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار list_calendars MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست لیست تقویم‌ها

نمایش JSON 
{

  "pageSize": integer

  "pageToken": string
}
فیلدها

فیلد یونیون _page_size .

_page_size می‌تواند فقط یکی از موارد زیر باشد:

pageSize

integer

اختیاری. حداکثر تعداد نتایج در هر صفحه. پیش‌فرض 100 ، حداکثر 250 .

فیلد یونیون _page_token .

_page_token فقط می‌تواند یکی از موارد زیر باشد:

pageToken

string

اختیاری. توکنی که مشخص می‌کند کدام صفحه نتیجه برگردانده شود.

طرحواره خروجی

پاسخ‌های ListCalendars

نمایش JSON 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
فیلدها
calendars[]

object ( CalendarListItem )

فهرست تقویم‌ها.

فیلد مشترک _next_page_token .

_next_page_token فقط می‌تواند یکی از موارد زیر باشد:

nextPageToken

string

نشانه صفحه بعدی. اگر صفحه بعدی وجود نداشته باشد، حذف می‌شود.

تقویملیستآیتم

نمایش JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
فیلدها
id

string

شناسه. آدرس ایمیل تقویم.

summary

string

فقط خروجی. عنوان.

description

string

فقط خروجی. توضیحات.

timeZone

string

فقط خروجی. منطقه زمانی.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌