Claude HubSpot koppelen: zo doe je het, stap voor stap

Wat het is

Wat kan Claude lezen en schrijven in HubSpot?

De HubSpot-connector is gebouwd door HubSpot zelf en staat in de officiële connectordirectory van Claude. Hij praat met de remote MCP-server van HubSpot op mcp.hubspot.com; een MCP-server is het programmaatje dat een AI-assistent gecontroleerd met een ander systeem laat werken. Claude ziet alleen wat jouw eigen HubSpot-gebruiker mag zien: een verkoper met alleen toegang tot zijn eigen deals krijgt in Claude ook alleen die deals. Volgens HubSpot kan Claude veel lezen en een flink deel aanmaken of bijwerken, maar nooit iets verwijderen.

Wat de connector niet kan

Claude verwijdert niets, ook geen veldwaarde. Hij past per opdracht maximaal 10 records tegelijk aan. Velden die je in HubSpot als gevoelige gegevens (Sensitive Data) hebt ingesteld, zoals gezondheidsinformatie, ziet hij niet. Staat Sensitive Data aan in je account, dan ziet hij zelfs geen enkele activiteit: geen mails, calls, notities of taken. Marketingmails en workflows bouwt hij niet in HubSpot voor je af; hij levert de tekst en jij zet hem erin. En alles valt onder de API-limieten van je HubSpot-account.

Claude werkt als je het vraagt, niet als er iets gebeurt

Claude reageert niet uit zichzelf op een nieuwe lead of een gewonnen deal. Hij werkt als jij een vraag stelt, of op een vast tijdstip als je een geplande taak maakt via Scheduled in de zijbalk van Claude. Wil je dat er iets gebeurt zodra een deal van fase wisselt, dan heb je een HubSpot-workflow of een tool als Make of n8n nodig. Dat staat in Claude met n8n, Make en Zapier.

Voorbereiding

Wat heb je nodig om Claude aan HubSpot te koppelen?

De techniek is klein, de rollen zijn het werk. Twee mensen kunnen nodig zijn voordat jij als gebruiker op Connect klikt: de Super Admin in HubSpot en, bij Claude Team of Enterprise, de Owner van je Claude-organisatie. Zoek eerst uit wie dat bij jullie is.

Kost de connector iets?

HubSpot rekent er geen apart abonnement voor. Je betaalt je Claude-plan, en je gebruik telt mee in de gewone limieten van dat plan. Een Pro-abonnement kost vanuit Nederland €18 per maand excl. btw; de prijzen per plan staan op Claude-abonnementen.

Pro of Team voor klantdata?

Alles wat Claude uit HubSpot ophaalt, staat daarna in je gesprek. Dat zijn persoonsgegevens: namen, mailadressen, telefoonnummers van je contacten. Op Team en Enterprise gelden de zakelijke voorwaarden van Anthropic, inclusief verwerkersovereenkomst en standaard geen training op je invoer. Op Pro en Max gelden de consumentenvoorwaarden. Voor een team dat met echte klantdata werkt, is Team daarom de logische keuze. De details lees je bij Claude privacy en zakelijk gebruik.

Stappen

De HubSpot-connector aanzetten in Claude, stap voor stap

Stap 1 en 2 zijn voor beheerders en hoeven maar één keer. Werk je alleen met Claude Pro en ben je zelf Super Admin in HubSpot, dan begin je bij stap 3.

Oudere handleidingen noemen een ander klikpad

Je leest online nog Settings > Connectors > Browse, ook in de handleiding van HubSpot zelf. Op 28 oktober 2026 zat de lijst in claude.ai onder Customize > Connectors > Discover. Kom je er niet uit, ga dan direct naar claude.ai/customize/connectors. Achtergrond over connectors in het algemeen staat op MCP en connectors.

Wat de Super Admin vaak vergeet

Rechten die de Super Admin later toevoegt, werken pas als elke gebruiker de connector ontkoppelt en opnieuw koppelt. Laat dat in je teamkanaal weten, anders denkt de helft van je team dat schrijven niet werkt. Intrekken voor iedereen kan via Manage access > Revoke Approval; volgens HubSpot duurt het tot 30 minuten voordat dat overal doorwerkt.

Controle

Werkt het? De eerste prompt en hoe je het controleert

Begin met een vraag waarvan je het antwoord in HubSpot zelf kunt nakijken. Zo zie je in één keer of Claude het juiste account gebruikt en of hij evenveel ziet als jij.

