MCP Reference: calendarmcp.googleapis.com

यह Google Calendar API की ओर से उपलब्ध कराया गया एमसीपी सर्वर है. यह सर्वर, डेवलपर को Calendar के ऊपर एलएलएम ऐप्लिकेशन बनाने के लिए टूल उपलब्ध कराता है.

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं देने वाली बाहरी सेवा के बीच प्रॉक्सी के तौर पर काम करता है. एमसीपी सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में बदलते हैं जिसे एआई ऐप्लिकेशन समझ सके.

सर्वर का सेटअप

इसका इस्तेमाल करने से पहले, आपको Calendar MCP सर्वर को कॉन्फ़िगर करना होगा. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.

सर्वर एंडपॉइंट

एमसीपी सेवा एंडपॉइंट, एमसीपी सर्वर का नेटवर्क पता और कम्यूनिकेशन इंटरफ़ेस (आम तौर पर एक यूआरएल) होता है. इसका इस्तेमाल, एआई ऐप्लिकेशन (एमसीपी क्लाइंट के लिए होस्ट) एक सुरक्षित और स्टैंडर्ड कनेक्शन बनाने के लिए करता है. यह एलएलएम के लिए संपर्क बिंदु है. इससे एलएलएम, कॉन्टेक्स्ट का अनुरोध कर सकता है, किसी टूल को कॉल कर सकता है या किसी संसाधन को ऐक्सेस कर सकता है. Google MCP के एंडपॉइंट, ग्लोबल या रीजनल हो सकते हैं.

Calendar API के एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:

  • https://calendarmcp.googleapis.com/mcp/v1

एमसीपी टूल

एमसीपी टूल एक फ़ंक्शन या एक्ज़ीक्यूटेबल क्षमता होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन के लिए उपलब्ध कराता है, ताकि वह असल दुनिया में कोई कार्रवाई कर सके.

टूल

calendarmcp.googleapis.com एमसीपी सर्वर में ये टूल मौजूद हैं:

एमसीपी टूल
list_events

यह फ़ंक्शन, किसी कैलेंडर में मौजूद उन इवेंट की सूची दिखाता है जो दी गई शर्तों को पूरा करते हैं.

मुख्य सुविधाएं:

  • कोई भी Calendar ID. यह उपयोगकर्ता का प्राइमरी कैलेंडर या कोई अन्य कैलेंडर हो सकता है.
  • कीवर्ड मैचिंग.
  • समयसीमा के हिसाब से फ़िल्टर करना.
  • यह समय और कीवर्ड की पाबंदियों से मेल खाने वाले सभी इवेंट को वापस लाता है.

अगर:

  • आपको सभी इवेंट के बजाय, सबसे ज़्यादा काम के (टॉप 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.
get_event

यह फ़ंक्शन, दिए गए कैलेंडर से एक इवेंट दिखाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • टीम मीटिंग की जानकारी पाना.
  • मुझे मेरे कैलेंडर में event123 आईडी वाला इवेंट दिखाओ.

उदाहरण:

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

इससे उपयोगकर्ता की कैलेंडर सूची में मौजूद कैलेंडर दिखते हैं.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • मेरे सभी कैलेंडर कौन-कौनसे हैं?

उदाहरण:

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

यह एक या एक से ज़्यादा कैलेंडर में समय अवधि का सुझाव देता है. मुख्य कैलेंडर को ऐक्सेस करने के लिए, attendee_emails फ़ील्ड में 'primary' जोड़ें.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • हम सभी मीटिंग के लिए कब उपलब्ध हैं?
  • हमें 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.
create_event

कैलेंडर इवेंट बनाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • मेरे कैलेंडर में कल दोपहर 2 बजे के लिए, 'जेन के साथ मीटिंग' नाम का एक इवेंट बनाओ.
  • अगले सोमवार को सुबह 10 बजे से 11 बजे तक, john.doe@google.com के साथ मीटिंग शेड्यूल करो.

उदाहरण:

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

यह फ़ंक्शन, कैलेंडर इवेंट को अपडेट करता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • 'जेन के साथ मीटिंग' इवेंट को एक घंटे बाद के लिए अपडेट करो.
  • 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'.
delete_event

यह कैलेंडर इवेंट को मिटाता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • मेरे कैलेंडर से event123 आईडी वाला इवेंट मिटाओ.

किसी इवेंट को रद्द करने या अस्वीकार करने के लिए, respond_to_event टूल का इस्तेमाल करें.

उदाहरण:

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

किसी इवेंट का जवाब देता है.

इस टूल का इस्तेमाल, इस तरह की क्वेरी के लिए करें:

  • मेरे कैलेंडर में event123 आईडी वाले इवेंट को स्वीकार करो.
  • जेन के साथ होने वाली मीटिंग को अस्वीकार करो.
  • मेरी अगली मीटिंग रद्द करो.
  • प्लानिंग मीटिंग के न्योते को अभी के लिए स्वीकार करें.

उदाहरण:

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

एमसीपी टूल की खास जानकारी पाना

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, tools/list तरीके का इस्तेमाल करें. इस उदाहरण में, curl का इस्तेमाल करके, MCP सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास बातों की सूची बनाने का तरीका बताया गया है.

Curl अनुरोध 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'