HubSpot MCP

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

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.