MCP Reference: calendarmcp.googleapis.com

แสดงรายการกิจกรรมในปฏิทินในปฏิทินที่ระบุซึ่งตรงตามเงื่อนไขที่กำหนด

ฟีเจอร์หลัก

• รหัสปฏิทิน ซึ่งอาจเป็นปฏิทินหลักของผู้ใช้หรือปฏิทินอื่นๆ
• การกรองช่วงเวลา
• ดึงข้อมูลกิจกรรมทั้งหมดที่ตรงตามข้อจำกัดด้านเวลา

หากมี ให้ใช้เครื่องมือ search_events แทนสำหรับการค้นหาในปฏิทินหลักของผู้ใช้ในกรณีต่อไปนี้

• คุณกำลังค้นหากิจกรรมที่ตรงกับหัวข้อ หมวดหมู่ หรือความตั้งใจที่เฉพาะเจาะจง (เช่น "การประชุมอาหารกลางวัน" "การซิงค์โปรเจ็กต์")
• คุณต้องการค้นหากิจกรรมที่เกี่ยวข้องมากที่สุด (K อันดับแรก) แทนที่จะเป็นกิจกรรมทั้งหมดที่ตรงตามข้อจำกัด
• คุณต้องการความสามารถในการค้นหาคีย์เวิร์ดหรือการค้นหาเชิงความหมาย

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• พรุ่งนี้มีอะไรในปฏิทินของฉันบ้าง
• วันที่ 14 กรกฎาคม 2025 มีอะไรในปฏิทินของฉันบ้าง
• สัปดาห์หน้าฉันมีการประชุมอะไรบ้าง
• วันนี้ช่วงบ่ายฉันมีกิจกรรมชนกันบ้างไหม

• พรุ่งนี้วิชัยมีการประชุมอะไรบ้าง

ตัวอย่าง

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=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.

แสดงกิจกรรมเดียวจากปฏิทินที่ระบุ

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• ดูรายละเอียดการประชุมของทีม
• แสดงกิจกรรมที่มีรหัส event123 ในปฏิทินของฉัน

ตัวอย่าง

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

แสดงปฏิทินในรายการปฏิทินของผู้ใช้

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• ปฏิทินทั้งหมดของฉันมีอะไรบ้าง

ตัวอย่าง

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

แนะนำช่วงเวลาในปฏิทินอย่างน้อย 1 รายการ หากต้องการเข้าถึงปฏิทินหลัก ให้เพิ่ม "primary" ในช่อง attendee_emails

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• พวกเราทุกคนว่างตรงกันเมื่อไหร่บ้างสำหรับการประชุม
• หาช่วงเวลา 30 นาทีที่ฉันและคุณว่างตรงกัน
• ตรวจสอบว่า jane.doe@google.com ว่างไหมในเช้าวันจันทร์

ตัวอย่าง

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': 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.

สร้างกิจกรรมในปฏิทิน

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• สร้างกิจกรรมในปฏิทินของฉันสำหรับพรุ่งนี้เวลา 14.00 น. ชื่อ "การประชุมกับเจน"
• กำหนดเวลาการประชุมกับ john.doe@google.com ในวันจันทร์หน้าตั้งแต่เวลา 10.00 น. ถึง 11.00 น.

ตัวอย่าง

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

อัปเดตกิจกรรมในปฏิทิน

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• อัปเดตกิจกรรม "การประชุมกับเจน" ให้เลื่อนไป 1 ชั่วโมง
• เพิ่ม john.doe@google.com ในการประชุมพรุ่งนี้

ตัวอย่าง

update_event(
    eventId='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'.

ลบกิจกรรมในปฏิทิน

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• ลบกิจกรรมที่มีรหัส event123 ในปฏิทินของฉัน

หากต้องการยกเลิกหรือปฏิเสธกิจกรรม ให้ใช้เครื่องมือ respond_to_event แทน

ตัวอย่าง

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

ตอบกลับกิจกรรม

ใช้เครื่องมือนี้สำหรับการค้นหาต่างๆ เช่น

• ยอมรับกิจกรรมที่มีรหัส event123 ในปฏิทินของฉัน
• ปฏิเสธการประชุมกับเจน
• ยกเลิกการประชุมครั้งถัดไป
• ยอมรับการประชุมวางแผนแบบชั่วคราว

ตัวอย่าง

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