Calq MCP

Ce qu'il fait

Calq MCP connecte votre assistant IA à un backend auto-hébergé de suivi du temps et de gestion de projet. Vous pouvez démarrer/arrêter des minuteurs, enregistrer des heures, gérer des clients et des projets, capturer des souvenirs avec rappel sémantique et obtenir des résumés du temps non facturé prêts pour la facturation — tout cela en langage naturel. Les équipes peuvent collaborer grâce à l'authentification GitHub OAuth et au contrôle d'accès basé sur les rôles.

Outils

Suivi du Temps

• commit — Enregistrer du temps avec un message, un projet et une date optionnelle
• start / stop — Démarrage et arrêt du minuteur en temps réel
• timer_status — Vérifier si un minuteur est en cours
• cancel_timer — Annuler un minuteur en cours
• edit / delete — Modifier ou supprimer des entrées

Résumés & Facturation

• get_today_summary — Temps enregistré aujourd'hui par projet
• get_weekly_summary — Temps de la semaine ventilé par jour
• get_unbilled — Tout le temps non facturé pour tous les projets
• get_invoice_summary — Temps non facturé groupé par client avec valeurs calculées
• list_projects / list_projects_detailed — Aperçu des projets avec totaux

Mémoire IA

• remember / recall — Stocker et rechercher sémantiquement des notes personnelles ou partagées
• idea — Capturer rapidement une idée
• search_entries — Rechercher sémantiquement d'anciennes entrées de temps
• forget — Supprimer un souvenir stocké

Clients, Projets & Utilisateurs

• add_client / list_clients — Gérer les dossiers clients
• configure_project — Créer/mettre à jour des projets avec client et taux horaire
• whoami / list_users / team_summary — Gestion des utilisateurs et de l'équipe

Installation

Nécessite Docker, PostgreSQL, ChromaDB, une clé API Voyage AI et une application GitHub OAuth.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "calq": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Démarrer le serveur avec Docker Compose :

git clone https://github.com/Calq-dev/calq-mcp.git && cd calq-mcp
cp .env.example .env  # ajoutez vos clés API
docker compose up -d

Hôtes supportés

Claude Desktop est le client principal confirmé (transport HTTP via le champ url dans la config).