HubSpot MCP : brancher Claude au CRM, 2 serveurs officiels, 5 routines testées

Brancher Claude ou ChatGPT à HubSpot via les 2 serveurs MCP officiels : procédure testée, 5 routines marketing ops, permissions à verrouiller.

Sommaire

Brancher Claude, ChatGPT ou Cursor sur HubSpot pour qu’ils lisent et écrivent dans le CRM pendant une conversation : c’est ce que propose le HubSpot MCP. Depuis la GA du serveur distant le 13 avril 2026, deux serveurs officiels coexistent, un connecteur natif Claude lancé le 29 juillet 2025 continue de tourner en lecture seule, et trois implémentations communautaires circulent. Cet article tranche entre ces portes d’entrée, détaille ce que le serveur distant atteint vraiment, livre la procédure que nous avons testée sur un portail HubSpot Bulldozer, et cinq routines marketing ops avec le prompt exact.

HubSpot MCP, en une phrase

HubSpot MCP est l’implémentation par HubSpot du Model Context Protocol : un serveur officiel qu’un client MCP compatible (Claude Desktop, ChatGPT, Cursor, VS Code, Gemini CLI) appelle pendant une conversation pour lire et écrire dans votre CRM, avec OAuth et scopes.

Côté architecture : votre portail HubSpot d’un côté, un client MCP compatible de l’autre, le serveur mcp.hubspot.com au milieu. Chaque demande en langage naturel est traduite par le client en appel d’outil MCP, qui s’appuie lui-même sur l’API HubSpot. Le protocole ne tourne pas en tâche de fond : il attend que vous lanciez un prompt.

Ce schéma recouvre deux usages adjacents côté équipe marketing. Le premier : ouvrir le CRM à un assistant pour les tâches de pilotage (relances, nettoyage, prep de call). Le second : outiller des agents IA pour qu’ils tiennent des rôles plus larges, comme on l’a décrit dans notre guide IA marketing. Dans les deux cas, la clé est OAuth et des scopes serrés.

Les 2 serveurs officiels, lequel pour quoi

HubSpot expose deux serveurs MCP officiels distincts : le serveur distant HubSpot MCP server (Remote), GA depuis le 13 avril 2026, et le serveur développeur local Developer MCP server, GA depuis le 19 février 2026. Le premier sert à piloter le CRM. Le second sert à construire des applications et des pages CMS sur HubSpot.

CritèreServeur DistantServeur Développeur
HébergementHubSpot, URL mcp.hubspot.comLocal, via la CLI HubSpot
InstallationAjout d’un connecteur URL dans le client MCPCommande hs mcp setup dans un terminal
GA13 avril 2026 (beta publique le 1er septembre 2025)19 février 2026
PrérequisUser-level app sur le nouveau Developer Platform, OAuthHubSpot CLI 8.2.0 ou supérieur, Developer Platform v2025.2
Public viséRevOps, marketing, sales ops, support clientDéveloppeurs qui créent des UI Extensions et des assets CMS
Clients compatiblesTout client MCP qui gère OAuth 2.1 (Claude Desktop, ChatGPT, Cursor, VS Code, Gemini CLI)Outils agentiques sélectionnés à l’installation (ex. Cursor, Claude Code)

Dans 90 % des cas, une équipe marketing ou ops veut le serveur Distant. Le serveur Développeur n’a d’intérêt que si vous écrivez du code HubSpot (modules CMS, UI Extensions, workflows custom) et voulez un copilote qui lit la doc et édite des fichiers du Developer Platform.

Ce que le serveur distant atteint vraiment

Le serveur distant HubSpot ouvre à la fois la lecture et l’écriture sur une liste précise d’objets CRM et d’engagements, garde un périmètre lecture seule sur l’organisation et le contenu marketing, et refuse l’accès aux Sensitive Data Properties. C’est écrit noir sur blanc dans la doc officielle, puis repris par Sprites.ai dans un tableau comparable.

Lecture et écriture

  • Objets CRM : contacts, companies, deals, tickets, carts, products, orders, line items, invoices, quotes, subscriptions, segments (listes).
  • Engagements : calls, emails, meetings, notes, tasks.

Lecture seule

  • Organisation : users, teams, reporting structures, owners, roles, seats.
  • Contenu marketing : campaigns et campaign metrics, landing pages, website pages, blog posts.

