HubSpot
Read and write HubSpot CRM data: contacts, companies, deals, and engagements.
HubSpot
Read and write HubSpot CRM data: contacts, companies, deals, and engagements. With Lunar.dev MCPX, the MCP Gateway for secure and governed tool access, you connect the HubSpot MCP server to Claude, ChatGPT, Cursor, and any MCP client through one gateway that routes, authenticates, and governs every HubSpot tool call against your policies.
Why MCPX
MCPX is Lunar.dev's MCP Gateway. It sits between your AI agents and your MCP servers as a single gateway for every tool call, routing, authenticating, and governing traffic against your policies. Connect HubSpot once and govern it everywhere: role-based access per agent with on-behalf-of attribution, real-time visibility, and an immutable audit trail of who did what, all deployable inside your own VPC.
Tools content
- search_crm_objects · Read-only
Searches and retrieves CRM records from HubSpot based on filters and criteria. - submit_feedback · Write
Collects and submits feedback to HubSpot on dissatisfaction or user request. - get_campaign_contacts_by_type · Read-only
Get paginated contact IDs for a campaign filtered by attribution type. - search_owners · Read-only
Lists and searches for owners who can be assigned to CRM records. - get_campaign_analytics · Read-only
Get campaign analytics (METRICS or REVENUE_ATTRIBUTION) for one or more campaigns. - get_campaign_asset_types · Read-only
List the asset type names available as campaign assets (e.g. LANDING_PAGE, BLOG_POST). - get_organization_details · Read-only
Lists organization-wide teams, job titles (roles), seats, and account information (eg timezone, currency). - get_properties · Read-only
Fetches property definitions including data types and enumeration values. - get_campaign_asset_metrics · Read-only
Get metrics and properties for specific CRM objects associated with a campaign. - search_properties · Read-only
Finds the most relevant CRM property definitions using keyword-based search. - get_crm_objects · Read-only
Fetches multiple CRM objects of the same object type in a single request. - get_user_details · Read-only
Returns user, team and hub info; CRM/marketing object and tool availability. - tool_guidance · Read-only
Retrieves guidance and usage instructions for a set of HubSpot tools. - hubspot-get-user-details · Read-only
Authenticates and analyzes the current HubSpot access token, providing context about the user's permissions. - hubspot-list-objects · Read-only
Retrieves a paginated list of objects of a specified type from HubSpot. - hubspot-search-objects · Read-only
Performs advanced filtered searches across HubSpot object types using complex criteria. - hubspot-batch-create-associations · Write
Data Modification Warning: This tool modifies HubSpot data. - hubspot-get-association-definitions · Read-only
Retrieves valid association types between specific HubSpot object types. - hubspot-list-associations · Read-only
Retrieves existing relationships between a specific object and other objects of a particular type. - hubspot-batch-create-objects · Write
Data Modification Warning: This tool modifies HubSpot data.
Frequently asked questions
What is the HubSpot MCP server?
Read and write HubSpot CRM data: contacts, companies, deals, and engagements. Through Lunar.dev MCPX, HubSpot connects to any MCP-compatible AI client behind a single governed gateway.
How do I connect HubSpot to MCPX?
Add the HubSpot server in the MCPX control plane or your app.yaml, then point your AI client at your MCPX gateway. MCPX handles OAuth and routes every HubSpot call through the gateway.
Is the HubSpot MCP server official?
Yes. HubSpot is an official, vendor-published MCP server, and MCPX governs it like any other server in your catalog.
What authentication does HubSpot use with MCPX?
HubSpot uses OAuth. MCPX enforces authentication at the gateway with token-based auth, OAuth, and role-based profiles, so you control which agents can invoke it.
How many tools does HubSpot expose in MCPX?
HubSpot's tools can be enabled or disabled individually in MCPX for least-privilege access.
