Cal.com MCP

आधिकारिक

MCP सर्वर पर या स्थानीय इंस्टेंस पर होस्ट किए गए सर्वर का उपयोग करके मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से AI क्लाइंट को Cal.com शेड्यूलिंग से कनेक्ट करें।

cal.com पर देखें

Cal Com MCP के साथ आप क्या कर सकते हैं?

  • अपने आगामी बुकिंग की जाँच करें — get_bookings का उपयोग करके दिनांक सीमा या स्थिति जैसे फ़िल्टर के साथ अपनी बुकिंग की सूची माँगें।
  • ईवेंट प्रकार बनाएँ और प्रबंधित करें — create_event_type और संबंधित टूल के माध्यम से "Quick Chat" जैसे ईवेंट प्रकार बनाएँ, अपडेट करें या हटाएँ।
  • मीटिंग को पुनर्निर्धारित या रद्द करें — reschedule_booking के साथ बुकिंग को नए समय पर पुनर्निर्धारित करें या cancel_booking के साथ इसे पूरी तरह से रद्द करें।
  • उपलब्ध समय स्लॉट खोजें — शेड्यूलिंग से पहले get_availability का उपयोग करके किसी दिए गए दिनांक सीमा के लिए खुले स्लॉट प्राप्त करें।
  • अपने शेड्यूल प्रबंधित करें — get_schedules और create_schedule के साथ अपनी उपलब्धता शेड्यूल देखें, बनाएँ या संशोधित करें।
  • बुकिंग प्रतिभागियों को संभालें — get_booking_attendees के साथ किसी बुकिंग के सभी प्रतिभागियों को देखें या add_booking_attendee के साथ नए जोड़ें।

दस्तावेज़

MCP सर्वर

AI क्लाइंट को mcp.cal.com पर होस्टेड सर्वर या स्थानीय इंस्टेंस का उपयोग करके मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से Cal.com शेड्यूलिंग से कनेक्ट करें।

Cal.com MCP सर्वर Cal.com API v2 को मॉडल कॉन्टेक्स्ट प्रोटोकॉल में रैप करता है, जिससे आप किसी भी MCP-संगत क्लाइंट में प्राकृतिक भाषा के माध्यम से बुकिंग, इवेंट प्रकार, शेड्यूल और बहुत कुछ प्रबंधित कर सकते हैं।

होस्टेड सर्वर (mcp.cal.com)

आरंभ करने का सबसे तेज़ तरीका अपने MCP क्लाइंट को सीधे mcp.cal.com से कनेक्ट करना है। होस्टेड सर्वर OAuth 2.1 प्रमाणीकरण के साथ स्ट्रीमेबल HTTP ट्रांसपोर्ट का उपयोग करता है — आपका क्लाइंट प्राधिकरण प्रवाह को स्वचालित रूप से संभालता है।

अपने क्लाइंट को कनेक्ट करें

अपने MCP क्लाइंट को होस्टेड सर्वर URL पर पॉइंट करें:

https://mcp.cal.com/mcp

जब आप पहली बार कनेक्ट करते हैं, तो आपका क्लाइंट आपको OAuth प्राधिकरण प्रवाह के माध्यम से ले जाता है जहाँ आप सर्वर को अपने Cal.com खाते तक पहुँच प्रदान करते हैं। किसी API कुंजी की आवश्यकता नहीं है।

अपने `claude_desktop_config.json` में निम्नलिखित जोड़ें: 
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
**सेटिंग्स → MCP** खोलें और URL `https://mcp.cal.com/mcp` के साथ एक नया सर्वर जोड़ें, या इसे अपने `.cursor/mcp.json` में जोड़ें: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
अपनी VS Code MCP सेटिंग्स में सर्वर जोड़ें: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

स्व-होस्टेड सर्वर (stdio)

यदि आप सर्वर को स्थानीय रूप से चलाना पसंद करते हैं, तो आप API कुंजी के साथ stdio ट्रांसपोर्ट का उपयोग कर सकते हैं। यह विकास के लिए या जब आप सर्वर पर पूर्ण नियंत्रण चाहते हैं तब उपयोगी है।

पूर्वापेक्षाएँ

अपने क्लाइंट को कनेक्ट करें

अपने MCP क्लाइंट के कॉन्फ़िगरेशन में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["@calcom/cal-mcp@latest"],
      "env": {
        "CAL_API_KEY": "cal_live_xxxx"
      }
    }
  }
}

cal_live_xxxx को अपनी वास्तविक API कुंजी से बदलें।

