HubSpot MCP-Server: Welcher Weg passt, was er kann und wo er aufhört

HubSpot MCP-Server: Welcher Weg passt, was er kann und wo er aufhört

Ja, HubSpot hat einen offiziellen MCP-Server. Der Remote-Server unter https://mcp.hubspot.com erlaubt Claude, ChatGPT und anderen MCP-Clients, Datensätze in Ihrem HubSpot-Account zu lesen und zu ändern. Seit dem 13. April 2026 ist er für alle HubSpot-Accounts allgemein verfügbar. Arbeiten Sie mit Claude oder ChatGPT, müssen Sie nichts bauen: Sie installieren den fertigen Connector von HubSpot und melden sich an. Einen eigenen MCP-Connector in HubSpot legen Sie nur für andere Clients an.

Daneben gibt es einen zweiten, davon unabhängigen Server für Entwickler, der lokal über die HubSpot CLI läuft. Die meisten Missverständnisse rund um „HubSpot MCP“ entstehen, weil diese beiden Server verwechselt werden, oder weil HubSpots Server mit den vielen Community-Servern auf GitHub in einen Topf kommt.

Offenlegung: Customermates, ein Open-Source-CRM mit eigenem MCP-Server, veröffentlicht diesen Leitfaden. Die Angaben zu HubSpot wurden am 8. Oktober 2026 auf HubSpots eigenen Seiten geprüft; die Quellen stehen am Ende.

Auf einen Blick

Remote-Server

Von HubSpot gehostet unter mcp.hubspot.com. Liest und schreibt CRM-Datensätze, Aktivitäten und Marketinginhalte, immer im Rahmen der HubSpot-Berechtigungen des angemeldeten Nutzers.

Schnellster Weg

Claude und ChatGPT: HubSpot-Connector installieren und per OAuth anmelden. Laut HubSpot ist der Claude-Connector in allen HubSpot-Stufen kostenlos.

Andere Clients

MCP-Connector unter Development in HubSpot anlegen, dann Client-ID und Client-Secret in einem Client nutzen, der OAuth mit PKCE beherrscht.

Wichtigste Grenzen

Bei aktivierten sensiblen Daten sind Aktivitäten und Konversationen gesperrt, der dokumentierte Schreibzugriff kennt kein Löschen, und einige Werkzeuge setzen bezahlte Hubs voraus.

Zuerst den passenden Weg wählen

Auf die Frage „Wie verbinde ich HubSpot per MCP?“ gibt es vier Antworten. Welche gilt, hängt vom Client und von der Aufgabe ab.

Server von Drittanbietern sind eine fünfte Möglichkeit. Zapier bietet zum Beispiel HubSpot-Aktionen über einen eigenen MCP-Server unter mcp.zapier.com an, und auf GitHub finden sich mehrere Community-Server für HubSpot, die Sie selbst betreiben. Das lohnt sich, wenn ein einziger MCP-Server viele Apps abdecken soll. Es ist aber nicht HubSpots Server: Umfang, Pflege und Datenverarbeitung bestimmt der jeweilige Anbieter.

Was der Remote-Server lesen und schreiben kann

HubSpots Integrationsleitfaden beschreibt den Zugriff ausführlich. Kurz gefasst:

Zwei Details sind für die Planung wichtig. Der Server baut auf HubSpots CRM-Such-API auf, die laut HubSpot keine Vektorsuche hat. Die KI findet Datensätze also über Filter und Eigenschaften, nicht über Bedeutung. Und beim Anlegen oder Ändern greift die bedingte Feldlogik des Accounts samt den Validierungen der Pipeline-Phasen: Ein Pflichtfeld, das ein Mensch nicht überspringen kann, überspringt auch die KI nicht.

Grenzen laut HubSpot