Refusé

  • Sensitive Data Properties personnalisées, dont Personal Health Information et toute autre donnée classée hautement sensible. Ces propriétés sont bloquées outright côté serveur, pas simplement filtrées par scope.

L’asymétrie à retenir : un agent peut créer un deal, pousser une note sur un ticket, programmer une tâche, enregistrer un meeting. Il ne peut pas modifier une campagne, dépublier une landing page, éditer un blog post. Si un cas d’usage vous demande ça, il faut passer par un workflow HubSpot ou une Private App dédiée.

Brancher Claude à HubSpot en 5 minutes

La procédure est la même pour un portail de prod ou un portail sandbox : une app user-level côté HubSpot, un connecteur URL côté client MCP, OAuth, et un premier prompt pour valider la connexion. Nous l’avons jouée sur un portail Bulldozer et sur deux portails clients.

  1. Créer la user-level app sur le nouveau HubSpot Developer Platform. Scopes a minima : lecture sur contacts, companies, deals, owners, schemas. Écriture seulement si vous voulez que l’agent pose des notes, tâches ou engagements.
  2. Récupérer l’URL et préparer OAuth. Le serveur distant écoute sur https://mcp.hubspot.com. Aucun client ID ni secret à copier dans le client : OAuth se joue dans le navigateur.
  3. Côté Claude Desktop : Settings, puis Customize, puis Connectors, puis Add custom connector, coller https://mcp.hubspot.com, valider. La fenêtre d’OAuth HubSpot s’ouvre dans le navigateur, vous choisissez votre portail, vous validez les scopes.
  4. Côté ChatGPT (Developer mode) : Settings, puis Security and login, activer Developer mode, puis Settings, puis Plugins, ajouter la même URL. Si HubSpot apparaît déjà dans le répertoire interne du client, utiliser cette entrée plutôt que l’URL brute.
  5. Côté Cursor : éditer la config MCP (~/.cursor/mcp.json), ajouter une entrée pointant sur mcp.hubspot.com, redémarrer Cursor, signer OAuth. Pour vérifier la connexion, taper « List my contacts created this week ». Une liste vide après OAuth veut dire que le token n’est pas accepté : déconnecter et reconnecter.

Sur notre portail Bulldozer, le temps réel de la première connexion a été de l’ordre de quelques minutes, essentiellement passé à cocher les bons scopes.

Les permissions OAuth à cocher par rôle

Les scopes HubSpot sont structurés par objet : lecture et écriture sont séparées. La procédure publiée par Lomed liste exactement les scopes qui reviennent dans nos installations. Voici comment nous les répartissons pour un commercial, un marketeur et un admin RevOps, en partant du principe que l’app user-level respecte le périmètre du rôle.

RôleLectureÉcriture
Commercialcrm.objects.contacts.read, crm.objects.deals.read, crm.objects.owners.read, engagements (calls, emails, meetings, notes, tasks) en lectureEngagements en écriture (notes, tasks, meetings, calls)
Marketeurcrm.objects.contacts.read, crm.objects.companies.read, campaigns, landing pages, website pages, blog posts (lecture seule par nature)Aucune, sauf création de notes et tasks sur contacts
Admin RevOpsLecture complète CRM + schemas + custom objects (crm.objects.custom.read, crm.schemas.*)Écriture complète hors Sensitive Data : deals, contacts, companies, custom objects

Deux garde-fous que nous gardons activés par défaut : jamais d’écriture sur les propriétés classées Sensitive Data (le serveur les bloque de toute façon), et toujours une app user-level par rôle. Un même token qui porte à la fois « deals.write » et « custom.write » augmente la surface d’une erreur d’agent.

5 routines marketing ops qui valent le coup

Nous installons depuis la beta publique de septembre 2025 les mêmes cinq routines chez nos clients et sur notre propre portail. Elles font partie des chantiers que nous activons dans notre offre Optimisation du pipeline. Pour chacune : le prompt exact, ce que Claude renvoie, et le point à vérifier avant de lancer sur un volume.

1. Relancer les closed-lost dont le contact a changé de poste

