Cal.com MCP

officiel

Connectez 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.

Voir sur cal.com

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_type and related tools.
Reschedule or cancel meetings — Reschedule a booking to a new time with reschedule_booking or cancel it entirely with cancel_booking.
Find available time slots — Retrieve open slots for a given date range using get_availability before scheduling.
Manage your schedules — View, create, or modify your availability schedules with get_schedules and create_schedule.
Handle booking attendees — View all attendees for a booking with get_booking_attendees or add new ones with add_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.

Ne partagez jamais votre clé API et ne la versionnez pas. Si elle est exposée, révoquez-la immédiatement dans vos [paramètres Cal.com](https://app.cal.com/settings/developer/api-keys).

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