Connecteur CalRS
CalRS est un outil de prise de rendez-vous écrit en Rust, sous licence AGPL-3.0, avec une base SQLite et le protocole CalDAV. Il est le seul connecteur d'agenda de ce type dans connectors/ : connectors/calrs.yaml (décision notée dans l'en-tête de ce fichier, ADR-0009).
Ce chapitre garde le nom de fichier calcom.md pour que les liens existants continuent de fonctionner.
Transport
CalRS n'expose pas d'API HTTP, selon l'en-tête de connectors/calrs.yaml. Le connecteur ne parle donc pas à une adresse web. Il lance une commande podman exec … calrs <sous-commande> dans le conteneur CalRS. Conséquences :
- il n'y a ni adresse d'instance, ni clé d'API, ni en-tête d'authentification à configurer ;
- l'autorisation est celle du socket Podman, en amont du connecteur ;
- aucune variable d'environnement n'est lue par ce connecteur.
Le nom d'identifiant historique calcomApi existe encore côté plateforme. Il est rattaché au connecteur calrs et ne publie aucune variable d'environnement (table de correspondance des identifiants du code, entrée calcomApi).
Outils
Mesuré le 2026-10-03 : 7 outils déclarés dans connectors/calrs.yaml. Le client Rust qui les exécute est crates/forge-mcp/src/connector/calrs_cli_client.rs.
| Outil | Rôle |
|---|---|
list_bookings | Lister les rendez-vous réservés |
show_calendar | Afficher le calendrier |
list_event_types | Lister les types de rendez-vous |
list_slots | Lister les créneaux disponibles d'un type de rendez-vous (paramètre slug obligatoire, days optionnel) |
create_booking | Créer un rendez-vous |
cancel_booking | Annuler un rendez-vous |
create_event_type | Créer un type de rendez-vous |
Trois de ces outils écrivent : create_booking, cancel_booking, create_event_type.
Déploiement
Un service CalRS figure dans podman-compose.vps2.yml, avec une image construite localement et un volume de données. Un commentaire de ce fichier le classe « catalogue » et précise qu'il est hors des plans thérapeute depuis le 2026-07-08.
Le connecteur n'a de sens que si le conteneur CalRS tourne sur la même machine que le processus qui lance la commande.
Limites
- Aucun outil de disponibilité par utilisateur :
list_slotstravaille sur un type de rendez-vous identifié par sonslug. - Le conteneur déployé ne contient aucun type de rendez-vous par défaut. Il faut en créer un (
create_event_type) avant de lister des créneaux. Cette remarque vient d'une mesure du 2026-08-30 consignée dans le YAML. - L'entrée du catalogue métier (
calrs, catégorie Scheduling) a le statutavailable.
Fichiers sources
Le connecteur est déclaré dans connectors/calrs.yaml et exécuté par crates/forge-mcp/src/connector/calrs_cli_client.rs.
Voir aussi
- Vue d'ensemble : chiffres mesurés, chargement et règles communes aux douze connecteurs
- Créer votre premier connecteur MCP : forme d'un fichier YAML et ajout d'un connecteur à la passerelle
- Routes MCP : ouvrir une session et appeler un outil par JSON-RPC
- Tarification : nombre de connecteurs métier inclus dans chaque offre
- Déploiement Podman : plan client, réseaux et unités où tourne le conteneur CalRS