Cal.com MCP

MCP सर्वर

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

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

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

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

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

अपने 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"
    }
  }
}
```

**Settings → 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"
    }
  }
}
```

अपने `~/.fx/mcp.json` में निम्नलिखित जोड़ें:

```json theme={null}
{
  "mcp": {
    "calcom": {
      "type": "http",
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

फिर प्राधिकरण के लिए fx में `/mcp auth calcom --open` चलाएँ। ट्रांसपोर्ट, प्रमाणीकरण विकल्प और टूल खोज के लिए
[fx MCP दस्तावेज़](https://fx.sh/docs/capabilities/mcp) देखें।

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

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

आवश्यक शर्तें

• Node.js >= 18
• एक Cal.com API कुंजी — Settings → Developer → API Keys में एक उत्पन्न करें

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

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

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

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

चेतावनी

अपनी API कुंजी कभी साझा या कमिट न करें। यदि उजागर हो जाए, तो इसे तुरंत अपनी Cal.com सेटिंग्स में घुमाएँ।

टूलसेट

आप सर्वर URL में toolsets क्वेरी पैरामीटर जोड़कर प्रतिबंधित कर सकते हैं कि सर्वर किसी सत्र के लिए कौन से टूल पंजीकृत करता है:

https://mcp.cal.com/mcp?toolsets=bookings,availability

मान्य टूलसेट: profile, event-types, bookings, availability, schedules, calendars, teams, organizations, routing-forms, catalog (find_api_operation / describe_api_operation / call_api_operation मेटा-टूल)। अज्ञात नामों को 400 invalid_request के साथ अस्वीकार कर दिया जाता है। पैरामीटर को छोड़ने से हर टूल पंजीकृत होता है; स्थानीय टूल get_app_link और search_docs चयन की परवाह किए बिना हमेशा पंजीकृत होते हैं। स्व-होस्टेड stdio सर्वर के लिए, इसके बजाय MCP_TOOLSETS सेट करें।

उपलब्ध टूल

MCP सर्वर श्रेणी के अनुसार व्यवस्थित 63 टूल प्रदर्शित करता है:

ऐप लिंक

टूल	विवरण
get_app_link	एक URL बनाएं जो Cal.com वेब ऐप में बुकिंग, इवेंट प्रकार, शेड्यूल, टीम, रूटिंग फॉर्म या सेटिंग्स पृष्ठ खोलता है

दस्तावेज़ीकरण

टूल	विवरण
search_docs	Cal.com उत्पाद दस्तावेज़ खोजें; शीर्ष परिणाम के अंश के साथ रैंक किए गए पृष्ठ लौटाता है

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

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

इवेंट प्रकार

टूल	विवरण
get_event_types	सभी इवेंट प्रकार सूचीबद्ध करें
get_event_type	ID द्वारा एक विशिष्ट इवेंट प्रकार प्राप्त करें
create_event_type	एक नया इवेंट प्रकार बनाएं
update_event_type	एक इवेंट प्रकार अपडेट करें
delete_event_type	एक इवेंट प्रकार हटाएं
get_event_type_settings	एक इवेंट प्रकार की सेटिंग्स प्राप्त करें
get_event_type_history	एक इवेंट प्रकार का परिवर्तन इतिहास प्राप्त करें
get_scheduling_config	एक इवेंट प्रकार का शेड्यूलिंग कॉन्फ़िगरेशन प्राप्त करें
get_crm_sync_errors	एक इवेंट प्रकार के लिए CRM सिंक त्रुटियाँ प्राप्त करें

बुकिंग

टूल	विवरण
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_booking_routing_trace	एक बुकिंग के लिए रूटिंग ट्रेस प्राप्त करें
get_org_team_bookings	एक संगठन टीम के लिए बुकिंग प्राप्त करें
get_org_user_bookings	एक संगठन उपयोगकर्ता के लिए बुकिंग प्राप्त करें

शेड्यूल

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

उपलब्धता और कैलेंडर

टूल	विवरण
get_availability	उपलब्ध समय स्लॉट प्राप्त करें
get_busy_times	कैलेंडर से व्यस्त समय प्राप्त करें
get_connected_calendars	कनेक्टेड कैलेंडर सूचीबद्ध करें
get_conferencing_apps	कॉन्फ्रेंसिंग एप्लिकेशन सूचीबद्ध करें

टीमें और सदस्यता

टूल	विवरण
get_my_teams	वे टीमें प्राप्त करें जिनसे आप संबंधित हैं
get_org_teams	संगठन टीमें प्राप्त करें
create_team_invite	किसी को टीम में आमंत्रित करें
create_team_membership	एक टीम सदस्यता बनाएं
get_team_memberships	सभी टीम सदस्यताएँ प्राप्त करें
get_team_membership	एक टीम सदस्यता प्राप्त करें
update_team_membership	एक टीम सदस्यता अपडेट करें
delete_team_membership	एक टीम सदस्यता हटाएं

संगठन

टूल	विवरण
get_org_memberships	सभी संगठन सदस्यताएँ प्राप्त करें
create_org_membership	एक संगठन सदस्यता बनाएं
get_org_membership	एक संगठन सदस्यता प्राप्त करें
update_org_membership	एक संगठन सदस्यता अपडेट करें
delete_org_membership	एक संगठन सदस्यता हटाएं
get_org_attributes	संगठन विशेषताएँ प्राप्त करें
get_org_attribute	एक संगठन विशेषता प्राप्त करें
get_attribute_options	एक विशेषता के लिए विकल्प प्राप्त करें
get_user_attributes	एक उपयोगकर्ता को सौंपी गई विशेषताएँ प्राप्त करें
assign_attribute_to_user	एक उपयोगकर्ता को एक विशेषता सौंपें
update_user_attribute	एक उपयोगकर्ता को सौंपी गई विशेषता अपडेट करें
unassign_attribute_from_user	एक उपयोगकर्ता से एक विशेषता असंबद्ध करें
get_user_attribute_history	एक उपयोगकर्ता का विशेषता असाइनमेंट इतिहास प्राप्त करें

रूटिंग फॉर्म

टूल	विवरण
calculate_routing_form_slots	रूटिंग फॉर्म प्रतिक्रिया के आधार पर स्लॉट की गणना करें
get_org_routing_forms	संगठन रूटिंग फॉर्म प्राप्त करें
get_org_routing_form_responses	रूटिंग फॉर्म प्रतिक्रियाएँ प्राप्त करें

API कैटलॉग

टूल	विवरण
find_api_operation	पूर्ण API v2 ऑपरेशन कैटलॉग खोजें
describe_api_operation	एक API ऑपरेशन के लिए इनपुट स्कीमा प्राप्त करें
call_api_operation	कैटलॉग से कोई भी API v2 ऑपरेशन निष्पादित करें

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

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

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

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

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

यह दस्तावेज़ीकरण Mintlify पर बनाया और होस्ट किया गया है, जो एक डेवलपर दस्तावेज़ीकरण प्लेटफ़ॉर्म है।