HubSpot MCP Server
MCP server providing HubSpot CRM tools for contacts, companies, and deals.
Features
- Contacts: List, get, create, update, and search contacts
- Companies: List, get, create, and search companies
- Deals: List, get, create, and update deals
- Pipelines: List and get deal/ticket pipelines
- Owners: List and get HubSpot users
Authentication
Authentication is handled by the MCP Gateway via OAuth 2.0. This server receives access tokens through the Authorization header.
To authenticate:
- Navigate to the gateway's OAuth endpoint:
/oauth/hubspot/authorize - Complete the HubSpot OAuth flow
- Access tokens are automatically managed by the gateway
Local Development
# Install dependencies
pip install -e .
# Set environment variable for local testing
export HUBSPOT_ACCESS_TOKEN="your-access-token"
# Run server
python server.py
Docker
# Build (requires mcp-base image)
docker build -t hubspot-mcp .
# Run
docker run -p 3004:3004 hubspot-mcp
Available Tools
| Tool | Description |
|---|---|
hubspot_list_contacts | List contacts with pagination |
hubspot_get_contact | Get a specific contact |
hubspot_create_contact | Create a new contact |
hubspot_update_contact | Update an existing contact |
hubspot_search_contacts | Search contacts |
hubspot_list_companies | List companies with pagination |
hubspot_get_company | Get a specific company |
hubspot_create_company | Create a new company |
hubspot_search_companies | Search companies |
hubspot_list_deals | List deals with pagination |
hubspot_get_deal | Get a specific deal |
hubspot_create_deal | Create a new deal |
hubspot_update_deal | Update an existing deal |
hubspot_list_pipelines | List pipelines |
hubspot_get_pipeline | Get a specific pipeline |
hubspot_list_owners | List HubSpot owners/users |
hubspot_get_owner | Get a specific owner |
Configuration
| Environment Variable | Description | Default |
|---|---|---|
HUBSPOT_ACCESS_TOKEN | Fallback access token (dev only) | - |
LOG_LEVEL | Logging level | INFO |
PORT | Server port | 3004 |