Hubspot Mcp Server
About
MCP server for integrating HubSpot with Claude Desktop and other MCP clients. Provides access to HubSpot contacts, companies, and deals through conversational tools.
Explore
- List and filter HubSpot contacts.
- List and filter HubSpot companies.
- List and filter HubSpot deals.
- Create new deals in HubSpot.
- Search for a deal by exact name.
- Retrieve contact, company, and deal field properties.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hubspot Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
git clone <repo-url>
cd hubspot-mcp-server
uv sync
```bash
Once configured, use natural language phrases:
- "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?"
- Python 3.12+
- uv (package manager)
- HubSpot API key with CRM permissions
list_hubspot_contacts
List and filter HubSpot contacts
list_hubspot_companies
List and filter HubSpot companies
list_hubspot_deals
List and filter HubSpot deals
create_deal
Create a new deal in HubSpot
get_deal_by_name
Search for a deal by exact name
get_hubspot_contact_properties
Retrieve contact field properties with types and descriptions
get_hubspot_company_properties
Retrieve company field properties with types and descriptions
get_hubspot_deal_properties
Retrieve deal field properties with types and descriptions
| Tool | Description |
|-------|-------------|
| list_hubspot_contacts | List and filter HubSpot contacts |
| list_hubspot_companies | List and filter HubSpot companies |
| list_hubspot_deals | List and filter HubSpot deals |
| create_deal | Create a new deal in HubSpot |
| get_deal_by_name | Search for a deal by exact name |
| get_hubspot_contact_properties | Retrieve contact field properties with types and descriptions |
| get_hubspot_company_properties | Retrieve company field properties with types and descriptions |
| get_hubspot_deal_properties | Retrieve deal field properties with types and descriptions |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hubspot mcp server": {
"hubspot": {
"command": "uv",
"args": [
"run",
"python",
"/path/to/your/project/main.py",
"--mode",
"stdio"
],
"env": {
"HUBSPOT_API_KEY": "your_hubspot_api_key"
}
}
}
}
}McpServers
{
"hubspot": {
"command": "uv",
"args": [
"run",
"python",
"/path/to/your/project/main.py",
"--mode",
"stdio"
],
"env": {
"HUBSPOT_API_KEY": "your_hubspot_api_key"
}
}
}MCP (Model Context Protocol) server for integrating HubSpot with Claude Desktop and other MCP clients. Provides access to HubSpot contacts, companies, and deals through conversational tools.
🚀 Quick Start
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
