HubSpot MCP Server
MCP (Model Context Protocol) server for integrating HubSpot with MCP clients (like Claude Desktop). Provides access to HubSpot contacts, companies, and deals through conversational tools.
🛠️ Available Tools
The server provides 18 tools for comprehensive HubSpot integration:
Category · Tools · Description
📋 Entity Listing · list_hubspot_contacts
list_hubspot_companies
list_hubspot_deals
list_hubspot_engagements · List and browse HubSpot entities with pagination support
🔧 Properties · get_hubspot_contact_properties
get_hubspot_company_properties
get_hubspot_deal_properties · Retrieve field properties and schemas for each entity type
🔍 Search & Filtering · search_hubspot_contacts
search_hubspot_companies
search_hubspot_deals · Advanced search with filters for each entity type
💼 Deal Management · get_deal_by_name
create_deal
update_deal · Complete deal lifecycle management
🤖 AI-Powered Search · semantic_search_hubspot
manage_hubspot_embeddings
browse_hubspot_indexed_data · Semantic search using natural language with FAISS vector database
⚡ Cache & Performance · load_hubspot_entities_to_cache
manage_hubspot_cache · Bulk loading, caching, and performance optimization
A complete documentation of the tools can be found here : Tools documentation
⚡ Usage Examples
Once fully installed and configured (following the complete installation guides), use natural language phrases with your MCP client:
🗣️ Natural Language Queries
- "List my HubSpot contacts"
- "Find tech sector companies"
- "Show current deals"
- "Create a new deal for Project X"
- "Search for the 'Project X' deal"
- "What contact properties are available?"
🤖 AI-Powered Semantic Search
- "Find software engineers" → matches "Developer", "Programmer", "Software Architect"
- "Search for enterprise clients" → finds large companies without exact keywords
- "Technology companies in Paris" → contextual location and industry search
A complete documentation of the differents usage can be found here : Usage examples
📚 Documentation Table of Contents
🚀 Getting Started
| Section | Description |
|---|---|
| Client Integration | Complete Guide for MCP Client Integration |
| Claude Desktop Integration | Complete guide for stdio and SSE modes with Claude Desktop |
🔧 Extra Features
| Section | Description |
|---|---|
| Semantic Search | AI-powered semantic search capabilities and usage |
| Cache System | How the shared TTL cache works and how to manage it |
| SSE Endpoints | REST API endpoints for health monitoring and data management |
🛠️ Development and Testing
| Section | Description |
|---|---|
| Developer Guide | Testing, quality assurance, and development workflow |
| MCP Inspector | Visual debugging and testing with MCP Inspector |
| Troubleshooting | Common issues and solutions |
| Integration Testing | Comprehensive testing procedures |
| Local Installation (stdio) | Install and run locally |
| Remote Deployment (SSE) | Deploy to Kubernetes for production use |
| Environment Setup | Advanced environment configuration |
📋 Quality Assurance: Pre-commit hooks ensure automatic code formatting, documentation linting, and broken link checking on every commit. Install with just install-dev.
🤝 Contributing
Check the contributing guide for:
- Development standards
- Tool creation process
- Code and testing conventions
- Git workflow and semantic versioning
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
