HubSpot MCP

Eine Model Context Protocol (MCP) -Implementierung für die HubSpot -API, die eine standardisierte Schnittstelle für den Zugriff auf und die Verwaltung von CRM-Daten bietet.

Merkmale

• Vollständige Abdeckung der HubSpot CRM-API

• Unterstützung für alle Standard-CRM-Objekte (Unternehmen, Kontakte, Deals usw.)

• Erweitertes Verbandsmanagement mit CRM Associations v4

• Unternehmensspezifische Endpunkte mit Eigenschaftsvalidierung

• Stapelverarbeitung für effizientes Datenmanagement

• Erweiterte Such- und Filterfunktionen

• Typsichere Parametervalidierung mit Zod

Related MCP server: HubSpot MCP Server

Voraussetzungen

Wenn Sie keinen API-Schlüssel haben, folgen Sie den Schritten hier, um ein Zugriffstoken zu erhalten. OAuth-Unterstützung ist als zukünftige Erweiterung geplant.

Client-Konfiguration

Es gibt verschiedene Möglichkeiten, Ihren MCP-Client mit dem Server zu konfigurieren. Für die Einrichtung eines gehosteten/Remote-Servers verwenden Sie die Smithery-CLI mit einem Smithery-API-Schlüssel . Für die lokale Installation verwenden Sie npx oder erstellen Sie aus dem Quellcode. Jede dieser Optionen wird unten erläutert.

Smithery Remote Server (empfohlen)

Um einen Remote-Server zu Ihrer MCP-Client config.json hinzuzufügen, führen Sie den folgenden Befehl von der Smithery-Befehlszeilenschnittstelle aus:

Geben Sie Ihr HUBSPOT_ACCESS_TOKEN ein, wenn Sie dazu aufgefordert werden.

Smithery SDK

Wenn Sie Ihre eigene Agentenanwendung entwickeln, können Sie den hier enthaltenen Boilerplate-Code verwenden.

Lokale NPX-Installation

Um den Server lokal mit npx zu installieren, fügen Sie Folgendes zu Ihrer MCP-Client- config.json hinzu:

Aus der Quelle erstellen

1. Laden Sie das Repo herunter:

2. Pakete installieren (innerhalb des geklonten Repo):

3. Fügen Sie Folgendes zu Ihrer MCP-Client config.json hinzu:

Konfigurationsvariablen

Unterstützte Tools

CRM-Kernobjekte

Grundlegende Objektoperationen

• crm_list_objects : Listet CRM-Objekte mit optionaler Filterung und Paginierung auf

• crm_get_object : Holen Sie sich ein einzelnes CRM-Objekt nach ID

• crm_create_object : Erstellen Sie ein neues CRM-Objekt

• crm_update_object : Aktualisieren Sie ein vorhandenes CRM-Objekt

• crm_delete_object : Ein CRM-Objekt löschen

Such- und Batchvorgänge

• crm_search_objects : Suche nach CRM-Objekten mit erweiterten Filtern

• crm_batch_create_objects : Erstellen Sie mehrere Objekte in einer einzigen Anfrage

• crm_batch_update_objects : Aktualisieren Sie mehrere Objekte in einer einzigen Anfrage

• crm_batch_delete_objects : Löschen Sie mehrere Objekte in einer einzigen Anfrage

CRM-Datensatzverwaltung

Unternehmen

• Grundlegende Operationen:

  • crm_create_company : Erstellen Sie ein neues Unternehmen mit validierten Eigenschaften

  • crm_update_company : Aktualisieren Sie ein vorhandenes Unternehmen

  • crm_get_company : Holen Sie sich ein einzelnes Unternehmen nach ID

  • crm_search_companies : Suche nach Unternehmen mit spezifischen Filtern

• Stapelverarbeitung:

  • crm_batch_create_companies : Erstellen Sie mehrere Unternehmen in einer einzigen Anfrage

  • crm_batch_update_companies : Aktualisieren Sie mehrere Unternehmen in einer einzigen Anfrage

• Hausverwaltung:

  • crm_get_company_properties : Alle verfügbaren Firmeneigenschaften abrufen

  • crm_create_company_property : Erstellen Sie eine neue Firmeneigenschaft

Kontakte

