---
title: HubSpot | Keycard
description: HubSpot's official MCP server for CRM management, campaign analytics, and customer data operations.
---

Provides full HubSpot CRM access including searching, creating, and updating CRM objects (contacts, deals, companies, tickets, etc.), campaign analytics and revenue attribution, property discovery, owner/user management, team and organization details, and feedback submission. Supports association management between objects and advanced filtering.

Adding HubSpot provisions three things in your zone: an upstream resource pointing at `https://mcp.hubspot.com/` (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with HubSpot’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream HubSpot token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s [identity provider](/admin/identity-providers/index.md), [access policies](/admin/access-policies/index.md), and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

## Tools

TOOLS

Tools the upstream server exposes through the Keycard MCP Gateway.

HubSpot exposes 14 tools through the gateway:

- get\_campaign\_analytics

  Get campaign analytics (metrics or revenue attribution) for one or more campaigns

- get\_campaign\_asset\_metrics

  Get metrics for specific CRM objects associated with a campaign

- get\_campaign\_asset\_types

  List the asset type names available as campaign assets

- get\_campaign\_contacts\_by\_type

  Get paginated contact IDs for a campaign filtered by attribution type

- get\_crm\_objects

  Fetch multiple CRM objects of the same type in a single request

- get\_organization\_details

  List organization-wide teams, job titles, seats, and account information

- get\_properties

  Fetch property definitions including data types and enumeration values

- get\_user\_details

  Returns current user, team, and hub info; CRM/marketing object and tool availability

- manage\_crm\_objects

  Create or update CRM objects with properties and associations

- search\_crm\_objects

  Search and retrieve CRM records based on filters and criteria

- search\_owners

  List and search for owners who can be assigned to CRM records

- search\_properties

  Find the most relevant CRM property definitions using keyword-based search

- submit\_feedback

  Collect and submit feedback to HubSpot on dissatisfaction or user request

- tool\_guidance

  Retrieve guidance and usage instructions for a set of HubSpot tools

## Install

INSTALL

Add HubSpot to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

Caution

Installing **HubSpot** requires you to provide a **Client ID** and **Client Secret** from HubSpot’s developer console. Have those ready before you start.

1. **Open the catalog**

   In your zone’s [Keycard Console](https://console.keycard.ai), go to **Applications** → **Add Application** → **Explore MCP Servers**.

2. **Find and install HubSpot**

   Search for `HubSpot` in the catalog and click **Install**. Enter the **Client ID** and **Client Secret** from your HubSpot developer console when prompted.

3. **Connect your development tool**

   Once installed, HubSpot appears on the **Applications** page with a **Keycard MCP Gateway URL**. Use the **Install** dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.

## Related

RELATED

- [Catalog overview](/admin/catalog/index.md) - browse other MCP and API servers
- [Access policies](/admin/access-policies/index.md) - control who can use HubSpot
- [Identity providers](/admin/identity-providers/index.md) - control who can sign in

[PreviousGranola](/admin/catalog/mcp-servers/granola/index.md)[NextJam](/admin/catalog/mcp-servers/jam/index.md)