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.

تقترح فترات زمنية في تقويم واحد أو أكثر. للوصول إلى التقويم الأساسي، أضِف "أساسي" في حقل 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.

تنشئ حدثًا في التقويم.

استخدِم هذه الأداة لطلبات البحث مثل:

• أريد إنشاء حدث في تقويمي غدًا في الساعة 2 ظهرًا باسم "اجتماع مع Jane".
• أريد جدولة اجتماع مع john.doe@google.com يوم الاثنين القادم من الساعة 10 صباحًا حتى 11 صباحًا.

مثال:

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'.

تعدّل حدثًا في التقويم.

استخدِم هذه الأداة لطلبات البحث مثل:

• أريد تعديل الحدث "اجتماع مع Jane" ليكون بعد ساعة واحدة.
• أريد إضافة 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 في تقويمي.
• أريد رفض الاجتماع مع Jane.
• أريد إلغاء اجتماعي التالي.
• أريد قبول اجتماع التخطيط بشكل مبدئي.

مثال:

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