MCP Reference: calendarmcp.googleapis.com

Liệt kê các sự kiện trên lịch trong một lịch nhất định đáp ứng các điều kiện đã cho.

Các tính năng chính:

• Bất kỳ mã lịch nào, có thể là lịch chính của người dùng hoặc các lịch khác.
• So khớp từ khoá.
• Lọc theo phạm vi thời gian.
• Truy xuất TẤT CẢ các sự kiện phù hợp với các ràng buộc về thời gian và từ khoá.

Hãy sử dụng công cụ search_events nếu:

• Bạn cần tìm các sự kiện phù hợp nhất (K sự kiện hàng đầu) thay vì tất cả các sự kiện đáp ứng các ràng buộc.
• Bạn cần các chức năng tìm kiếm ngữ nghĩa.
• Bạn chỉ tìm kiếm thông tin cụ thể trong lịch chính của người dùng.

Sử dụng công cụ này cho các truy vấn như:

• Ngày mai lịch của tôi có gì?
• Lịch của tôi vào ngày 14 tháng 7 năm 2025 có gì?
• Tuần tới tôi có những cuộc họp nào?
• Chiều nay tôi có cuộc họp nào trùng lịch không?

Ví dụ:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.

Trả về một sự kiện duy nhất từ một lịch nhất định.

Sử dụng công cụ này cho các truy vấn như:

• Xem thông tin chi tiết về cuộc họp nhóm.
• Hiển thị sự kiện có mã event123 trên lịch của tôi.

Ví dụ:

get_event(
    event_id='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.

Trả về các lịch trong danh sách lịch của người dùng.

Sử dụng công cụ này cho các truy vấn như:

• Tất cả các lịch của tôi là gì?

Ví dụ:

list_calendars()
# Returns all calendars the authenticated user has access to.

Đề xuất các khoảng thời gian trên một hoặc nhiều lịch. Để truy cập vào lịch chính, hãy thêm "primary" vào trường attendee_emails.

Sử dụng công cụ này cho các truy vấn như:

• Khi nào tất cả chúng ta đều rảnh để họp?
• Tìm một khung giờ 30 phút mà cả hai chúng ta đều rảnh.
• Kiểm tra xem jane.doe@google.com có rảnh vào sáng thứ Hai hay không.

Ví dụ:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

Tạo sự kiện trên lịch.

Sử dụng công cụ này cho các truy vấn như:

• Tạo một sự kiện trên lịch của tôi vào ngày mai lúc 2 giờ chiều có tên là "Cuộc họp với Jane".
• Lên lịch cuộc họp với john.doe@google.com vào thứ Hai tới từ 10 giờ sáng đến 11 giờ sáng.

Ví dụ:

create_event(
    summary='Meeting with Jane',
    start_time='2024-09-17T14:00:00',
    end_time='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.

Cập nhật sự kiện trên lịch.

Sử dụng công cụ này cho các truy vấn như:

• Cập nhật sự kiện "Cuộc họp với Jane" để diễn ra muộn hơn một giờ.
• Thêm john.doe@google.com vào cuộc họp ngày mai.

Ví dụ:

update_event(
    event_id='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.

Xoá sự kiện trên lịch.

Sử dụng công cụ này cho các truy vấn như:

• Xoá sự kiện có mã event123 trên lịch của tôi.

Để huỷ hoặc từ chối một sự kiện, hãy sử dụng công cụ respond_to_event.

Ví dụ:

delete_event(
    event_id='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.

Phản hồi một sự kiện.

Sử dụng công cụ này cho các truy vấn như:

• Chấp nhận sự kiện có mã event123 trên lịch của tôi.
• Từ chối cuộc họp với Jane.
• Huỷ cuộc họp tiếp theo của tôi.
• Tạm thời chấp nhận cuộc họp lập kế hoạch.

Ví dụ:

respond_to_event(
    event_id='event123',
    response_status='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.