Eerste prompt (plak in een gesprek met HubSpot aan)

Gebruik HubSpot. Vertel me met welk HubSpot-account en welke gebruiker je verbonden bent. Tel daarna het aantal contacten en het aantal open deals dat je kunt zien, en de open deals per pipeline-fase. Noem bij elk getal welke filter je hebt gebruikt. Wijzig niets.

Zo controleer je de uitkomst

Leg de getallen naast HubSpot: de teller boven je contactenlijst en het dealbord met dezelfde filter. Kloppen ze, dan werkt de koppeling. Ziet Claude minder dan jij verwacht, dan ligt dat bijna altijd aan rechten: aan jouw HubSpot-gebruiker of aan de optionele rechten die de Super Admin uit heeft gezet. Noemt Claude een ander account, ontkoppel dan en kies bij het inloggen het goede.

Test daarna één schrijfactie

Vraag: "Maak een taak aan bij mijn eigen contactpersoon in HubSpot: testtaak Claude, deadline morgen." Claude toont eerst de voorgestelde wijziging en vraagt om bevestiging. Antwoord met ja. Claude bevestigt en geeft een link naar het record. Open die link en verwijder de testtaak zelf in HubSpot, want Claude kan niets verwijderen. Krijg je geen goedkeuringsvraag, dan staat je schrijfgroep op Always allow; zet hem terug volgens stap 5.

Salesprompts

Drie salesprompts voor een mkb-team in HubSpot

Dit zijn drie prompts voor het werk dat in een klein salesteam elke week terugkomt: de pijplijn bijhouden, een gesprek voorbereiden en na het gesprek het CRM bijwerken. De eerste twee lezen alleen. De derde schrijft, met jouw akkoord. Pas de fasenamen en termijnen aan op je eigen pipeline.

Prompt 1: de maandagbrief van je pijplijn (alleen lezen)

#CONTEXT
Ik ben salesmanager bij een Nederlands mkb-bedrijf. We werken in HubSpot met de pipeline "Verkoop". Ik wil maandag weten waar actie nodig is.
#DOEL
Een lijst met deals die aandacht nodig hebben.
#WERKWIJZE
1. Zoek alle open deals in de pipeline Verkoop.
2. Markeer deals zonder activiteit in de laatste 14 dagen, deals met een sluitdatum in het verleden en deals zonder volgende taak.
#OUTPUT
Een tabel met dealnaam, eigenaar, fase, bedrag, laatste activiteit en het probleem. Daaronder drie zinnen voor het teamoverleg.
#BELANGRIJKE REGELS
Gebruik alleen gegevens uit HubSpot. Wijzig niets. Noem per deal de link naar het record.

Prompt 2: een gesprek voorbereiden (alleen lezen)

#CONTEXT
Ik bel morgen met [bedrijfsnaam]. Ik wil binnen vijf minuten weten wat er speelt.
#DOEL
Een belvoorbereiding op één scherm.
#WERKWIJZE
Zoek het bedrijf in HubSpot en haal op: de contactpersonen met functie, open en gesloten deals, open tickets en de laatste vijf activiteiten (mails, calls, notities).
#OUTPUT
Een korte samenvatting, wat er sinds het laatste contact is gebeurd, open toezeggingen van onze kant en drie vragen die ik kan stellen.
#BELANGRIJKE REGELS
Zet bij elke bewering waar je hem in HubSpot vond. Weet je iets niet, schrijf dan "niet gevonden in HubSpot". Wijzig niets.

Prompt 3: na het gesprek het CRM bijwerken (schrijft, met akkoord)

#CONTEXT
Hieronder staan mijn aantekeningen van het gesprek met [contactpersoon] van [bedrijfsnaam] vandaag.
[plak hier je aantekeningen]
#DOEL
HubSpot bijwerken zonder dat ik zelf ga typen.
#WERKWIJZE
1. Stel een notitie op bij het contact met de kern van het gesprek, maximaal tien regels.
2. Stel een taak voor mij op voor de afgesproken vervolgstap, met deadline.
3. Stel voor of de deal van fase moet veranderen en waarom.
#OUTPUT
Toon eerst alle drie de wijzigingen als voorstel. Voer pas iets uit als ik per wijziging ja zeg.
#BELANGRIJKE REGELS
Zet geen gezondheids-, privé- of andere gevoelige informatie in de notitie. Wijzig geen andere velden dan deze drie.