Prompt : « Liste les deals HubSpot marqués closed-lost sur les 12 derniers mois pour un montant supérieur à 10 000 €. Pour chaque deal, vérifie le poste actuel du contact principal. Sors un tableau deal, contact, ancien poste, poste actuel, raison de perte. »

Ce que Claude renvoie : un tableau trié par montant décroissant, chaque ligne nominative avec la raison de perte prise sur le deal.

À vérifier avant volume : le poste est pris depuis la propriété contact de HubSpot, pas depuis LinkedIn en live. Pour la fraîcheur, enrichir au préalable via un job d’enrichissement, sinon la routine renvoie le poste tel qu’il était le jour de la dernière synchro.

2. Préparer un call avec un résumé 360°

Prompt : « Donne-moi un brief de 10 lignes sur le compte <company> : deals ouverts, dernier meeting, dernière note, dernier email, dernier appel, tickets ouverts, propriétaire du compte. Signale toute activité des 7 derniers jours. »

Ce que Claude renvoie : une synthèse au format brief, avec les 7 champs demandés, chaque ligne horodatée. Le MCP lit les engagements (calls, emails, meetings, notes, tasks) et les objets CRM d’un coup.

À vérifier avant volume : la routine ne voit que ce qui est loggé dans HubSpot. Si les commerciaux ne posent pas leurs notes dans HubSpot, le brief ressemble à un vide.

3. Nettoyer les deals sans next step depuis 14 jours

Prompt : « Liste les deals ouverts dans la pipeline principale sans activité (meeting, call, email, note, tâche) depuis 14 jours, triés par date de prochain step manquant. Crée une tâche "Revoir ou fermer" assignée à l’owner, échéance dans 2 jours ouvrés. »

Ce que Claude renvoie : la liste + la confirmation des tâches créées, avec l’ID de chaque tâche. On garde la trace pour pouvoir annuler en masse en cas d’erreur.

À vérifier avant volume : lancer d’abord en mode dry run sur 10 deals. Si l’agent se trompe de propriétaire sur un deal partagé, on le voit sur un petit échantillon.

4. Scoring d’activité sur les 30 derniers jours

Prompt : « Pour chaque contact HubSpot qui a interagi avec nous sur les 30 derniers jours (email ouvert, meeting, visite d’une page, formulaire), note l’activité de 0 à 100 selon le mix : visites de pages × 1, emails ouverts × 2, formulaires × 10, meetings × 20. Pose la note dans la propriété custom "activity_score_30d". »

Ce que Claude renvoie : la liste des contacts touchés, la note calculée, la confirmation de l’écriture dans la propriété custom. Le MCP écrit directement dans la fiche.

À vérifier avant volume : créer d’abord la propriété activity_score_30d (type number) dans HubSpot. Sans la propriété, l’écriture échoue silencieusement sur certains clients.

5. Rapport pipeline hebdo

Prompt : « Donne-moi le rapport hebdo du pipeline principal : nombre de deals par stage, somme des montants par stage, variation en nombre et en montant versus la semaine précédente, top 5 deals qui ont bougé de stage, top 5 deals bloqués depuis plus de 30 jours. »

Ce que Claude renvoie : un rapport texte structuré, prêt à coller dans un Slack hebdo.

À vérifier avant volume : le mode conversation ne se déclenche pas tout seul tous les lundis. Pour automatiser, caler un rappel calendrier ou un job cron qui pingue un agent via l’API d’un client MCP qui l’expose (sinon la routine reste sur sollicitation).

Officiel, communautaire ou connecteur natif Claude

Quatre portes d’entrée coexistent en 2026 pour brancher une IA sur HubSpot : le serveur officiel distant, le connecteur natif Claude × HubSpot, les serveurs communautaires et le serveur développeur. Notre choix par défaut : le serveur distant officiel. Les trois autres se justifient dans des cas précis.

