Skip to main content

How to Connect HubSpot

🔧 Tools · MCP

The HubSpot Remote MCP server at https://mcp.hubspot.com exposes CRM records, activities, and campaign analytics as agent tools.

1. Create an MCP Auth App in HubSpot​

  1. Sign in to the target HubSpot account and open Development → MCP Auth Apps. Click Create MCP auth app.
  2. Fill in:
    • App name: e.g. Zeta Alpha MCP. Shown on the consent screen.
    • Redirect URL: https://api.zeta-alpha.com/v0/service/mcp/oauth/callback.
  3. Copy the Client ID and Client secret from the app details page.

HubSpot MCP Auth App details page showing Client ID, Client secret and Redirect URLs

No scope picker

MCP auth apps have no scope list. At authorization time HubSpot derives scopes from the server's available tools and the user's own permissions. When HubSpot adds new tools, users click Reauthorize to grant them.

2. Add the Server to the Tenant​

Add a server under the tenant's MCP Servers (see Adding a Server to the Tenant):

FieldValue
Namehubspot
URLhttps://mcp.hubspot.com/
OAuth client IDThe app's Client ID
OAuth client secretNew secret… with the app's Client secret

Leave Scopes empty: HubSpot ignores them.

3. Mount It and Connect​

Mount hubspot on the agent (Mounting a Server on an Agent). Each user then connects HubSpot from Connected apps in the chat, or through the Authorize button the agent shows when a request needs HubSpot (e.g. "List my latest HubSpot deals"). See Connecting from the Navigator.

Troubleshooting​

SymptomCause
redirect_uri_mismatch after consentThe server's Redirect URI (empty: the platform callback URL) does not match the Redirect URL on the MCP auth app byte-for-byte.
insufficient_scope at tool-call timeUser granted narrower permissions than the tool needs, or HubSpot added new tools. Reauthorize.
Activity tools (calls, emails, meetings, notes, tasks) return nothingAccount has Sensitive Data enabled, which blocks activity objects from MCP.