Integrations
Provides integration with HubSpot CRM, enabling AI models to interact with HubSpot data including contacts, companies, and engagements. Offers tools for retrieving, creating, and managing HubSpot objects, as well as accessing recent engagement history.
HubSpot MCP Server
Overview
A Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. This server bridges AI models with your HubSpot account, providing direct access to contacts, companies, and engagement data. Built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.
Our implementation prioritizes the most frequently used, high-value HubSpot operations with robust error handling and API stability. Each component is optimized for AI-friendly interactions, ensuring reliable performance even during complex, multi-step CRM workflows.
Why MCP-HubSpot?
- Direct CRM Access: Connect Claude and other AI assistants to your HubSpot data without intermediary steps
- Context Retention: Vector storage with FAISS enables semantic search across previous interactions
- Zero Configuration: Simple Docker deployment with minimal setup
Example Prompts
Available Tools
The server offers tools for HubSpot management and data retrieval:
Tool | Purpose |
---|---|
hubspot_create_contact | Create contacts with duplicate prevention |
hubspot_create_company | Create companies with duplicate prevention |
hubspot_get_company_activity | Retrieve activity for specific companies |
hubspot_get_active_companies | Retrieve most recently active companies |
hubspot_get_active_contacts | Retrieve most recently active contacts |
hubspot_get_recent_conversations | Retrieve recent conversation threads with messages |
hubspot_search_data | Semantic search across previously retrieved HubSpot data |
Performance Features
- Vector Storage: Utilizes FAISS for efficient semantic search and retrieval
- Thread-Level Indexing: Stores each conversation thread individually for precise retrieval
- Embedding Caching: Uses SentenceTransformer with automatic caching
- Persistent Storage: Data persists between sessions in configurable storage directory
- Multi-platform Support: Optimized Docker images for various architectures
Setup
Prerequisites
You'll need a HubSpot access token with these scopes:
- crm.objects.contacts (read/write)
- crm.objects.companies (read/write)
- sales-email-read
Quick Start
Docker Configuration
For manual configuration in Claude desktop:
Building Docker Image
To build the Docker image locally:
For multi-platform builds:
Development
License
MIT License
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Enables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA server that enables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management with multi-user token-based authentication.Last updated -PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol implementation for the HubSpot API that provides a standardized interface for accessing and managing CRM data, including companies, contacts, deals, and other objects with comprehensive CRUD operations and association management.Last updated -101769JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides tools for interacting with HubSpot CRM, allowing users to create, update, delete, and fetch summary records stored as Note engagements in HubSpot.Last updated -JavaScriptMIT License
- AsecurityAlicenseAqualityEnables AI models to interact with HubSpot CRM data and operations through a standardized interface while providing a centralized shared space for teams to share conversation summaries in real time.Last updated -8PythonMIT License