• Sensible Daten sperren Aktivitäten. Ist im Account die Funktion für sensible Daten aktiviert, sind Anrufe, E-Mails, Meetings, Notizen, Aufgaben und Konversationen über den MCP-Server gesperrt. HubSpot betont, dass das nur für MCP gilt und nicht für die normalen CRM-APIs.
• Kein Löschen. Der dokumentierte Schreibzugriff umfasst Anlegen, Bearbeiten, Protokollieren und Veröffentlichen. Löschen ist nicht aufgeführt; Aufräumen bleibt Handarbeit in HubSpot.
• Berechtigungen gelten weiter. Jeder Aufruf läuft als der angemeldete Nutzer und respektiert dessen HubSpot-Rechte. Ein Postfach, das auf bestimmte Nutzer oder Teams beschränkt ist, bleibt auch über MCP beschränkt.
• Berechtigungen (Scopes) werden bei der Installation festgelegt. Sie wählen die Scopes nicht selbst. Sie ergeben sich aus den Werkzeugen, die zum Installationszeitpunkt verfügbar sind, und aus den Rechten, die der Nutzer erteilt. Kommen neue Werkzeuge hinzu, müssen bestehende Nutzer neu installieren.
• Manche Werkzeuge brauchen bezahlte Hubs. AEO-Kennzahlen und verfolgte Prompts setzen Marketing Hub Professional oder Enterprise voraus, Angebote Revenue Hub Professional oder Enterprise.
• Auswertungen sind begrenzt. Das SQL-Werkzeug filtert, aggregiert und sortiert, kann laut HubSpot aber keine Joins, Unterabfragen, Assoziationen durchlaufen oder Währungen umrechnen. Für Fragen wie „Gewinnrate nach Phasenwechsel im letzten Quartal“ braucht die KI mehrere Aufrufe, oder Sie bauen den Bericht in HubSpot.

Verbinden: der eigene Connector Schritt für Schritt

Bei Claude und ChatGPT erledigt der Connector alles Folgende. Für jeden anderen Client beschreibt HubSpot diesen Ablauf:

1. MCP-Connector anlegen

   Öffnen Sie in HubSpot Development, dann MCP Connectors, dann Create MCP connector. Tragen Sie einen Namen, optional eine Beschreibung und die Redirect-URL Ihres Clients ein. Für Tests mit dem MCP Inspector verlangt HubSpot zusätzlich http://localhost:6274/oauth/callback/debug.

2. Zugangsdaten kopieren

   Die Detailseite des Connectors zeigt Client-ID, Client-Secret und Redirect-URLs. Die Redirect-URL muss exakt mit der im Client hinterlegten übereinstimmen.

3. Client mit dem Server verbinden

   Konfigurieren Sie Ihren Client mit https://mcp.hubspot.com und den Zugangsdaten. Der Client muss den OAuth-Ablauf mit PKCE ausführen. Der MCP Inspector macht das automatisch; in einer eigenen Integration implementieren Sie es selbst.

4. Freigeben und prüfen

   Wählen Sie den HubSpot-Account, erteilen Sie die Rechte und bestätigen Sie. Rufen Sie danach get_user_details auf: HubSpot empfiehlt das, um zu sehen, welche Werkzeuge und Objekte Ihr Account tatsächlich nutzen kann.

Funktioniert ein Client nach längerer Pause nicht mehr, liegt es meist am Token-Refresh. Der Client muss das Refresh-Token aus der ersten Anmeldung verwenden; ist auch das abgelaufen, starten Sie den OAuth-Ablauf neu.

Der HubSpot-Entwickler-MCP-Server

Der Entwickler-MCP-Server läuft auf Ihrem Rechner und wird mit hs mcp setup eingerichtet (HubSpot CLI ab Version 8.2.0). Er arbeitet mit Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code und Windsurf und erscheint dort als „HubSpotDev“. HubSpot beschreibt ihn als Werkzeugsatz für die App- und CMS-Entwicklung. Für einen Vertrieb, der mit CRM-Datensätzen arbeiten will, ist er nicht gedacht; das ist Aufgabe des Remote-Servers.

Checkliste für die Einführung im kleinen Team

