Cal.com MCP

MCP सर्वर

एआई क्लाइंट को 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 ट्रांसपोर्ट का उपयोग कर सकते हैं। यह विकास के लिए या जब आप सर्वर पर पूर्ण नियंत्रण चाहते हैं तब उपयोगी है।

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

• Node.js >= 18
• एक Cal.com API कुंजी — सेटिंग्स → डेवलपर → API कुंजियाँ में एक जनरेट करें

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

अपने 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_type	ID द्वारा एक विशिष्ट इवेंट प्रकार प्राप्त करें
create_event_type	एक नया इवेंट प्रकार बनाएँ
update_event_type	एक इवेंट प्रकार अपडेट करें
delete_event_type	एक इवेंट प्रकार हटाएँ

बुकिंग

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

शेड्यूल

उपकरण	विवरण
get_schedules	सभी शेड्यूल सूचीबद्ध करें
get_schedule	ID द्वारा एक विशिष्ट शेड्यूल प्राप्त करें
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 बजे के लिए पुनर्निर्धारित करें"
• "मेरे पास कौन से इवेंट प्रकार हैं?"

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

• एआई एजेंट गाइड — सीधे Cal.com API का उपयोग करके एआई एजेंट बनाएँ
• API v2 संदर्भ — पूर्ण API एंडपॉइंट दस्तावेज़ीकरण
• GitHub रिपॉजिटरी — स्रोत कोड