Porte d’entréeÀ quiCe qu’on gagneCe qu’on perd
Serveur distant officiel (mcp.hubspot.com)RevOps, sales ops, marketing opsLecture + écriture sur CRM et engagements, OAuth standard, maintenance HubSpotPas de trigger côté HubSpot, pas de stockage vectoriel, OAuth 2.1 requis côté client
Connecteur natif Claude × HubSpot (lancé le 29 juillet 2025)Équipes qui vivent dans Claude (Pro, Max, Team, Enterprise)Installation en 1 clic depuis Claude, respect automatique des permissions HubSpot, Anthropic n’utilise pas la donnée pour l’entraînementLecture seule sur contacts, companies, deals, tickets, et leurs associations
Communautaire shinzo-labs, baryhuang, scopiousDevs qui veulent outils sur mesure, stockage vectoriel ou self-hostCode ouvert MIT, outils en plus (FAISS chez baryhuang, semantic search), install npx ou DockerToken HubSpot statique (OAuth planifié chez shinzo-labs), maintenance à votre charge, pas de SLA
Serveur développeur localDevs qui créent des UI Extensions et des assets CMS HubSpotContexte HubSpot complet pour un copilote de code, intégration CLINe sert pas au pilotage du CRM côté marketing ops

Pour aller plus loin dans le choix d’outils IA côté CRM, notre comparatif CRM 2026 replace HubSpot dans un marché qui s’est verticalisé depuis deux ans. Si vous hésitez entre MCP et intégration classique, notre guide stratégie CRM cadre la question de la gouvernance avant de choisir la couche d’exécution.

Les limites avant de le brancher en prod

Le HubSpot MCP est une porte, pas un worker : il ne déclenche rien tout seul, chaque appel coûte un appel API HubSpot, et la bascule OAuth 2.1 arrive. Quatre points à verrouiller avant d’ouvrir un agent sur un portail de prod.

  • Aucun trigger côté HubSpot. « It’s a doorway, not a worker » (Usecarly). Rien ne surveille un changement de stage de deal, rien ne tourne quand la conversation est fermée. Pour réagir à un événement, il faut un workflow HubSpot ou un webhook.
  • Chaque appel MCP est un appel API HubSpot. Un agent qui boucle peut multiplier les appels et saturer un quota. Monter d’abord des garde-fous côté prompt (limites explicites, batch) et côté app (scopes serrés).
  • Sensitive Data Properties inaccessibles. Si une partie de votre schéma est sensible (santé, conformité), elle restera invisible à l’agent. Ce n’est pas un bug, c’est le choix de HubSpot.
  • Migration OAuth 2.0 vers 2.1 avec PKCE. Le serveur distant supporte OAuth 2.0 aujourd’hui ; HubSpot annonce l’alignement sur OAuth 2.1 côté client (PKCE, rotation de refresh token à usage unique). Le jour où votre client MCP exige 2.1, il faudra peut-être recréer la connexion.

Dernier point de gouvernance : un MCP CRM est une couche d’exécution, pas une stratégie. Pour cadrer les cas d’usage de Claude dans une équipe B2B avant d’installer un serveur, voir notre ressource Claude pour le marketing B2B. Et pour comparer avec d’autres serveurs MCP déjà en production, voir notre guide MCP LinkedIn.

Ce qu’il faut retenir

  • HubSpot a deux serveurs MCP officiels : le serveur distant (mcp.hubspot.com, GA 13 avril 2026) pour piloter le CRM, et le serveur développeur local (GA 19 février 2026) pour coder sur HubSpot.
  • Le serveur distant écrit sur les objets CRM et les engagements, lit l’organisation et le contenu marketing, refuse les Sensitive Data Properties.
  • Pour brancher Claude, ChatGPT ou Cursor : une user-level app HubSpot avec scopes serrés, le connecteur URL dans le client, OAuth dans le navigateur. Comptez quelques minutes.
  • Cinq routines marketing ops couvrent 80 % de la valeur immédiate : relance closed-lost, prep de call 360°, nettoyage des deals sans next step, scoring d’activité, rapport pipeline hebdo.
  • Le MCP est une porte, pas un worker : pour un déclencheur sur changement de stage, il faut un workflow HubSpot à côté.

Si votre pipeline HubSpot souffre de deals qui traînent et de données qui dérivent, ces cinq routines ne tiendront que si la fondation est propre. Faire l’audit de votre pipeline HubSpot avec Bulldozer prend deux semaines et vous dit quoi brancher, dans quel ordre.

Rich Text Attributes - Do not delete
This container will be hidden on the live page

Lorem ipsum

Réserver une démo
Jordan Chenevier-Truchet
Jordan Chenevier-Truchet
CEO
Dernière mise à jour
16.11.2026

