Cal.com MCP

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 enveloppe 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 commitez jamais. Si elle est exposée, faites-la pivoter 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 des 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 pour 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 de requêtes

Une fois connecté, vous pouvez interagir avec Cal.com en langage naturel :

• "Quelles réservations ai-je cette semaine ?"
• "Créer un type d'événement de 30 minutes appelé 'Discussion rapide'"
• "Annuler ma réunion avec Jean demain"
• "Montre-moi mes créneaux disponibles pour lundi prochain"
• "Replanifier 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 en 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