Waarom deze opbouw werkt

De regel "wijzig niets" in prompt 1 en 2 is een tweede slot naast je toolrechten. De bronvermelding per bewering in prompt 2 maakt controleren snel: klikt de link niet, dan klopt de bewering niet. En in prompt 3 laat je Claude eerst voorstellen en daarna pas schrijven. Dat sluit aan op de goedkeuringsvraag die Claude bij Needs approval toch al stelt. Meer ideeën voor AI in sales staan in AI-sales-tips.

Rechten en AVG

Schrijfrechten beperken en wat er met je klantgegevens gebeurt

Er zijn drie lagen die bepalen wat Claude in HubSpot mag. De Super Admin zet het plafond voor het account. Je HubSpot-gebruiker bepaalt wat jij ziet. En de toolrechten in Claude bepalen of Claude zonder vragen mag schrijven. Gebruik ze alle drie.

Toolrechten: wat je op 28 oktober 2026 ziet

Bij onze controle had de HubSpot-connector 16 Read-only tools, zoals Search CRM objects en Query CRM data, en 11 Write/delete tools, zoals Manage CRM objects, Manage blog post en Manage Segments. Per groep of per tool kies je Always allow, Needs approval of Blocked. Ons advies: lezen op Always allow, schrijven op Needs approval. Wil je marketing er nog buiten houden, zet dan alleen Manage blog post, Manage landing page en Manage website page op Blocked. Bij Team en Enterprise stelt de Owner dit in voor de organisatie en kan een lid het niet ruimer zetten.

Wie wat ziet: twee verwerkers

HubSpot verwerkt de aanvraag en stuurt die voor accounts in de EU via het EU-datacenter van HubSpot; daarvoor geldt je bestaande verwerkersovereenkomst met HubSpot. Zodra de gegevens in je gesprek staan, gelden de voorwaarden van Anthropic. Anthropic slaat zakelijke data standaard op in de Verenigde Staten, met verwerking ook in andere regio's. HubSpot verzamelt daarnaast samenvattingen van de toolaanroepen, met geanonimiseerde namen van personen, bedrijven en deals. Zet de koppeling in je verwerkingsregister en lees waar je Claude-data staat.

Dataminimalisatie in de praktijk

Vraag om wat je nodig hebt, niet om alles. "Welke open deals hebben geen volgende taak?" haalt een handvol records op; "geef me al mijn contacten" zet een complete klantenlijst in een gesprek. Zet Sensitive Data in HubSpot aan als je bijzondere persoonsgegevens bewaart: dan kan Claude die velden niet lezen. Op Enterprise kan een beheerder ook verbindingen blokkeren met HubSpot-accounts buiten de geverifieerde domeinen van je organisatie.

Waarom Needs approval ook tegen misbruik helpt

Claude leest in HubSpot ook tekst die van buiten komt: mails van prospects, chatberichten, formulierinvoer. Daar kan iemand een verborgen opdracht in zetten, een aanval die prompt injection heet. Met Needs approval kan zo'n opdracht nooit stil een record wijzigen; jij ziet elk voorstel eerst. Wijzigingen die wel doorgaan, staan in de Audit Log van HubSpot op naam van jou en de connector.

Claude Code

HubSpot gebruiken in Claude Code

In Claude Code hoef je HubSpot meestal niet opnieuw te koppelen. Connectors die je in claude.ai hebt verbonden, verschijnen automatisch in Claude Code zolang je daar met hetzelfde Claude-abonnement bent ingelogd. Dat is de route die we beginners aanraden.

Liever een eigen koppeling, bijvoorbeeld voor een script?

Ontwikkelaars kunnen in HubSpot een eigen MCP-connector maken: Development > MCP Connectors > Create MCP connector, met als redirect-URL http://localhost:8080/callback. Je krijgt een client-ID en client secret. Daarna in de terminal: claude mcp add --transport http --client-id JOUW_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com en in Claude Code /mcp om in te loggen. Let op: HubSpot noemt in zijn eigen documentatie geen Claude Code-commando; deze combinatie volgt uit de documentatie van HubSpot (OAuth met PKCE) en die van Claude Code (vooraf ingestelde OAuth-gegevens). Hoe je servers toevoegt, staat in MCP-server toevoegen.

