Hubspot Mcp Server

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.