Skip to content
API Reference
Admin /Catalog /MCP Servers
HubSpot logo

HubSpot

CRM

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, access policies, 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

Section titled “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

Section titled “Install”
INSTALL

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

  1. Open the catalog

    In your zone’s Keycard Console, 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.

Section titled “Related”
RELATED