1. Zuerst die sensiblen Daten prüfen. Ist die Funktion aktiv, sieht MCP weder Aktivitäten noch Konversationen, und damit fallen die meisten nützlichen Fragen zu einem Deal weg. Das sollten Sie wissen, bevor jemand es ausprobiert.
2. Nutzerrechte in HubSpot durchsehen. Die KI sieht genau das, was der Nutzer sieht. Darf ein Nutzer jeden Deal bearbeiten, darf es sein verbundener Client auch.
3. Mit Lesen beginnen. Gute erste Prompts: „Zusammenfassung der letzten fünf Aktivitäten am Deal Müller GmbH“, „Welche offenen Deals in der Phase Angebot haben seit 14 Tagen keine Aktivität?“, „Alle Kontakte bei Müller GmbH mit ihrem letzten Meeting.“
4. Dann das Protokollieren freigeben. „Notiz am Deal Müller GmbH anlegen: Telefonat am Dienstag, Budget freigegeben, Vertragsentwurf folgt.“ Kontrollieren Sie die Notiz danach in HubSpot.
5. Veröffentlichen bleibt in Menschenhand. Der Server kann Landingpages und Blogbeiträge veröffentlichen. Legen Sie fest, wer eine KI darum bitten darf, bevor es versehentlich passiert.
6. Konten einschränken, wo möglich. HubSpot weist darauf hin, dass Admins von Claude Enterprise den Connector über verifizierte Domains auf firmeneigene Konten beschränken können.

Ein Punkt zum Datenschutz: Was der KI-Client aus HubSpot liest, verarbeitet der Anbieter dieses Clients. Ihr Auftragsverarbeitungsvertrag mit HubSpot deckt diese Strecke nicht ab. Prüfen Sie deshalb die Bedingungen des KI-Anbieters und Ihr Verzeichnis von Verarbeitungstätigkeiten, bevor Kundendaten über MCP fließen. Laut HubSpots Marketplace-Eintrag ist der Chat im ChatGPT-Connector im Tarif ChatGPT Pro für Nutzer im EWR, in der Schweiz und im Vereinigten Königreich derzeit nicht verfügbar.

Wenn das CRM selbst einen MCP-Server mitbringt

Stehen Sie vor der Wahl eines CRM, statt ein bestehendes anzubinden, ist ein im CRM eingebauter MCP-Server die Alternative. Customermates ist ein Beispiel: Der Endpunkt unter /api/v1/mcp gehört zu jedem Cloud-Tarif und zu jeder selbst gehosteten Installation. In Claude und ChatGPT fügen Sie ihn als Custom Connector hinzu und melden sich an (Einrichtung); Claude Code, Codex, Cursor und Gemini CLI verbinden sich mit einem API-Key (CLI-Einrichtung). Ein verbundener Client findet 53 Werkzeuge, und über einen URL-Parameter lässt sich die Auswahl eingrenzen, wie die MCP-Referenz beschreibt.

Dass Löschen und Senden möglich sind, hat zwei Seiten. Der Customermates-Server fordert verbundene Clients auf, vor dem Löschen oder Senden nachzufragen. Das ist eine Anweisung an den Client, keine Sperre im Server: Ruft ein berechtigter Client ein Werkzeug auf, wird es ausgeführt. Prüfen Sie, wie Ihr Client Freigaben handhabt, und beginnen Sie wie bei HubSpot mit Lesen und Entwürfen.

Auch die Kosten sind anders verteilt. MCP ist ab Starter für 12 € pro Nutzer und Monat enthalten; die Posteingangs-Werkzeuge brauchen Pro für 29 €. Ein externer KI-Client läuft über Ihr eigenes KI-Abo, nicht über Customermates-Credits. Wer gar keinen externen Client anbinden möchte, kann in Customermates Cloud Mate nutzen, einen Assistenten in der App, der gehostete KI-Credits verbraucht (Mate-Dokumentation).

Customermates passt nicht, wenn Sie auf HubSpots Marketing-Werkzeuge, den Help Desk oder die Umsatzobjekte angewiesen sind; nichts davon gibt es dort. Bleiben Sie bei HubSpot, nutzen Sie HubSpots Server. Erwägen Sie einen Wechsel, zeigt der Vergleich mit HubSpot die Unterschiede, und der Leitfaden zu Salesforce MCP erklärt die entsprechenden Server bei Salesforce.

Häufig gestellte Fragen

Quellen: Angaben zu HubSpot am 8. Oktober 2026 geprüft im Integrationsleitfaden zum Remote-MCP-Server, im Changelog zur allgemeinen Verfügbarkeit, in der Einrichtungsanleitung für den Entwickler-MCP-Server, auf HubSpots Seite zum Claude-Connector, im Marketplace-Eintrag zum ChatGPT-Connector, auf HubSpot AI Tools und auf Zapiers Seite zu HubSpot MCP.