MCP Tools Reference: calendarmcp.googleapis.com

Công cụ: list_calendars

Trả về những lịch mà người dùng này có quyền truy cập (danh sách lịch của họ). Sử dụng công cụ này để phân giải dữ liệu nhận dạng lịch (ví dụ: "lịch gia đình của tôi") thành calendar_id tương ứng (giá trị nhận dạng email)

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP list_calendars.

Yêu cầu 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
}'

Giản đồ đầu vào

ListCalendarsRequest

Biểu diễn dưới dạng JSON 
{

  "pageSize": integer

  "pageToken": string
}
Trường

Trường nhóm _page_size.

_page_size chỉ có thể là một trong những trạng thái sau:
pageSize

integer

Không bắt buộc. Số kết quả tối đa trên mỗi trang. Mặc định là 100, tối đa là 250.

Trường nhóm _page_token.

_page_token chỉ có thể là một trong những trạng thái sau:
pageToken

string

Không bắt buộc. Mã thông báo chỉ định trang kết quả cần trả về.

Giản đồ đầu ra

ListCalendarsResponse

Biểu diễn dưới dạng JSON 
{
  "calendars": [
    {
      object (CalendarListItem)
    }
  ],

  "nextPageToken": string
}
Trường
calendars[]

object (CalendarListItem)

Danh sách lịch.

Trường nhóm _next_page_token.

_next_page_token chỉ có thể là một trong những trạng thái sau:
nextPageToken

string

Mã thông báo trang tiếp theo. Bị bỏ qua nếu không có trang tiếp theo.

CalendarListItem

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "summary": string,
  "description": string,
  "timeZone": string
}
Trường
id

string

Giá trị nhận dạng. Địa chỉ email của lịch.
summary

string

Chỉ có đầu ra. Tiêu đề.
description

string

Chỉ có đầu ra. Nội dung mô tả.
timeZone

string

Chỉ có đầu ra. Múi giờ.

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • 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