Référence des outils MCP

atbridge mcp lance un serveur Model Context Protocol via stdio, exposant vos e-mails, calendriers, contacts, notes et tâches Thunderbird comme des outils qu’un client IA peut appeler. Le nom du serveur dans la config d’un client est atbridge.ai.

// Dans la config de votre client MCP (voir les pages de configuration Connecter-votre-IA)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Outils par domaine

Chaque page liste les outils de lecture de ce domaine (toujours actifs) et les outils d’écriture (à activer — voir ci-dessous).

mail Récupérer, chercher, lister, obtenir, fil, pièces jointes — et envoyer, répondre, transférer, déplacer, supprimer, marquer, dossiers.

calendrier Événements, détection de conflits, recherche de créneaux, paramètres — et créer, mettre à jour, supprimer, RSVP.

contacts Contacts + listes de diffusion sur tous les carnets d'adresses.

notes @bridge Notes — récupérer un artefact comme contexte, ou en sauvegarder un.

tâches Tâches (VTODO) sur vos calendriers compatibles.

IA — Branded Email Rendre @bridge Branded Email ; lister et sauvegarder des modèles.

système — comptes, licence, mises à jour Choisir une identité d'expéditeur ; abonnement, appareils, état des mises à jour.

Lecture vs écriture

Les outils de lecture sont toujours enregistrés ; aucune activation. Les ids numériques et les Message-ID RFC sont interchangeables partout où un identifier est accepté.

Pagination et comptage — chaque outil de liste/recherche (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) accepte offset (ignorer les N premiers ; à combiner avec limit pour paginer — offset:20, limit:20 = résultats 21–40) et count: true (retourne { total, approx } pour les mêmes filtres au lieu des éléments). Les comptes sont exacts pour contacts/calendrier/tâches/notes ; au mieux pour le mail (délimitez avec folder/since/ until pour un chiffre exact — indiqué par approx).

Résultats épurés et résumé — mail_search et mail_list renvoient des lignes épurées par défaut : id, date, expéditeur/destinataire, objet, lu/marqué — assez pour choisir un message sans en récupérer plus que nécessaire. Ajoutez snippet: true pour un résumé en texte brut de ~200 caractères par résultat (nettoyé des marqueurs de citation et du bruit des séparateurs, de sorte qu’un résumé d’une ligne ne nécessite aucun mail_get supplémentaire), ou verbose: true pour l’ensemble des métadonnées de routage (headerMessageId, folderLabel, accountName, conversationId). Pour tout le reste, un mail_get par id suffit.

Les outils d’écriture ne sont enregistrés que lorsque ATBRIDGE_ALLOW_WRITES=1 est défini dans le env de l’entrée MCP, de sorte qu’un agent ne peut rien envoyer ni détruire sans que vous l’activiez. Activez-le avec atbridge mcp setup --client <id> --allow-writes, ou le bouton Allow writes dans les paramètres Connect your AI (MCP) de l’extension, puis redémarrez le client.

Outils d’administration — les outils de compte/système (facturation, appareils, version, mise à jour automatique) ne sont enregistrés que lorsque ATBRIDGE_ADMIN_TOOLS=1 est défini (désactivé par défaut). Ils ne sont quasiment jamais nécessaires pour le travail quotidien de mail/calendrier, donc les laisser désactivés garde la surface d’outils par défaut épurée ; activez-les de la même manière que vous activez l’écriture lorsque vous voulez que l’IA vérifie votre abonnement ou déclenche une mise à jour.

{
  "mcpServers": {
    "atbridge.ai": {
      "command": "atbridge",
      "args": ["mcp"],
      "env": { "ATBRIDGE_ALLOW_WRITES": "1" }
    }
  }
}

Voir aussi

Connecter votre IA — brancher un client MCP (Claude Desktop, Cursor)
Référence CLI — les mêmes opérations en commandes de terminal
Quand l’IA dit « aucun outil »

Was this page helpful?