• Grundlegende Operationen:

  • crm_create_contact : Erstellen Sie einen neuen Kontakt mit validierten Eigenschaften

  • crm_update_contact : Aktualisieren Sie die Informationen eines vorhandenen Kontakts

  • crm_get_contact : Einen einzelnen Kontakt nach ID abrufen

  • crm_search_contacts : Kontakte mit bestimmten Filtern suchen

• Stapelverarbeitung:

  • crm_batch_create_contacts : Erstellen Sie mehrere Kontakte in einer einzigen Anfrage

  • crm_batch_update_contacts : Aktualisieren Sie mehrere Kontakte in einer einzigen Anfrage

• Hausverwaltung:

  • crm_get_contact_properties : Alle verfügbaren Kontakteigenschaften abrufen

  • crm_create_contact_property : Erstellen Sie eine neue Kontakteigenschaft

Leads

• Grundlegende Operationen:

  • crm_create_lead : Erstellen Sie einen neuen Lead mit validierten Eigenschaften

  • crm_update_lead : Aktualisieren Sie die Informationen eines vorhandenen Leads

  • crm_get_lead : Holen Sie sich einen einzelnen Lead nach ID

  • crm_search_leads : Leads mit bestimmten Filtern suchen

• Stapelverarbeitung:

  • crm_batch_create_leads : Erstellen Sie mehrere Leads in einer einzigen Anfrage

  • crm_batch_update_leads : Aktualisieren Sie mehrere Leads in einer einzigen Anfrage

• Hausverwaltung:

  • crm_get_lead_properties : Alle verfügbaren Lead-Eigenschaften abrufen

  • crm_create_lead_property : Erstellen Sie eine neue Lead-Eigenschaft

Engagement Management

Verlobungsdetails

• Grundlegende Operationen:

  • engagement_details_get : Details zu einem bestimmten Engagement abrufen

  • engagement_details_create : Erstellen Sie ein neues Engagement

  • engagement_details_update : Aktualisieren Sie ein bestehendes Engagement

  • engagement_details_delete : Ein Engagement löschen

  • engagement_details_list : Listet alle Engagements mit Filterung auf

  • engagement_details_get_associated : Zugehörige Engagements abrufen

Anrufe

• Grundlegende Operationen:

  • calls_create : Einen neuen Anrufdatensatz erstellen

  • calls_get : Anrufdetails abrufen

  • calls_update : Einen Anrufdatensatz aktualisieren

  • calls_archive : Einen Anruf archivieren

  • calls_list : Listet alle Anrufe auf

  • calls_search : Anrufe suchen

• Stapelverarbeitung:

  • calls_batch_create : Mehrere Anrufe erstellen

  • calls_batch_read : Mehrere Anrufe lesen

  • calls_batch_update : Mehrere Anrufe aktualisieren

  • calls_batch_archive : Mehrere Anrufe archivieren

E-Mails

• Grundlegende Operationen:

  • emails_create : Einen neuen E-Mail-Datensatz erstellen

  • emails_get : E-Mail-Details abrufen

  • emails_update : Eine E-Mail aktualisieren

  • emails_archive : Archivieren Sie eine E-Mail

  • emails_list : Listet alle E-Mails auf

  • emails_search : E-Mails suchen

• Stapelverarbeitung:

  • emails_batch_create : Mehrere E-Mails erstellen

  • emails_batch_read : Mehrere E-Mails lesen

  • emails_batch_update : Mehrere E-Mails aktualisieren

  • emails_batch_archive : Mehrere E-Mails archivieren

Tagungen

• Grundlegende Operationen:

  • meetings_create : Ein neues Meeting erstellen

  • meetings_get : Besprechungsdetails abrufen

  • meetings_update : Aktualisieren Sie ein Meeting

  • meetings_delete : Ein Meeting löschen

  • meetings_list : Alle Meetings auflisten

  • meetings_search : Suche nach Meetings

• Stapelverarbeitung:

  • meetings_batch_create : Mehrere Meetings erstellen

  • meetings_batch_update : Mehrere Meetings aktualisieren

  • meetings_batch_archive : Mehrere Meetings archivieren

Hinweise

