Which integrations are available for this server?

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.

How do I use HubSpot MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@HubSpot MCP Server Search 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/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`

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

HubSpotOAuth
com.hubspot.app
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Customer Data Platforms Databases Marketing
3
RevOrbit CRM
com.revorbit
Search, summarize, and update your RevOrbit CRM (leads, deals, contacts, tasks) in plain language.
CRM Search
2
kesslerio-attio-mcp-server
ai.smithery
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…
Customer Data Platforms Marketing App Automation
269
pipedrive A
io.usefulapi
Read deals, persons, organizations, activities and pipelines; create and update CRM records.
CRM
191