Co-fondateur et CEO de Bulldozer, il écrit sur la stratégie growth et le go-to-market B2B.

Plus d'articles de cet auteur

Voir plus

Pour aller plus loin

MCP LinkedIn : quels serveurs choisir et comment les installer en 2026
10.11.2026
AI & Marketing Automation
Jordan Chenevier-Truchet
MCP LinkedIn : quels serveurs choisir et comment les installer en 2026
MCP Meta Ads : le serveur officiel, les alternatives, le vrai test
16.11.2026
AI & Marketing Automation
Jordan Chenevier-Truchet
MCP Meta Ads : le serveur officiel, les alternatives, le vrai test
IA marketing : comment transformer votre stratégie B2B (sans perdre la main)
26.12.2025
AI & Marketing Automation
Killian Drecq
IA marketing : comment transformer votre stratégie B2B (sans perdre la main)

Questions fréquentes

Vous ne trouvez pas votre réponse ? Contactez-nous !

jordan@bulldozer-collective.com
Est-ce que HubSpot a un serveur MCP officiel ?
HubSpot propose deux serveurs MCP officiels. Le premier est le serveur distant, hébergé sur mcp.hubspot.com, destiné au pilotage du CRM par un assistant IA, GA depuis le 13 avril 2026. Le second est le serveur développeur, installé en local via la CLI HubSpot, destiné à construire des UI Extensions et des assets CMS sur HubSpot, GA depuis le 19 février 2026.
Faut-il un plan payant HubSpot pour utiliser le MCP ?
Il n’y a pas de tier HubSpot minimal imposé pour le serveur distant. Il faut un compte sur le nouveau HubSpot Developer Platform, une user-level app avec les scopes OAuth sur les objets ciblés, et un client MCP compatible comme Claude Desktop, ChatGPT en Developer mode ou Cursor. Le serveur développeur exige en plus HubSpot CLI 8.2.0 ou supérieur et Developer Platform v2025.2.
Le MCP HubSpot peut-il réagir quand un deal change de stage ?
Non. Le serveur MCP officiel est une porte d’entrée pendant une conversation, pas un worker : rien ne tourne quand la conversation est fermée et rien ne surveille un changement de stage de deal. Pour déclencher une action sur un événement HubSpot, il faut un workflow HubSpot ou un webhook, puis utiliser le MCP depuis la conversation pour les actions en langage naturel.
Peut-il accéder aux Sensitive Data Properties ?
Non. Les Sensitive Data Properties personnalisées, dont les Personal Health Information et toute donnée classée hautement sensible, sont bloquées côté serveur distant. Le blocage est total : ces propriétés ne sont ni lisibles ni éditables par le MCP, même avec un scope admin. Pour manipuler ces propriétés, passer par une Private App HubSpot dédiée avec audit d’accès.
Vaut-il mieux prendre le MCP officiel ou shinzo-labs ?
Serveur officiel distant par défaut : il est maintenu par HubSpot, supporte OAuth, et couvre tous les objets CRM plus les engagements. Les serveurs communautaires comme shinzo-labs (MIT, 35 étoiles sur GitHub) ou baryhuang (MIT, 129 étoiles, stockage vectoriel FAISS) ont du sens si vous avez besoin d’outils sur mesure, de semantic search locale ou d’un self-host pour des raisons de gouvernance.
Claude, ChatGPT et Cursor fonctionnent-ils tous les trois ?
Oui, les trois clients supportent le serveur distant HubSpot. Côté Claude Desktop : Settings, puis Customize, puis Connectors, ajouter l’URL mcp.hubspot.com. Côté ChatGPT : activer Developer mode dans Security and login, puis Plugins, ajouter la même URL. Côté Cursor : éditer la config MCP et ajouter une entrée pointant sur mcp.hubspot.com. Dans les trois cas, OAuth se joue dans le navigateur.
Newsletter

Rejoignez ceux qui définissent la croissance à l'ère de l'IA.

Accédez aux playbooks et aux retours de ceux qui façonnent la prochaine vague du marketing et de l'IA.

Merci pour votre inscription !
Oops! Something went wrong while submitting the form.

Let’s grow !

Du premier pipeline à une croissance soutenue
Leo Lacoste
Léo Lacoste
business partner