Cal.com MCP
officielConnectez les clients IA à la planification Cal.com via le protocole de contexte de modèle en utilisant le serveur hébergé sur mcp.cal.com ou une instance locale.
Que pouvez-vous faire avec Cal Com MCP ?
- Check your upcoming bookings — Ask for a list of your bookings with filters like date range or status using
get_bookings. - Create and manage event types — Create, update, or delete event types such as a "Quick Chat" via
create_event_typeand related tools. - Reschedule or cancel meetings — Reschedule a booking to a new time with
reschedule_bookingor cancel it entirely withcancel_booking. - Find available time slots — Retrieve open slots for a given date range using
get_availabilitybefore scheduling. - Manage your schedules — View, create, or modify your availability schedules with
get_schedulesandcreate_schedule. - Handle booking attendees — View all attendees for a booking with
get_booking_attendeesor add new ones withadd_booking_attendee.
Documentation
Serveur MCP
Connectez les clients IA à la planification Cal.com via le Model Context Protocol en utilisant le serveur hébergé sur mcp.cal.com ou une instance locale.
Le serveur Cal.com MCP encapsule l'API Cal.com v2 dans le Model Context Protocol, vous permettant de gérer les réservations, les types d'événements, les horaires et plus encore en langage naturel dans n'importe quel client compatible MCP.
Serveur hébergé (mcp.cal.com)
Le moyen le plus rapide de démarrer est de connecter votre client MCP directement à mcp.cal.com. Le serveur hébergé utilise le transport HTTP Streamable avec l'authentification OAuth 2.1 — votre client gère automatiquement le flux d'autorisation.
Connectez votre client
Dirigez votre client MCP vers l'URL du serveur hébergé :
https://mcp.cal.com/mcp
Lors de la première connexion, votre client vous guide à travers un flux d'autorisation OAuth où vous accordez au serveur l'accès à votre compte Cal.com. Aucune clé API n'est nécessaire.
Ajoutez ce qui suit à votre `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"
}
}
}
```
Ouvrez **Paramètres → MCP** et ajoutez un nouveau serveur avec l'URL `https://mcp.cal.com/mcp`, ou ajoutez-le à votre `.cursor/mcp.json` :
```json theme={null}
{
"mcpServers": {
"calcom": {
"url": "https://mcp.cal.com/mcp"
}
}
}
```
Ajoutez le serveur à vos paramètres MCP de VS Code :
```json theme={null}
{
"mcpServers": {
"calcom": {
"url": "https://mcp.cal.com/mcp"
}
}
}
```
Serveur auto-hébergé (stdio)
Si vous préférez exécuter le serveur localement, vous pouvez utiliser le transport stdio avec une clé API. C'est utile pour le développement ou lorsque vous souhaitez un contrôle total sur le serveur.
Prérequis
- Node.js >= 18
- Une clé API Cal.com — générez-en une dans Paramètres → Développeur → Clés API
Connectez votre client
Ajoutez ce qui suit à la configuration de votre client MCP :
{
"mcpServers": {
"calcom": {
"command": "npx",
"args": ["@calcom/cal-mcp@latest"],
"env": {
"CAL_API_KEY": "cal_live_xxxx"
}
}
}
}
Remplacez cal_live_xxxx par votre clé API réelle.
Outils disponibles
Le serveur MCP expose 34 outils organisés par catégorie :
Profil utilisateur
| Outil | Description |
|---|---|
get_me | Obtenir votre profil utilisateur authentifié |
update_me | Mettre à jour votre profil utilisateur |
Types d'événements
| Outil | Description |
|---|---|
get_event_types | Lister tous les types d'événements |
get_event_type | Obtenir un type d'événement spécifique par ID |
create_event_type | Créer un nouveau type d'événement |
update_event_type | Mettre à jour un type d'événement |
delete_event_type | Supprimer un type d'événement |
Réservations
| Outil | Description |
|---|---|
get_bookings | Lister les réservations avec filtres optionnels |
get_booking | Obtenir une réservation spécifique par UID |
create_booking | Créer une nouvelle réservation |
reschedule_booking | Replanifier une réservation |
cancel_booking | Annuler une réservation |
confirm_booking | Confirmer une réservation en attente |
mark_booking_absent | Marquer une absence de réservation |
get_booking_attendees | Obtenir tous les participants d'une réservation |
add_booking_attendee | Ajouter un participant à une réservation |
get_booking_attendee | Obtenir un participant spécifique |
Horaires
| Outil | Description |
|---|---|
get_schedules | Lister tous les horaires |
get_schedule | Obtenir un horaire spécifique par ID |
create_schedule | Créer un nouvel horaire |
update_schedule | Mettre à jour un horaire |
delete_schedule | Supprimer un horaire |
get_default_schedule | Obtenir votre horaire par défaut |
Disponibilité
| Outil | Description |
|---|---|
get_availability | Obtenir les créneaux horaires disponibles |
get_busy_times | Obtenir les périodes occupées des calendriers |
Conférence
| Outil | Description |
|---|---|
get_conferencing_apps | Lister les applications de conférence |
Formulaires de routage
| Outil | Description |
|---|---|
calculate_routing_form_slots | Calculer les créneaux en fonction de la réponse du formulaire de routage |
Organisations
| Outil | Description |
|---|---|
get_org_memberships | Obtenir toutes les adhésions à l'organisation |
create_org_membership | Créer une adhésion à l'organisation |
get_org_membership | Obtenir une adhésion à l'organisation |
delete_org_membership | Supprimer une adhésion à l'organisation |
get_org_routing_forms | Obtenir les formulaires de routage de l'organisation |
get_org_routing_form_responses | Obtenir les réponses du formulaire de routage |
Exemples d'invites
Une fois connecté, vous pouvez interagir avec Cal.com en langage naturel :
- "Quelles réservations ai-je cette semaine ?"
- "Crée un type d'événement de 30 minutes appelé 'Discussion rapide'"
- "Annule ma réunion avec Jean demain"
- "Montre-moi mes créneaux disponibles pour lundi prochain"
- "Replanifie ma réunion de 14h à jeudi 15h"
- "Quels types d'événements ai-je ?"
Ressources associées
- Guide des agents IA — créez des agents IA utilisant directement l'API Cal.com
- Référence API v2 — documentation complète des points de terminaison de l'API
- Dépôt GitHub — code source