• Grundlegende Operationen:

  • notes_create : Eine neue Notiz erstellen

  • notes_get : Notizdetails abrufen

  • notes_update : Eine Notiz aktualisieren

  • notes_archive : Archivieren Sie eine Notiz

  • notes_list : Listet alle Notizen auf

  • notes_search : Notizen suchen

• Stapelverarbeitung:

  • notes_batch_create : Mehrere Notizen erstellen

  • notes_batch_read : Mehrere Notizen lesen

  • notes_batch_update : Mehrere Notizen aktualisieren

  • notes_batch_archive : Mehrere Notizen archivieren

Aufgaben

• Grundlegende Operationen:

  • tasks_create : Eine neue Aufgabe erstellen

  • tasks_get : Aufgabendetails abrufen

  • tasks_update : Aktualisieren Sie eine Aufgabe

  • tasks_archive : Archivieren Sie eine Aufgabe

  • tasks_list : Alle Aufgaben auflisten

  • tasks_search : Aufgaben suchen

• Stapelverarbeitung:

  • tasks_batch_create : Mehrere Aufgaben erstellen

  • tasks_batch_read : Mehrere Aufgaben lesen

  • tasks_batch_update : Mehrere Aufgaben aktualisieren

  • tasks_batch_archive : Mehrere Aufgaben archivieren

Assoziationen und Beziehungen

CRM-Verknüpfungen v4

• Grundlegende Operationen:

  • crm_list_association_types : Liste der verfügbaren Assoziationstypen

  • crm_get_associations : Alle Assoziationen zwischen Objekten abrufen

  • crm_create_association : Erstellen Sie eine Zuordnung

  • crm_delete_association : Eine Zuordnung löschen

• Stapelverarbeitung:

  • crm_batch_create_associations : Mehrere Assoziationen erstellen

  • crm_batch_delete_associations : Mehrere Verknüpfungen löschen

Kommunikationspräferenzen

Abonnementverwaltung

• Grundlegende Operationen:

  • communications_get_preferences : Kontakteinstellungen abrufen

  • communications_update_preferences : Kontakteinstellungen aktualisieren

  • communications_unsubscribe_contact : Globale Abmeldung

  • communications_subscribe_contact : Globales Abonnement

  • communications_get_subscription_definitions : Abonnementdefinitionen abrufen

• Massenvorgänge:

  • communications_get_subscription_status : Status für mehrere Kontakte abrufen

  • communications_update_subscription_status : Aktualisierungsstatus für mehrere Kontakte

Produkte

Grundlegende Operationen:

• products_create : Erstellen Sie ein Produkt mit den angegebenen Eigenschaften und geben Sie eine Kopie des Objekts einschließlich der ID zurück.

• products_read : Liest ein durch die ID identifiziertes Objekt

• products_update : Führt eine Teilaktualisierung eines durch die ID identifizierten Objekts durch. Schreibgeschützte und nicht vorhandene Eigenschaften führen zu einem Fehler. Eigenschaftswerte können durch Übergabe einer leeren Zeichenfolge gelöscht werden.

• products_archive : Verschieben Sie ein durch die ID identifiziertes Objekt in den Papierkorb.

• products_list : Lesen Sie eine Produktseite. Steuern Sie die Rückgabe über den Abfrageparameter properties “. after “ ist das Paging-Cursor-Token der letzten erfolgreich gelesenen Ressource und wird als JSON-Eigenschaft „ paging.next.after “ einer paginierten Antwort mit weiteren Ergebnissen zurückgegeben.

• products_search : Produkte suchen

Stapelverarbeitung:

• products_batch_create : Erstellen Sie eine Charge von Produkten

• products_batch_read : Lesen Sie eine Produktgruppe anhand der internen ID oder eindeutiger Eigenschaftswerte. Rufen Sie Datensätze über den Parameter idProperty ab, um Datensätze anhand einer benutzerdefinierten eindeutigen Werteigenschaft abzurufen.

• products_batch_update : Aktualisieren Sie eine Produktgruppe anhand der internen ID oder eindeutiger Werte, die durch den Abfrageparameter idProperty angegeben werden.

• products_batch_archive : Archivieren Sie eine Charge von Produkten nach ID

Beitragen

Beiträge sind willkommen und erwünscht! Bitte lesen Sie CONTRIBUTING.md für Richtlinien zu Problemen, Beiträgen und Kontaktinformationen.