Niet verwarren met de HubSpot Developer MCP-server

Wie op "hubspot mcp" zoekt, vindt ook hs mcp setup. Dat installeert de Developer MCP-server via de HubSpot CLI (versie 8.2.0 of hoger). Die is bedoeld om HubSpot-apps en CMS-content te bouwen in je code-editor, niet om je CRM te bevragen. Voor contacten en deals gebruik je de connector.

En de HubSpot Sales-plugin?

In de directory staat onder Customize > Plugins ook HubSpot Sales, een plugin van HubSpot (open source, Apache-2.0) met kant-en-klare salesstappen zoals call prep, daily brief en follow-up. Hij werkt op dezelfde HubSpot MCP-server. Begin met de losse connector en de prompts hierboven; neem de plugin pas als je ziet welke stappen je echt herhaalt. Wat plugins zijn, lees je op Claude-plugins.

Problemen

Problemen met Claude en HubSpot: melding, oorzaak, oplossing

De meeste problemen met de HubSpot-connector gaan over rechten, niet over techniek. Begin bij een vreemd resultaat dus bij de vraag wie wat heeft goedgekeurd.

Ons oordeel

Ons oordeel: wanneer je Claude aan HubSpot koppelt en wanneer niet

Doen, als je team al in HubSpot werkt. Het is een officiële koppeling van HubSpot zelf, hij volgt je bestaande HubSpot-rechten en hij kan niets verwijderen. Dat maakt hem een van de veiligere connectors om mee te beginnen, mits je de schrijfrechten bewust instelt.

Doe het wel als

Je verkopers tijd kwijt zijn aan gespreksvoorbereiding, pijplijnoverzichten en het bijwerken van het CRM na een gesprek. Juist dat werk doet Claude goed: veel records lezen, samenvatten en een paar wijzigingen voorstellen. Begin met alleen lezen voor het hele team, en geef schrijfrechten (met Needs approval) eerst aan één of twee mensen.

Doe het niet, of nog niet, als

Je bijzondere persoonsgegevens in HubSpot bewaart zonder Sensitive Data aan te zetten. Als je team op Claude Pro of Max met klantdata wil werken zonder verwerkersovereenkomst. Als je wilt dat er automatisch iets gebeurt bij een nieuwe lead: dat is een workflow, geen chatgesprek. Of als het doel een grote opschoning van duizenden records is; met tien records per opdracht doe je dat beter met de importfunctie van HubSpot.

De fout die we beginners het vaakst zien maken

De schrijfgroep op Always allow zetten omdat de goedkeuringsvraag na een dag lastig voelt. Daarna volgt een vage opdracht als "werk de deals van deze week bij", en Claude verandert fases of velden op basis van een eigen interpretatie. Claude kent jullie afspraken niet: wat een gekwalificeerde lead is of wanneer een deal naar Offerte gaat. Houd Needs approval aan en zet je definities in de projectinstructies van een Claude-project "Sales", zodat elke vraag met jullie spelregels begint.

Wat nu?

Wat nu? Vervolgstappen na je eerste HubSpot-vraag in Claude

Werkt de koppeling, gebruik dan twee weken alleen prompt 1 en 2 met je team. Je ziet snel welke vraag elke week terugkomt. Die maak je daarna vast.

Vastleggen en herhalen

Maak een Claude-project "Sales" met je pipeline-fasen, leaddefinities en de drie prompts in de instructies. Plan de maandagbrief als terugkerende taak via Scheduled in de zijbalk; werken met taken en de agentmodus lees je bij Claude Cowork. Werkt je team in Slack, koppel dan ook Claude aan Slack en laat de brief daar landen. Moet het reageren op gebeurtenissen in HubSpot, kijk dan bij n8n, Make en Zapier.

Verder lezen

MCP en connectors legt uit hoe koppelingen in Claude werken. Claude privacy en zakelijk gebruik helpt bij de AVG-vragen van je directie. Mail je klanten vanuit Outlook, lees dan Claude in Outlook. En leg de spelregels voor AI met klantdata vast in je AI-beleid, voordat iemand de schrijfrechten ruimer zet.

Een vaste salesworkflow laten bouwen

Wil je dat "na elk gesprek het CRM bijwerken" een vaste werkwijze wordt, met heldere rechten en een instructie die het hele team gebruikt, dan bouw je die in de Agent Sprint in twee weken samen met je eigen team.