HubSpot MCP server
HubSpot's official remote MCP server connects AI agents to your CRM over OAuth to search, read, and update records.
HubSpot MCP is HubSpot's official hosted server that connects any MCP-compatible AI client to a HubSpot account over a secure, HubSpot-managed connection. Agents can fetch the authenticated user's details, search and retrieve CRM objects such as contacts, companies, deals, tickets, line items, quotes, invoices, products, and lists, and create or update those records with managed write capabilities. Beyond core CRM data it exposes properties and owners metadata plus campaign tooling for pulling campaign contacts, asset types, asset metrics, and analytics, so an agent can answer pipeline and marketing questions and keep records current end to end.
The canonical deployment is the remote endpoint at https://mcp.hubspot.com, authenticated with OAuth 2.1 using PKCE. Each connection is tied to an MCP auth app you create under Development > MCP Auth Apps in your HubSpot account, so access is scoped to the authorizing user and respects HubSpot's existing permission model rather than a long-lived token pasted into a config file.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"hubspot": {
"type": "http",
"url": "https://mcp.hubspot.com"
}
}
}claude mcp add --transport http hubspot https://mcp.hubspot.comHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| get_user_details | Retrieves details about the authenticated user and their HubSpot account. |
| search_crm_objects | Searches CRM objects such as contacts, companies, deals, and tickets using filters. |
| get_crm_objects | Retrieves specific CRM objects by ID with their properties and associations. |
| manage_crm_objects | Creates or updates CRM objects where write access is supported. |
| search_properties | Searches the property definitions available on CRM objects. |
| get_properties | Retrieves property metadata and values for CRM objects. |
| search_owners | Searches the owners (users) who can be assigned to CRM records. |
| get_campaign_contacts_by_type | Retrieves the contacts associated with a campaign by interaction type. |
| get_campaign_analytics | Retrieves performance analytics for a marketing campaign. |
| get_campaign_asset_types | Lists the asset types associated with a campaign. |
| get_campaign_asset_metrics | Retrieves metrics for the assets attached to a campaign. |
| submit_feedback | Submits feedback about the MCP server experience to HubSpot. |
What you can do with it
Answer pipeline questions
An agent searches deals, contacts, and companies to report on pipeline status or surface a specific account's history without anyone opening the CRM.
Keep CRM records current
After a call or email, the agent creates or updates the relevant contact, deal, or note so the CRM reflects the latest state of the relationship.
FAQ
- Is it free?
- The MCP server is free to connect; it operates within your existing HubSpot plan and its API limits, and you pay only for HubSpot itself.
- Does it support remote/OAuth?
- Yes. The canonical deployment is the remote endpoint at https://mcp.hubspot.com using OAuth 2.1 with PKCE, tied to an MCP auth app you create in your HubSpot account.
- What can it write to?
- It can create and update CRM records such as contacts, companies, deals, and tickets via manage_crm_objects, scoped to the permissions of the authorizing user. Some objects remain read-only.