HubSpot MCP Server

HubSpot MCP Server

Visão Geral

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA interajam com dados do CRM HubSpot. Este servidor conecta modelos de IA à sua conta HubSpot, fornecendo acesso direto a contatos, empresas e dados de engajamento. Mecanismos integrados de armazenamento vetorial e cache ajudam a superar as limitações da API do HubSpot, melhorando os tempos de resposta.

Nossa implementação prioriza as operações do HubSpot mais usadas e de alto valor, com tratamento robusto de erros e estabilidade da API. Cada componente é otimizado para interações amigáveis à IA, garantindo desempenho confiável mesmo em fluxos de trabalho complexos de CRM com várias etapas.

Por que MCP-HubSpot?

• Acesso Direto ao CRM: Conecte o Claude e outros assistentes de IA aos seus dados do HubSpot sem etapas intermediárias
• Retenção de Contexto: O armazenamento vetorial com FAISS permite busca semântica em interações anteriores
• Zero Configuração: Implantação simples com Docker e configuração mínima

Exemplos de Prompts

Create HubSpot contacts and companies from this LinkedIn profile:
[Paste LinkedIn profile text]

What's happening lately with my pipeline?

Ferramentas Disponíveis

O servidor oferece ferramentas para gerenciamento do HubSpot e recuperação de dados:

Ferramenta	Finalidade
hubspot_create_contact	Criar contatos com prevenção de duplicatas
hubspot_create_company	Criar empresas com prevenção de duplicatas
hubspot_get_company_activity	Recuperar atividade de empresas específicas
hubspot_get_active_companies	Recuperar empresas mais recentemente ativas
hubspot_get_active_contacts	Recuperar contatos mais recentemente ativos
hubspot_get_recent_conversations	Recuperar tópicos de conversa recentes com mensagens
hubspot_search_data	Busca semântica em dados do HubSpot previamente recuperados

Recursos de Desempenho

• Armazenamento Vetorial: Utiliza FAISS para busca e recuperação semântica eficientes
• Indexação em Nível de Tópico: Armazena cada tópico de conversa individualmente para recuperação precisa
• Cache de Embeddings: Usa SentenceTransformer com cache automático
• Armazenamento Persistente: Os dados persistem entre sessões em diretório de armazenamento configurável
• Suporte Multiplataforma: Imagens Docker otimizadas para várias arquiteturas

Configuração

Pré-requisitos

Você precisará de um token de acesso do HubSpot com estes escopos:

• crm.objects.contacts (read/write)
• crm.objects.companies (read/write)
• sales-email-read

Início Rápido

# Install via Smithery (recommended)
npx -y @smithery/cli@latest install mcp-hubspot --client claude

# Or pull Docker image directly
docker run -e HUBSPOT_ACCESS_TOKEN=your_token buryhuang/mcp-hubspot:latest

Configuração do Docker

Para configuração manual no Claude desktop:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
        "-v", "/path/to/storage:/storage",  # Optional persistent storage
        "buryhuang/mcp-hubspot:latest"
      ]
    }
  }
}

Construindo a Imagem Docker

Para construir a imagem Docker localmente:

git clone https://github.com/buryhuang/mcp-hubspot.git
cd mcp-hubspot
docker build -t mcp-hubspot .

Para builds multiplataforma:

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-hubspot:latest --push .

Desenvolvimento

pip install -e .

Licença

Licença MIT