अपनी API कुंजी कभी साझा या कमिट न करें। यदि उजागर हो जाए, तो इसे तुरंत अपनी [Cal.com सेटिंग्स](https://app.cal.com/settings/developer/api-keys) में घुमाएँ।

उपलब्ध उपकरण

MCP सर्वर श्रेणी के अनुसार व्यवस्थित 34 उपकरण प्रस्तुत करता है:

उपयोगकर्ता प्रोफ़ाइल

उपकरणविवरण
get_meअपनी प्रमाणित उपयोगकर्ता प्रोफ़ाइल प्राप्त करें
update_meअपनी उपयोगकर्ता प्रोफ़ाइल अपडेट करें

इवेंट प्रकार

उपकरणविवरण
get_event_typesसभी इवेंट प्रकार सूचीबद्ध करें
get_event_typeID द्वारा एक विशिष्ट इवेंट प्रकार प्राप्त करें
create_event_typeएक नया इवेंट प्रकार बनाएँ
update_event_typeएक इवेंट प्रकार अपडेट करें
delete_event_typeएक इवेंट प्रकार हटाएँ

बुकिंग

उपकरणविवरण
get_bookingsवैकल्पिक फ़िल्टर के साथ बुकिंग सूचीबद्ध करें
get_bookingUID द्वारा एक विशिष्ट बुकिंग प्राप्त करें
create_bookingएक नई बुकिंग बनाएँ
reschedule_bookingएक बुकिंग पुनर्निर्धारित करें
cancel_bookingएक बुकिंग रद्द करें
confirm_bookingएक लंबित बुकिंग की पुष्टि करें
mark_booking_absentएक बुकिंग अनुपस्थिति चिह्नित करें
get_booking_attendeesएक बुकिंग के सभी उपस्थित लोग प्राप्त करें
add_booking_attendeeएक बुकिंग में एक उपस्थित व्यक्ति जोड़ें
get_booking_attendeeएक विशिष्ट उपस्थित व्यक्ति प्राप्त करें

शेड्यूल

उपकरणविवरण
get_schedulesसभी शेड्यूल सूचीबद्ध करें
get_scheduleID द्वारा एक विशिष्ट शेड्यूल प्राप्त करें
create_scheduleएक नया शेड्यूल बनाएँ
update_scheduleएक शेड्यूल अपडेट करें
delete_scheduleएक शेड्यूल हटाएँ
get_default_scheduleअपना डिफ़ॉल्ट शेड्यूल प्राप्त करें

उपलब्धता

उपकरणविवरण
get_availabilityउपलब्ध समय स्लॉट प्राप्त करें
get_busy_timesकैलेंडर से व्यस्त समय प्राप्त करें

कॉन्फ्रेंसिंग

उपकरणविवरण
get_conferencing_appsकॉन्फ्रेंसिंग अनुप्रयोग सूचीबद्ध करें

रूटिंग फ़ॉर्म

उपकरणविवरण
calculate_routing_form_slotsरूटिंग फ़ॉर्म प्रतिक्रिया के आधार पर स्लॉट की गणना करें

संगठन

उपकरणविवरण
get_org_membershipsसभी संगठन सदस्यताएँ प्राप्त करें
create_org_membershipएक संगठन सदस्यता बनाएँ
get_org_membershipएक संगठन सदस्यता प्राप्त करें
delete_org_membershipएक संगठन सदस्यता हटाएँ
get_org_routing_formsसंगठन रूटिंग फ़ॉर्म प्राप्त करें
get_org_routing_form_responsesरूटिंग फ़ॉर्म प्रतिक्रियाएँ प्राप्त करें

उदाहरण प्रॉम्प्ट

एक बार कनेक्ट होने पर, आप प्राकृतिक भाषा का उपयोग करके Cal.com के साथ इंटरैक्ट कर सकते हैं:

  • "इस सप्ताह मेरी क्या बुकिंग हैं?"
  • "'त्वरित चैट' नामक 30-मिनट का इवेंट प्रकार बनाएँ"
  • "कल जॉन के साथ मेरी मीटिंग रद्द करें"
  • "मुझे अगले सोमवार के लिए मेरे उपलब्ध स्लॉट दिखाएँ"
  • "मेरी दोपहर 2 बजे की मीटिंग को गुरुवार दोपहर 3 बजे के लिए पुनर्निर्धारित करें"
  • "मेरे पास कौन से इवेंट प्रकार हैं?"

संबंधित संसाधन