Provides tools for managing HubSpot CRM resources, including contacts, companies, deals, pipelines, and owners, enabling actions like listing, retrieving, creating, updating, and searching across these entities.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HubSpot MCP ServerSearch for the contact Jane Doe and show her email address"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/authorizeComplete 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.pyDocker
# Build (requires mcp-base image)
docker build -t hubspot-mcp .
# Run
docker run -p 3004:3004 hubspot-mcpAvailable Tools
Tool | Description |
| List contacts with pagination |
| Get a specific contact |
| Create a new contact |
| Update an existing contact |
| Search contacts |
| List companies with pagination |
| Get a specific company |
| Create a new company |
| Search companies |
| List deals with pagination |
| Get a specific deal |
| Create a new deal |
| Update an existing deal |
| List pipelines |
| Get a specific pipeline |
| List HubSpot owners/users |
| Get a specific owner |
Configuration
Environment Variable | Description | Default |
| Fallback access token (dev only) | - |
| Logging level |
|
| Server port |
|
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.